云原生多模数据库 Lindorm：通过Grafana访问时序引擎

前提条件

• 已创建Grafana工作区。具体操作，请参见创建Grafana工作区。

• 如果通过公网访问Lindorm时序引擎，请完成以下操作：

  • 为Lindorm时序引擎开通公网地址。开通时序引擎公网地址，请参见查看时序引擎连接地址。

  • 将Grafana的公网IP添加到Lindorm白名单。具体操作，请参见设置白名单。

操作步骤

本文以Grafana 10.0.x为例介绍操作步骤。

1. 登录可观测可视化 Grafana 版控制台，在左侧导航栏单击工作区管理。

2. 在基本信息区域，单击公网地址或私网地址。输入用户名和密码。用户名为admin，密码为创建工作去时设置的密码。

3. 在Grafana服务中添加Lindorm数据源。

   1. 单击左上角的图标，在列表中选择管理。然后单击数据源。

   2. 在管理页面，单击数据源。

   3. 在数据源页面，单击Add data source。

   4. 在Add data source页面的搜索框中输入Alibaba Cloud Lindorm，找到目标数据源并单击数据源。

   5. 在Settings页签中配置以下参数，其他参数可保持默认值。

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

   6. 单击Save & test。

      显示test success，说明测试连接成功。

4. 单击Build a dashboard。

5. 在New Dashboard页面，单击添加可视化。

6. 选择步骤3添加的Lindorm数据源。

7. 在Query页签中查询数据。

   1. 在Data source列表中选择目标数据源名称。

   2. Grafana支持两种编辑器模式，包括格式化查询编辑器和SQL查询编辑器。

      SQL查询编辑器

      单击A区域右上角的，将查询编辑器切换为Raw Query Mode，然后可以输入Lindorm SQL完成复杂的查询操作。示例如下。

      SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval

      说明

      Lindorm SQL语句使用请参见SELECT语法。

      • time >= $from AND time <= $to为时间条件，为必选项，不添加无法查询出结果。参数值为Dashboard页面中选择的时间范围。

      • 单击Query options，可以通过Min interval和Max data points参数来设置Interval参数大小。

      • 通过ALIAS BY重命名时间线标签，格式为$tag_<tag_name>，例如$tag_host，时间线标签将显示为host的值。

      • 通过OFFSET设置时间偏移量，方便您将不同时间段的数据进行对比。

      格式化查询编辑器

      通过格式化的模板，选择需要查询的表、字段、查询条件等，可以完成简单的查询，关键字说明如下表。

      关键字	说明
      SELECT	选择需要查询的字段名。
      FROM	选择需要查询的表名。
      WHERE	添加查询条件。
      GROUP BY	添加聚合条件。
      SAMPLE BY	选择降采样时间间隔，具体请参见降采样查询。 单击Query options，可以通过Min interval和Max data points参数来设置Interval参数大小。
      ORDER BY TIME	按时间对查询结果排序。
      LIMIT	指定查询结果集的返回行数。
      ALIAS BY	重命名时间线标签。格式为$tag_<tag_name>，例如$tag_host，时间线标签将显示为host的值。
      OFFSET	设置时间偏移量，方便您将不同时间段的数据进行对比。

部署要求

• ECS实例的操作系统版本选择CentOS 7.3 64位及以上版本。

• ECS实例的资源规格需要1核2 G内存以上，磁盘剩余空间至少有10 GB。

前提条件

在开始操作前，请确保已完成以下操作：

• ECS实例安全组已放行3000端口的入方向流量。具体操作，请参见添加安全组规则。

• 添加ECS实例的IP到Lindorm白名单。

  如果ECS实例与Lindorm实例属于同一专有网络：请添加ECS实例的主私网IP地址至Lindorm实例的白名单。具体操作，请参见设置白名单。

  如果ECS实例与Lindorm实例不属于同一专有网络：

  • 请为ECS实例分配公网IP。如果ECS实例未分配公网IP地址，请配置并将EIP绑定至ECS实例，或者修改带宽配置。

  • 请添加ECS实例的公网IP地址至Lindorm实例的白名单。具体操作，请参见设置白名单。

