使用Grafana访问日志服务的Elasticsearch兼容接口
更新时间：2025-11-14
简介
本文介绍如何使用Grafana访问日志服务的Elasticsearch兼容接口。
前提条件
- ES对接支持Grafana 8.x 9.x 10.x 11.x版本。本文以Grafana 11.4.0为例进行说明。
- 已创建Project、Logstore并完成日志采集配置。
- 查询日志前，已配置索引。
背景信息
Grafana是一款开源的数据可视化和监控平台，支持多种数据源，包括但不限于Graphite、InfluxDB、Prometheus、Elasticsearch等，并提供丰富的图表展示和数据查询功能。
针对习惯于使用Grafana分析Elasticsearch数据，但需要将Elasticsearch数据迁移到日志服务的用户，日志服务提供了兼容Elasticsearch的接口，便于他们使用Grafana的Elasticsearch数据源插件访问日志服务进行查询和分析。
另外，日志服务也提供了原生的Grafana数据源插件。更多信息，请参见通过Grafana使用BLS。两种插件的区别如下表所示。
| 对比项 | Grafana+Elasticsearch兼容接口 | Grafana+BLS原生插件 |
|---|---|---|
| 使用的Grafana数据源插件 | Elasticsearch数据源插件（Grafana默认包含） | BLS数据源插件（需要手动安装） |
| 查询语法 | Elasticsearch DSL语法 | BLS索引查询语法、SQL分析语法 |
配置数据源
- 登录Grafana控制台。
- 在左侧导航栏，选择 Connections > Add new connection。
- 在Add new connection页签，找到并单击Elasticsearch。
- 然后再打开的Elasticsearch详情页中，单击Add new data source。
- 在Settings页签中，完成如下配置，然后单击Save&test测试连通性。如显示Data source successfully connected，表示配置正确
重要参数配置说明如下表所示，其他参数可使用默认配置。
| 配置区域 | 参数名称 | 说明 |
|---|---|---|
| Connection | URL | 数据访问地址，为BLS的访问域名，协议为https，端口为8020，比如：https://bls-log.bj.baidubce.com:8020 |
| Authentication methods | Basic authentication | 选择Basic authentication。User为百度云账号的AccessKey，Password为百度云账号的AccessKeySecret |
| Elasticsearch details | Index name | Elasticsearch的索引模式名称。该名称的命名规则为{日志服务Project名称}${Logstore名称}。例如Project名称为test ，Logstore名称为es_test22，那么此处的名称为test$es_test22；支持日志视图，视图命名规则为：{日志服务Project名称}${LogstoreView名称}@View |
配置图表示例
创建数据源后，Grafana将可以访问存储在日志服务中的数据。通过ES的插件对接BLS的ES兼容接口，可以很方便地做图表可视化，而无需写SQL。下面以某个日志集为例介绍具体配置示例。
整体QPS曲线
在Lucene Query框中可以填写过滤条件，语法是ES Lucene的语法。
统计status为200的曲线
在Lucene Query框中输入status: 200即可查询满足这个条件的曲线。
统计Top请求的方法类型
Group By选择Terms，并选择method字段。
统计RT分位数
Metric选择 Percentiles，并选择latency字段, 在Values中可以选择具体的分位数值，比如25,50,75,95,99。
