Grafana服务是用于展示大型测量数据的开源可视化工具,在互联网应用分析中应用范围十分广泛,并且在工业监控、气象监控、家居自动化和过程管理等领域也有着较广泛的用户基础。云原生多模数据库 Lindorm时序引擎提供Alibaba Cloud Lindorm数据源插件。您可以利用该插件在Grafana服务添加Lindorm数据源。本文介绍如何通过Grafana服务访问时序引擎并进行可视化数据分析。
可观测可视化Grafana版访问时序引擎
前提条件
已创建Grafana工作区。具体操作,请参见创建Grafana工作区。
如果通过专有网络访问Lindorm时序引擎,请完成以下操作:
为Grafana开通私网地址,开通私网地址,请参见私网域名与白名单设置。
将Grafana私网交换机的IP网段添加到Lindorm白名单。具体操作,请参见设置白名单。
如果通过公网访问Lindorm时序引擎,请完成以下操作:
为Lindorm时序引擎开通公网地址。开通时序引擎公网地址,请参见查看时序引擎连接地址。
将Grafana的公网IP添加到Lindorm白名单。具体操作,请参见设置白名单。
操作步骤
本文以Grafana 10.0.x为例介绍操作步骤。
登录可观测可视化 Grafana 版控制台,在左侧导航栏单击工作区管理。
在基本信息区域,单击公网地址或私网地址。输入用户名和密码。用户名为admin,密码为创建工作去时设置的密码。
在Grafana服务中添加Lindorm数据源。
单击左上角的图标,在列表中选择管理。然后单击数据源。
在管理页面,单击数据源。
在数据源页面,单击Add data source。
在Add data source页面的搜索框中输入Alibaba Cloud Lindorm,找到目标数据源并单击数据源。
在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时序引擎的数据库。
单击Save & test。
显示test success,说明测试连接成功。
单击Build a dashboard。
在New Dashboard页面,单击添加可视化。
选择步骤3添加的Lindorm数据源。
在Query页签中查询数据。
在Data source列表中选择目标数据源名称。
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自建Grafana服务访问时序引擎
部署要求
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。
操作步骤
安装Grafana服务(如已安装,可跳过)。
登录ECS实例。具体操作请参见登录ECS。
执行下述命令下载Grafana:
wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm
说明本文以Grafana企业版8.2.2-1版本为例,您也可以安装其他版本。其他版本的下载地址,请参见Grafana官网。
执行下述命令安装Grafana:
sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm
执行下述命令启动Grafana服务:
sudo service grafana-server start
安装Alibaba Cloud Lindorm数据源插件。
执行下述命令下载数据源插件。
wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip
执行下述命令解压插件到默认目录,Linux的默认目录为/var/lib/grafana/plugins/。
unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/
执行下述命令修改grafana.ini文件信息,Linux默认文件位置/etc/grafana/grafana.ini。
sudo nano -w /etc/grafana/grafana.ini
在[plugins]区域中将
;allow_loading_unsigned_plugins=
修改为allow_loading_unsigned_plugins = alibabacloud-lindorm-datasource
。修改后按下CTRL+O保存并回车退出编辑页面。重要修改grafana.ini文件时,需要删除
;allow_loading_unsigned_plugins
前面的半角分号(;)。执行下述命令重启Grafana服务:
sudo service grafana-server restart
在Grafana服务中添加Lindorm数据源。
在浏览器中输入http://IP:3000/,其中IP为ECS的公网IP或主私网IP。然后输入用户名和密码。如果是第一次登录,用户名和密码为admin,登录后请及时修改密码。更详细的介绍,请参见登录Grafana。
单击左侧的图标,在列表中选择Data Sources。
在Configuration页面,单击Add data source。
在Add data source页面的搜索框中输入Alibaba Cloud Lindorm,找到目标数据源并单击Select。
在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时序引擎的数据库。
单击Save & test。
显示test success,说明测试连接成功。
连接Lindorm实例后,在Grafana服务中创建并使用dashboard,具体操作您可以参考创建Dashboard。
在Query页签中查询数据。
在Data source列表中选择目标数据源名称。
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
设置时间偏移量,方便您将不同时间段的数据进行对比。