文档

添加并使用Lindorm数据源

更新时间:

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

背景信息

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

步骤一:功能入口

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

  2. 工作区管理页面,单击目标工作区右侧的访问地址URL链接进入Grafana。

    说明

    如果需要登录Grafana,可以使用Grafana的Admin账号和创建工作区时设置的密码登录Grafana,或者单击Sign in with Alibaba Cloud直接使用当前购买工作区的阿里云账号登录Grafana。

步骤二:配置数据源

Grafana 9.x版本

  1. 在Grafana左侧导航栏,单击image图标,然后单击Add data source

  2. Add data source页面的搜索框,搜索并单击Alibaba Cloud Lindorm

  3. 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时序引擎的用户名。

    Password

    如果打开Basic auth需要填写Lindorm时序引擎的密码。

    Lindorm TSDB Details

    Database

    填写需要访问的Lindorm时序引擎的数据库。

  4. 单击Save & Test

Grafana 10.x版本

  1. 在Grafana首页,单击页面左上角的image图标。

  2. 在Grafana左侧导航栏,选择管理 > 数据源

  3. 数据源页签,单击+ Add data source

  4. Add data source页面的搜索框,搜索并单击Alibaba Cloud Lindorm

  5. 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时序引擎的用户名。

    Password

    如果打开Basic auth需要填写Lindorm时序引擎的密码。

    Lindorm TSDB Details

    Database

    填写需要访问的Lindorm时序引擎的数据库。

  6. 单击Save & Test

步骤三:创建大盘面板

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

Grafana 9.x版本

  1. 在Grafana左侧导航栏,单击image图标,然后单击页面右上角的New Dashboard

  2. New Dashboard页面,单击Add a new panel

  3. Edit Panel页面的Query页签,单击Data source区域的下拉框选择上一步添加的数据源。

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

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

      关键字

      说明

      SELECT

      选择需要查询的字段名。

      FROM

      选择需要查询的表名。

      WHERE

      添加查询条件。

      GROUP BY

      添加聚合条件。

      SAMPLE BY

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

      FILL

      选择填充策略。

      ORDER BY TIME

      选择排列顺序。

      LIMIT

      输入查询返回最多的数据数量。

      ALIAS BY

      重命名时间线标签。

      image

    • 使用TSQL语句查询:单击A区域右上角的切换,可以通过输入TSQL语句完成复杂的查询操作(例如嵌套查询),数据查询结果如下图。

      image

      说明

      TSQL语句使用请参见SELECT语法

      • $timeFilter表示时间条件,会自动替换为页面中选择的时间范围,定义为time>=xxx and time<=xxx

      • time为必选项,否则不会出现分析结果图。

      • SELECT语句中通过tag方式对不同时间线进行分组聚合。

      通过Alias by重命名时间线标签,例如使用$tag_host进行区分时间线,如下图所示:

      image

      TSQL语句中的$interval表示降采样时间间隔,语句示例如下:

      SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval
      说明

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

  5. 在右侧设置监控图表的名称、类型、展示样式等。

  6. 单击右上角的Apply

  7. 单击右上角的保存监控大盘图标,设置监控大盘的名称和归属目录。

  8. 单击Save,大盘即可创建成功。

Grafana 10.x版本

  1. 在Grafana首页,单击页面左上角的image图标。

  2. 在Grafana左侧导航栏,选择仪表板,单击页面右上角的新建,然后在下拉列表中单击新建仪表板

  3. 新建仪表板页面,单击+ 添加可视化

  4. 在弹出的Select data source页面右侧,选择上一步添加的数据源。

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

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

      关键字

      说明

      SELECT

      选择需要查询的字段名。

      FROM

      选择需要查询的表名。

      WHERE

      添加查询条件。

      GROUP BY

      添加聚合条件。

      SAMPLE BY

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

      FILL

      选择填充策略。

      ORDER BY TIME

      选择排列顺序。

      LIMIT

      输入查询返回最多的数据数量。

      ALIAS BY

      重命名时间线标签。

      image

    • 使用TSQL语句查询:单击A区域右上角的切换,可以通过输入TSQL语句完成复杂的查询操作(例如嵌套查询),数据查询结果如下图。

      image

      说明

      TSQL语句使用请参见SELECT语法

      • $timeFilter表示时间条件,会自动替换为页面中选择的时间范围,定义为time>=xxx and time<=xxx

      • time为必选项,否则不会出现分析结果图。

      • SELECT语句中通过tag方式对不同时间线进行分组聚合。

      通过Alias by重命名时间线标签,例如使用$tag_host进行区分时间线,如下图所示:

      image

      TSQL语句中的$interval表示降采样时间间隔,语句示例如下:

      SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval
      说明

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

  6. 在右侧设置监控图表的名称、类型、展示样式等。

  7. 单击右上角的Apply

  8. 单击右上角的保存监控大盘图标,设置监控大盘的名称和归属目录。

  9. 单击Save,大盘即可创建成功。

步骤四:查看监控数据

Grafana 9.x版本

  1. 在Grafana左侧导航栏,单击image图标,然后单击Browse

  2. Browse页签,单击目标目录下的监控大盘,即可查看目标大盘上的所有监控图表。

Grafana 10.x版本

  1. 在Grafana首页,单击页面左上角的image图标。

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

相关文档

使用Grafana进行异常检测算法调优