云原生多模数据库Lindorm时序引擎可以通过Grafana服务的Alibaba Cloud Lindorm数据源插件进行访问。本文介绍通过Grafana服务连接时序引擎并可视化分析数据。

背景信息

Grafana服务是用于展示大型测量数据的开源可视化工具，在互联网应用分析中应用范围十分广泛，并且在工业监控、气象监控、家居自动化和过程管理等领域也有着较广泛的用户基础。

准备工作

部署方式前提条件部署要求
自建Grafana服务（客户端部署在ECS上）
  • 确保ECS实例与Lindorm实例属于同一专有网络。
  • 确保ECS实例已开通公网访问。如果您未分配公网IP地址，可以申请弹性公网IP，具体操作，请参见申请弹性公网IP。
  • 将ECS实例的内网IP地址添加至Lindorm实例的白名单中。具体操作，请参见设置白名单。
  • ECS实例已添加端口为3000的安全组规则。具体操作，请参见添加安全组规则。
  • 客户端的操作系统版本选择CentOS 7.3 64位及以上版本。
  • 客户端的硬件资源需要单核2 G内存以上，磁盘剩余空间至少有10 G。
阿里云Grafana服务阿里云Grafana服务目前正在公测，如果您想体验Grafana服务，可以在Grafana服务页面申请开通。无

操作步骤

以下操作步骤是自建Grafana服务（客户端部署在ECS上）。

说明 您也可以通过阿里云Grafana服务创建Grafana托管服务，具体操作请参见快速使用。
  1. 安装Grafana服务（如已安装，可跳过）。
    1. 登录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
      说明 您也可以参考官网安装Grafana服务。
    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. 登录Grafana服务并进入Grafana主页。具体操作请参见登录Grafana。
      说明 如果Grafana服务部署在阿里云Grafana服务，您可以通过阿里云Grafana服务登录Grafana主页，具体操作请参见管理工作区。
    2. 单击左侧的设置图标，在列表中选择Data Sources。
    3. 进入Configuration页面，单击Add data source。
    4. 在Add data source页面的搜索框中输入Alibaba Cloud Lindorm，找到目标数据源并单击Select。
    5. 在Settings页签中配置以下参数，其他参数选择默认值。
      配置页面
      配置项参数描述
      Name数据源名称，可自定义。
      HTTPURLLindorm时序引擎的连接地址，获取方法请参见查看时序引擎连接地址。
      AuthBasic auth如果需要使用鉴权认证请打开Basic auth。
      With Credentials如果需要使用鉴权认证请打开With Credentials。
      Basic Auth DetailsUser如果打开Basic auth需要填写Lindorm实例的用户名。
      Password如果打开Basic auth需要填写Lindorm实例的密码。
      Lindorm TSDB DetailsDatabase填写需要访问的Lindorm实例中的数据库。
    6. 单击Save & test。
  4. 连接Lindorm实例后，在Grafana服务中创建并使用dashboard，具体操作您可以参考官网文档。
  5. 在Query页签中通过TSQL查询数据。
    1. 在Data source列表中选择目标数据源名称。
    2. TSQL查询操作有两种方式，包括使用编辑框查询和使用TSQL语句查询。
      • 使用编辑框查询：在A区域下的选择框选择需要查询的数据，可以完成简单的查询操作，关键字说明如下表。更新选择框
        关键字说明
        SELECT选择需要查询的字段名。
        FROM选择需要查询的表名。
        WHERE添加查询条件。
        GROUP BY添加聚合条件。
        SAMPLE BY选择降采样时间间隔，具体请参见降采样查询。
        ORDER BY TIME选择排列顺序。
        LIMIT输入查询返回最多的数据数量。
        ALIAS BY重命名时间线标签。
        OFFSET设置时间偏移量，方便您将不同时间段的数据进行对比。
      • 使用TSQL语句查询：单击A区域右上角的切换，可以通过输入TSQL语句完成复杂的查询操作（例如嵌套查询）。
        SELECT time,host,value FROM cpu_user WHERE instanceld = '$instanceld' AND host similar to 'tsdb' and time >= $from AND time <= $to
        说明 TSQL语句使用请参见SELECT语法。
        • time >= $from AND time <= $to表示时间条件，会自动替换为页面中选择的时间范围。
        • time为必选项，否则不会出现分析结果图。
        • SELECT语句中通过tag方式对不同时间线进行分组聚合。
        • 通过ALIAS BY重命名时间线标签，例如使用$tag_host进行区分时间线。
        • 通过OFFSET设置时间偏移量，方便您将不同时间段的数据进行对比。
    3. TSQL语句中的$interval表示降采样时间间隔，语句示例如下：
      SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval
      说明 单击Query options，通过Min interval和Max data points参数来设置Interval参数大小。