文档

添加并使用Lindorm数据源

更新时间:

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

背景信息

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

功能入口

  1. 登录ARMS控制台,在左侧导航栏选择Grafana服务 > 工作区管理

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

    说明

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

配置数据源

  1. 在Grafana左侧导航栏选择设置 > Data sources

  2. Data sources页签单击Add data source

  3. 在页面最下方单击Alibaba Cloud Lindorm

  4. 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时序引擎的数据库。

  5. 单击Save & Test

    当页面显示Data source is working时,表示Lindorm数据已成功添加至Grafana。

创建大盘面板

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

  1. 在Grafana左侧导航栏选择Dashboard > + New dashboard

  2. New dashboard页面单击Add a new panel

  3. Edit Panel页面的Query区域的下拉列表中选择Lindorm数据源,并设置监控指标。

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

    2. TSQL查询操作有两种方式,包括使用编辑框查询和使用TSQL语句查询。

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

        关键字

        说明

        SELECT

        选择需要查询的字段名。

        FROM

        选择需要查询的表名。

        WHERE

        添加查询条件。

        GROUP BY

        添加聚合条件。

        SAMPLE BY

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

        FILL

        选择填充策略。

        ORDER BY TIME

        选择排列顺序。

        LIMIT

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

        ALIAS BY

        重命名时间线标签。

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

        SELECT region,time,temperature FROM sensor WHERE $timeFilter

        输入SQL语句

        说明

        TSQL语句使用请参见SELECT语法

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

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

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

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

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

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

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

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

  5. 单击右上角的Apply

    大盘面板创建成功。

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

  7. 单击Save

    大盘创建成功。

查看监控数据

  1. 在Grafana左侧导航栏,选择Dashboard > Browse

  2. Browse页签,单击目标目录下的监控大盘。

    查看目标大盘上的所有监控图表。

  • 本页导读 (1)