From 875fa37d10745f0cb9d15c26d2d1c90fc0ceb7da Mon Sep 17 00:00:00 2001 From: Giordano Ricci Date: Mon, 19 Apr 2021 15:18:50 +0100 Subject: [PATCH] Elasticsearch: Add documentation for supported Elasticsearch query transformations (#33072) * Elasticsearch: Add documentation for supported Elasticsearch query transformation * Update docs/sources/datasources/elasticsearch.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Remove beta notives for ES logs Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> --- docs/sources/datasources/elasticsearch.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/sources/datasources/elasticsearch.md b/docs/sources/datasources/elasticsearch.md index 522e48af70f..fcc7e6411bb 100644 --- a/docs/sources/datasources/elasticsearch.md +++ b/docs/sources/datasources/elasticsearch.md @@ -77,9 +77,7 @@ number followed by a valid time identifier, e.g. `1m` (1 minute) or `30s` (30 se | `s` | second | | `ms` | millisecond | -### Logs (BETA) - -> Only available in Grafana v6.3+. +### Logs There are two parameters, `Message field name` and `Level field name`, that can optionally be configured from the data source settings page that determine which fields will be used for log messages and log levels when visualizing logs in [Explore]({{< relref "../explore" >}}). @@ -191,18 +189,18 @@ for annotation events. | `Text` | Event description field. | | `Tags` | Optional field name to use for event tags (can be an array or a CSV string). | -## Querying Logs (BETA) - -> Only available in Grafana v6.3+. +## Querying Logs Querying and displaying log data from Elasticsearch is available in [Explore]({{< relref "../explore" >}}), and in the [logs panel]({{< relref "../panels/visualizations/logs-panel.md" >}}) in dashboards. Select the Elasticsearch data source, and then optionally enter a lucene query to display your logs. +When switching from a Prometheus or Loki data source in Explore, your query is translated to an Elasticsearch log query with a correct Lucene filter. + ### Log Queries Once the result is returned, the log panel shows a list of log rows and a bar chart where the x-axis shows the time and the y-axis shows the frequency/count. -Note that the fields used for log message and level is based on an [optional data source configuration](#logs-beta). +Note that the fields used for log message and level is based on an [optional data source configuration](#logs). ### Filter Log Messages