导出日志服务仪表盘到Grafana

本文介绍如何将日志服务仪表盘导入到Grafana中。

重要

目前，导出日志服务仪表盘到Grafana功能处于公测中。如果您要使用该功能，需提工单申请。

前提条件

已安装8.0.0及以上版本的Grafana。具体操作，请参见Grafana官方文档。
本文以9.2.4版本的Grafana为例。
重要
如果您是在本机上安装Grafana，请提前在浏览器中打开3000端口。
已安装v2版本的日志服务Grafana插件。具体操作，请参见对接Grafana。
如果您需要使用饼图，需执行grafana-cli plugins install grafana-piechart-panel命令，安装饼图插件。

步骤一：生成并导出Grafana格式的JSON内容

登录日志服务控制台。
在Project列表区域，单击目标Project。
在左侧导航栏中，选择仪表盘>仪表盘列表。
在仪表盘列表中，单击目标仪表盘，然后单击编辑 > 设置。
在转为Grafana仪表盘页签中，选择您的Grafana版本号。
单击复制Grafana格式json或下载Grafana格式json，获取JSON内容。
重要
如果存在转换提示信息，请先根据提示信息解决问题，否则可能导致图表元素显示异常。

步骤二：导入仪表盘到Grafana

登录Grafana。
在左侧导航栏，选择图标> Browse。
在Browse页签中，选择 New > Import。
单击Upload JSON file，导入JSON文件或在Import via panel json中输入JSON内容，然后单击Load。
该内容为您在步骤一：生成并导出Grafana格式的JSON内容中获取的JSON内容。
在Options步骤中，完成如下配置。
1. 设置仪表盘的名称。
2. 选择用于存放仪表盘的文件夹。
3. 选择仪表盘所需的数据源。
4. 单击Import。

导入成功后，系统将跳转至仪表盘页面，您可以查看导入后的仪表盘。

转换能力范围

由于Grafana和日志服务存在实现与功能差异，所以导入仪表盘到Grafana时，在图表种类、数据源、变量、语句转换、图表样式上均有一定限制。支持转化的内容如下表所示。

类别	支持范围
图表种类	表格Pro 线图Pro 柱状图Pro 流图Pro 统计图Pro 计量图Pro 饼图Pro Metric Prometheus 表格文本折叠行
数据源类型	Logstore（SQL） MetricStore（PromQL） MetricStore（SQL） Builtin
变量	仅支持变量替换功能，不支持过滤器功能。因为Grafana不支持过滤器。变量不能同时包含动态列表项与静态列表项。因为Grafana不支持Query与常值并存。使用变量替换时，不支持添加多个变量。因为Grafana不支持在仪表盘中输入自定义Key。
语句转换	SQL PromQL SQL+PromQL
图表样式	支持图表位置、大小、标题、图例匹配。

使用限制

Grafana不支持日志服务的自由布局，转换后会出现布局混乱。
部分配置缺失（例如X轴或Y轴配置）可能造成图表显示问题，此时需要检查查询分析配置。部分情况下，必须设置完整的查询分析配置，以适配Grafana插件。由于Grafana限制，尽量避免选择所有数字字段。
日志服务的单值图配置更丰富，包括同环比、定制化等功能。Grafana只支持转化主数值部分。
Grafana表格配置功能较少，无法兼容日志服务所有的表格配置，例如设置迷你线图、设置迷你柱状图、自定义交互事件，搭配过滤器等。
暂不支持图表样式细节（线型、定制化等）转换，导入时按照Grafana默认效果转换。
其他无法等价转换的功能包括数据转换、交互事件和字段配置。