apitech
/
grafana
mirror of https://github.com/grafana/grafana
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
59151 Commits
1678 Branches
645 Tags
2.2 GiB
 
 
 
 
 
 
Tag: Branch: Tree: 750b90e756
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '750b90e756'
${ noResults }
grafana/public/app/plugins/datasource/elasticsearch/docs/developer_documentation.md

2.4 KiB
Raw Blame History

ElasticSearch data source in Grafana

ElasticSearch is the built-in core data source and one of the oldest and most popular data sources in Grafana. When refactoring and improving, it's important to consider that many users have legacy dashboards, annotations and configs that need to remain compatible.

Running queries using backend

Queries in the ElasticSearch data source are now exclusively run through the backend. This change is detailed in this document. The enableElasticSearchBackendQuerying feature toggle, which allowed switching between frontend and backend modes, was removed in Grafana 11.1.0. In case of reported issues, please refer to the linked document.

Development

When developing for ElasticSearch, use make devenv sources=elastic. To specify a version, use make devenv sources=elastic elastic_version=7.17.0. In devenv/docker/blocks/elastic/data/data.js, you can update data to suit your debugging and testing needs. Additionally, ElasticSearch has a couple of debugging dashboards located in devenv/dev-dashboards/datasource-ElasticSearch.

Instrumentation

The ElasticSearch data source has improved instrumentation with logs, metrics, traces, and dashboards. When debugging issues, it is useful to review the available telemetry signals.

Technical debt

Here is a list of our current technical debt.

Database field

Previously, users stored ElasticSearch indices in the database field, which has since been deprecated. It is now stored in jsonData (implemented in https://github.com/grafana/grafana/pull/62808), though we continue to support both fields. Eventually, support for the database field will need to be removed.

Supported Explore and Log features

Many Explore and Log features are implemented through DataSourceWithXXXSupport, making it clear which functionalities are supported.

Supported ES Versions and version changes

The supported ElasticSearch version is documented at https://grafana.com/docs/grafana/latest/datasources/ElasticSearch/#supported-ElasticSearch-versions. We typically update it with major Grafana versions, following ElasticSearch Elastic Product End of Life Dates to the last supported versions of ElasticSearch available at the time of Grafana's release.