添加并使用Lindorm数据源_可观测可视化 Grafana 版(Grafana)-阿里云帮助中心

ARMS的可观测可视化 Grafana 版默认安装Alibaba Cloud Lindorm数据源插件。通过此插件，可实现Lindorm数据同步并实时呈现在Grafana大盘中。您无需手动获取或迁移数据。本文介绍如何通过Lindorm数据源插件同步Lindorm数据，并使用Lindorm数据源创建大盘面板。

背景信息

Lindorm时序引擎是一款高性能、低成本、稳定可靠的在线时序数据库引擎服务，提供高效读写、高压缩比存储、时序数据聚合计算等能力。更多信息，请参见引擎简介。

步骤一：功能入口

登录可观测可视化 Grafana 版控制台，在左侧导航栏单击工作区管理。
在工作区管理页面，单击目标工作区右侧的访问地址URL链接进入Grafana。
说明
如果需要登录Grafana，可以使用Grafana的Admin账号和创建工作区时设置的密码登录Grafana，或者单击Sign in with Alibaba Cloud直接使用当前购买工作区的阿里云账号登录Grafana。

步骤二：配置数据源

Grafana 9.x版本

在Grafana左侧导航栏，单击图标，然后单击Add data source。
在Add data source页面的搜索框，搜索并单击Alibaba Cloud Lindorm。

在Settings页面设置以下参数。

配置项	参数	是否必选	描述
Name		是	是定义数据源名称。
HTTP	URL	是	Lindorm时序HTTP地址，获取方法请参见查看时序引擎连接地址。重要如果您的Grafana与Lindorm实例位于同一专有网络，请使用Lindorm时序HTTP地址的专有网络地址，否则请使用公网地址。如果此处使用的是时序HTTP地址的专有网络地址，请确保Grafana私网IP（私网域名交换机所在网段）已经添加到Lindorm的白名单中。如果使用的是公网地址，请确保Grafana公网IP已经添加到Lindorm的白名单中。
Auth	Basic auth	否	Lindorm时序引擎如果开启了权限与用户认证，请打开Basic auth，并在Basic Auth Details区域填写登录时序引擎的用户名和密码。关于权限与用户认证，请参见用户及权限管理。
Basic Auth Details	User	否	如果打开Basic auth需要填写Lindorm时序引擎的用户名。
Basic Auth Details	Password	否	如果打开Basic auth需要填写Lindorm时序引擎的密码。
Lindorm TSDB Details	Database	否	填写需要访问的Lindorm时序引擎的数据库。

单击Save & Test。

Grafana 10.x版本

在Grafana首页，单击页面左上角的图标。
在Grafana左侧导航栏，选择管理 > 数据源。
在数据源页签，单击+ Add data source。
在Add data source页面的搜索框，搜索并单击Alibaba Cloud Lindorm。

在Settings页面设置以下参数。

配置项	参数	是否必选	描述
Name		是	是定义数据源名称。
HTTP	URL	是	Lindorm时序HTTP地址，获取方法请参见查看时序引擎连接地址。重要如果您的Grafana与Lindorm实例位于同一专有网络，请使用Lindorm时序HTTP地址的专有网络地址，否则请使用公网地址。如果此处使用的是时序HTTP地址的专有网络地址，请确保Grafana私网IP（私网域名交换机所在网段）已经添加到Lindorm的白名单中。如果使用的是公网地址，请确保Grafana公网IP已经添加到Lindorm的白名单中。
Auth	Basic auth	否	Lindorm时序引擎如果开启了权限与用户认证，请打开Basic auth，并在Basic Auth Details区域填写登录时序引擎的用户名和密码。关于权限与用户认证，请参见用户及权限管理。
Basic Auth Details	User	否	如果打开Basic auth需要填写Lindorm时序引擎的用户名。
Basic Auth Details	Password	否	如果打开Basic auth需要填写Lindorm时序引擎的密码。
Lindorm TSDB Details	Database	否	填写需要访问的Lindorm时序引擎的数据库。

单击Save & Test。

步骤三：创建大盘面板

添加Lindorm数据源后，您可以在创建面板时使用已添加的Lindorm数据源。

