通过Grafana访问时序引擎

Grafana服务是用于展示大型测量数据的开源可视化工具,在互联网应用分析中应用范围十分广泛,并且在工业监控、气象监控、家居自动化和过程管理等领域也有着较广泛的用户基础。云原生多模数据库 Lindorm时序引擎提供Alibaba Cloud Lindorm数据源插件。您可以利用该插件在Grafana服务添加Lindorm数据源。本文介绍如何通过Grafana服务访问时序引擎并进行可视化数据分析。

可观测可视化Grafana版访问时序引擎

前提条件

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

  • 如果通过专有网络访问Lindorm时序引擎,请完成以下操作:

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

操作步骤

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

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

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

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

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

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

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

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

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

      配置项

      参数

      是否必选

      描述

      Name

      数据源名称,可自定义。

      HTTP

      URL

      Lindorm时序HTTP地址,获取方法请参见查看时序引擎连接地址

      重要
      • 如果Grafana已开通私网地址,且与Lindorm实例位于同一专有网络,请使用Lindorm时序HTTP地址的专有网络地址,否则请使用公网地址。

      • 如果此处使用的是Lindorm时序HTTP地址的专有网络地址,请确保Grafana私网地址已经添加到Lindorm的白名单中。如果使用的是公网地址,请确保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 intervalMax data points参数来设置Interval参数大小。

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

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

      格式化查询编辑器

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

      关键字

      说明

      SELECT

      选择需要查询的字段名。

      FROM

      选择需要查询的表名。

      WHERE

      添加查询条件。

      GROUP BY

      添加聚合条件。

      SAMPLE BY

      选择降采样时间间隔,具体请参见降采样查询

      单击Query options,可以通过Min intervalMax data points参数来设置Interval参数大小。

      ORDER BY TIME

      按时间对查询结果排序。

      LIMIT

      指定查询结果集的返回行数。

      ALIAS BY

      重命名时间线标签。格式为$tag_<tag_name>,例如$tag_host,时间线标签将显示为host的值。

      OFFSET

      设置时间偏移量,方便您将不同时间段的数据进行对比。

ECS自建Grafana服务访问时序引擎

部署要求

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

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

前提条件

在开始操作前,请确保已完成以下操作:

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

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

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

    如果ECS实例与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 intervalMax data points参数来设置Interval参数大小。

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

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

      格式化查询编辑器

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

      关键字

      说明

      SELECT

      选择需要查询的字段名。

      FROM

      选择需要查询的表名。

      WHERE

      添加查询条件。

      GROUP BY

      添加聚合条件。

      SAMPLE BY

      选择降采样时间间隔,具体请参见降采样查询

      单击Query options,可以通过Min intervalMax data points参数来设置Interval参数大小。

      ORDER BY TIME

      按时间对查询结果排序。

      LIMIT

      指定查询结果集的返回行数。

      ALIAS BY

      重命名时间线标签。格式为$tag_<tag_name>,例如$tag_host,时间线标签将显示为host的值。

      OFFSET

      设置时间偏移量,方便您将不同时间段的数据进行对比。