• 如果通过公网访问Grafana Web界面，请确保ECS实例已分配公网IP。如果ECS实例未分配公网IP地址，请配置并将EIP绑定至ECS实例，或者修改带宽配置。如果通过专有网络访问Grafana Web界面，则无需为ECS实例分配公网IP。

操作步骤

1. 安装Grafana服务（如已安装，可跳过）。

   1. 登录ECS实例。具体操作请参见登录ECS。

   2. 执行下述命令下载Grafana：

      wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm

      说明

      本文以Grafana企业版8.2.2-1版本为例，您也可以安装其他版本。其他版本的下载地址，请参见Grafana官网。

   3. 执行下述命令安装Grafana：

      sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm

   4. 执行下述命令启动Grafana服务：

      sudo service grafana-server start

2. 安装Alibaba Cloud Lindorm数据源插件。

   1. 执行下述命令下载数据源插件。

      wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip

   2. 执行下述命令解压插件到默认目录，Linux的默认目录为/var/lib/grafana/plugins/。

      unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/

   3. 执行下述命令修改grafana.ini文件信息，Linux默认文件位置/etc/grafana/grafana.ini。

      sudo nano -w  /etc/grafana/grafana.ini

   4. 在[plugins]区域中将;allow_loading_unsigned_plugins=修改为allow_loading_unsigned_plugins = alibabacloud-lindorm-datasource。修改后按下CTRL+O保存并回车退出编辑页面。

      重要

      修改grafana.ini文件时，需要删除;allow_loading_unsigned_plugins前面的半角分号（;）。

   5. 执行下述命令重启Grafana服务：

      sudo service grafana-server restart

3. 在Grafana服务中添加Lindorm数据源。

   1. 在浏览器中输入http://IP:3000/，其中IP为ECS的公网IP或主私网IP。然后输入用户名和密码。如果是第一次登录，用户名和密码为admin，登录后请及时修改密码。更详细的介绍，请参见登录Grafana。

   2. 单击左侧的图标，在列表中选择Data Sources。

   3. 在Configuration页面，单击Add data source。

   4. 在Add data source页面的搜索框中输入Alibaba Cloud Lindorm，找到目标数据源并单击Select。

   5. 在Settings页签中配置以下参数，其他参数可保持默认值。

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

   6. 单击Save & test。

      显示test success，说明测试连接成功。

4. 连接Lindorm实例后，在Grafana服务中创建并使用dashboard，具体操作您可以参考创建Dashboard。

5. 在Query页签中查询数据。

   1. 在Data source列表中选择目标数据源名称。

   2. Grafana支持两种编辑器模式，包括格式化查询编辑器和SQL查询编辑器。

      SQL查询编辑器

      单击A区域右上角的，将查询编辑器切换为Raw Query Mode，然后可以输入Lindorm SQL完成复杂的查询操作。示例如下。

      SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval

      说明

      Lindorm SQL语句使用请参见SELECT语法。

      • time >= $from AND time <= $to为时间条件，为必选项，不添加无法查询出结果。参数值为Dashboard页面中选择的时间范围。

      • 单击Query options，可以通过Min interval和Max data points参数来设置Interval参数大小。

      • 通过ALIAS BY重命名时间线标签，格式为$tag_<tag_name>，例如$tag_host，时间线标签将显示为host的值。

      • 通过OFFSET设置时间偏移量，方便您将不同时间段的数据进行对比。

      格式化查询编辑器

      通过格式化的模板，选择需要查询的表、字段、查询条件等，可以完成简单的查询，关键字说明如下表。

      关键字	说明
      SELECT	选择需要查询的字段名。
      FROM	选择需要查询的表名。
      WHERE	添加查询条件。
      GROUP BY	添加聚合条件。
      SAMPLE BY	选择降采样时间间隔，具体请参见降采样查询。 单击Query options，可以通过Min interval和Max data points参数来设置Interval参数大小。
      ORDER BY TIME	按时间对查询结果排序。
      LIMIT	指定查询结果集的返回行数。
      ALIAS BY	重命名时间线标签。格式为$tag_<tag_name>，例如$tag_host，时间线标签将显示为host的值。
      OFFSET	设置时间偏移量，方便您将不同时间段的数据进行对比。