Grafana 9.x版本

在Grafana左侧导航栏，单击图标，然后单击页面右上角的New Dashboard。
在New Dashboard页面，单击Add a new panel。
在Edit Panel页面的Query页签，单击Data source区域的下拉框选择上一步添加的数据源。

您可以选择下面两种方式中的任意一种进行数据查询。

使用编辑框查询：在A区域下的选择框选择需要查询的数据，可以完成简单的查询操作，关键字说明如下表。

关键字	说明
SELECT	选择需要查询的字段名。
FROM	选择需要查询的表名。
WHERE	添加查询条件。
GROUP BY	添加聚合条件。
SAMPLE BY	选择降采样时间间隔，具体请参见降采样查询。
FILL	选择填充策略。
ORDER BY TIME	选择排列顺序。
LIMIT	输入查询返回最多的数据数量。
ALIAS BY	重命名时间线标签。

使用TSQL语句查询：单击A区域右上角的，可以通过输入TSQL语句完成复杂的查询操作（例如嵌套查询），数据查询结果如下图。
说明
TSQL语句使用请参见SELECT语法。
- $timeFilter表示时间条件，会自动替换为页面中选择的时间范围，定义为time>=xxx and time<=xxx。
- time为必选项，否则不会出现分析结果图。
- SELECT语句中通过tag方式对不同时间线进行分组聚合。
通过Alias by重命名时间线标签，例如使用$tag_host进行区分时间线，如下图所示：
TSQL语句中的$interval表示降采样时间间隔，语句示例如下：
```
SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval
```
说明
单击Query options，通过Min interval和Max data points参数来设置Interval参数的大小。

在右侧设置监控图表的名称、类型、展示样式等。
单击右上角的Apply。
单击右上角的图标，设置监控大盘的名称和归属目录。
单击Save，大盘即可创建成功。

Grafana 10.x版本

在Grafana首页，单击页面左上角的图标。
在Grafana左侧导航栏，选择仪表板，单击页面右上角的新建，然后在下拉列表中单击新建仪表板。
在新建仪表板页面，单击+ 添加可视化。
在弹出的Select data source页面右侧，选择上一步添加的数据源。

您可以选择下面两种方式中的任意一种进行数据查询。

使用编辑框查询：在A区域下的选择框选择需要查询的数据，可以完成简单的查询操作，关键字说明如下表。

关键字	说明
SELECT	选择需要查询的字段名。
FROM	选择需要查询的表名。
WHERE	添加查询条件。
GROUP BY	添加聚合条件。
SAMPLE BY	选择降采样时间间隔，具体请参见降采样查询。
FILL	选择填充策略。
ORDER BY TIME	选择排列顺序。
LIMIT	输入查询返回最多的数据数量。
ALIAS BY	重命名时间线标签。

使用TSQL语句查询：单击A区域右上角的，可以通过输入TSQL语句完成复杂的查询操作（例如嵌套查询），数据查询结果如下图。
说明
TSQL语句使用请参见SELECT语法。
- $timeFilter表示时间条件，会自动替换为页面中选择的时间范围，定义为time>=xxx and time<=xxx。
- time为必选项，否则不会出现分析结果图。
- SELECT语句中通过tag方式对不同时间线进行分组聚合。
通过Alias by重命名时间线标签，例如使用$tag_host进行区分时间线，如下图所示：
TSQL语句中的$interval表示降采样时间间隔，语句示例如下：
```
SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval
```
说明
单击Query options，通过Min interval和Max data points参数来设置Interval参数的大小。

在右侧设置监控图表的名称、类型、展示样式等。
单击右上角的Apply。
单击右上角的图标，设置监控大盘的名称和归属目录。
单击Save，大盘即可创建成功。

步骤四：查看监控数据

Grafana 9.x版本

在Grafana左侧导航栏，单击图标，然后单击Browse。
在Browse页签，单击目标目录下的监控大盘，即可查看目标大盘上的所有监控图表。

Grafana 10.x版本

在Grafana首页，单击页面左上角的图标。
在Grafana左侧导航栏，选择仪表板，单击目标目录下的监控大盘，即可查看目标大盘上的所有监控图表。