菜单
Grafana Cloud Enterprise 开源 RSS

Elasticsearch 数据源

Elasticsearch 是一种用于各种用例的搜索和分析引擎。您可以创建多种类型的查询来可视化存储在 Elasticsearch 中的日志或指标,并使用存储在 Elasticsearch 中的日志事件来注释图表。

以下内容将帮助您开始使用 Elasticsearch 和 Grafana

支持的 Elasticsearch 版本

此数据源支持以下 Elasticsearch 版本

  • v7.17+
  • v8.x

我们的 Elasticsearch 数据源维护策略与 Elastic 产品生命周期结束日期 一致,我们确保支持版本的功能正常。如果您使用的 Elasticsearch 版本已超出生命周期结束 (EOL),您仍然可以执行查询,但您会在查询构建器中收到通知,表明您使用的 Elasticsearch 版本不再受支持。需要注意的是,在这种情况下,我们不保证功能的正确性,也不会解决任何相关问题。

置备数据源

您可以在 YAML 文件中定义和配置数据源,作为 Grafana 置备系统的一部分。有关置备的更多信息以及可用的配置选项,请参阅 置备 Grafana

注意

先前使用的 database 字段现已 弃用。您现在应该使用 jsonData 中的 index 字段来存储索引名称。请参阅以下示例。

置备示例

基本置备

yaml
apiVersion: 1

datasources:
  - name: Elastic
    type: elasticsearch
    access: proxy
    url: https://:9200
    jsonData:
      index: '[metrics-]YYYY.MM.DD'
      interval: Daily
      timeField: '@timestamp'

日志置备

yaml
apiVersion: 1

datasources:
  - name: elasticsearch-v7-filebeat
    type: elasticsearch
    access: proxy
    url: https://:9200
    jsonData:
      index: '[filebeat-]YYYY.MM.DD'
      interval: Daily
      timeField: '@timestamp'
      logMessageField: message
      logLevelField: fields.level
      dataLinks:
        - datasourceUid: my_jaeger_uid # Target UID needs to be known
          field: traceID
          url: '$${__value.raw}' # Careful about the double "$$" because of env var expansion

配置 Amazon Elasticsearch Service

如果您使用 Amazon Elasticsearch Service,可以使用 Grafana 的 Elasticsearch 数据源可视化其中的数据。

如果您使用 AWS Identity and Access Management (IAM) 策略来控制对 Amazon Elasticsearch Service 域的访问,您必须使用 AWS Signature Version 4 (AWS SigV4) 来签署对此域的所有请求。

有关 AWS SigV4 的详细信息,请参阅 AWS 文档

AWS Signature Version 4 身份验证

要签署对 Amazon Elasticsearch Service 域的请求,您可以在 Grafana 的 配置 中启用 SigV4。

启用 AWS SigV4 后,您可以在 Elasticsearch 数据源配置页面上对其进行配置。有关 AWS 身份验证选项的更多信息,请参阅 AWS 身份验证

SigV4 configuration for AWS Elasticsearch Service
AWS Elasticsearch Service 的 SigV4 配置

查询数据源

在使用 Elasticsearch 查询编辑器时,您可以选择多个指标并按多个术语或过滤器进行分组。

有关详细信息,请参阅 查询编辑器文档

使用模板变量

您可以使用变量,而不是在指标查询中硬编码服务器、应用程序和传感器名称等详细信息。Grafana 在面板顶部的下拉选择框中列出这些变量,帮助您更改面板中显示的数据。Grafana 将此类变量称为模板变量。

有关详细信息,请参阅 模板变量文档