可观测监控 Prometheus 版提供了多场景的指标数据查询方式,本文介绍通过控制台查询数据、通过Prometheus HTTP API获取数据、自建Grafana配置Prometheus数据源、自建Prometheus配置Remote Read地址四个场景。
前提条件
已开通可观测监控 Prometheus 版,请确保您至少连接了一个组件。具体操作,请参见接入组件管理。
通过控制台查询数据
登录ARMS控制台。
在左侧导航栏,单击接入管理。
在接入管理页面,单击已接入环境页签,选择目标环境,然后单击目标环境名称进入详情页面。
在详情页面,单击指标探索页签。
在Explore区域,输入Metric名称并在Labels文本框添加键值对,然后单击页面右上角Run query进行查询。
说明在区域可以选择查询的时间范围,默认查询一小时内的数据。
单击+ Operations,可以添加PromQL内置函数,例如sum()、irate()、absent()等。使用方法,请参见开源版Prometheus官方文档。
单击Code可以切换至PromQL语句输入模式,PromQL语法请参见开源版Prometheus官方文档。
通过Prometheus HTTP API获取数据
步骤一:获取HTTP API地址
登录ARMS控制台。
在左侧导航栏选择 ,进入可观测监控 Prometheus 版的实例列表页面。
在顶部菜单栏选择Prometheus实例所属的地域,然后在实例列表页面单击目标实例操作列的设置。
在设置页签的HTTP API地址(Grafana 读取地址)的区域,按需获取公网或内网的HTTP API地址。
说明如果您需要提高数据读取的安全性,可以单击生成token,获取Prometheus实例的鉴权Token。生成Token后,发起HTTP请求时必须配置Token,否则无法读取Prometheus的监控数据。
步骤二:请求HTTP API地址
获取Prometheus监控数据的请求示例如下,更多使用HTTP API获取Prometheus监控数据的操作,请参见开源版Prometheus文档。
{HTTP API}
和{Token}
请替换为步骤一获取的HTTP API和Token。{PromQL}
请替换为需要查询的PromQL。
请求示例如下:
curl -H "Authorization:{Token}" "{HTTP API}/api/v1/query?query={PromQL}&time=1709171676&timeout=1000"
为自建Grafana配置Prometheus数据源
步骤一:获取Prometheus server URL地址
获取Prometheus server URL地址的详细步骤,请参见步骤一:获取HTTP API地址。
步骤二:为自建Grafana添加数据源
本文以自建10.0.x版本的Grafana为例进行说明。
以管理员账号登录自建Grafana。
说明初次登录自建Grafana,账号和密码都是admin,登录成功之后会弹出修改密码的对话框,请您修改Grafana的初始密码。
登录成功后,单击页面左上角的图标。
在左侧导航栏,单击Configuration。然后在页面左侧,单击Data Sources。
在Data sources页面,单击Add data source。
在Add data source页面,单击Prometheus。
单击Settings页签,在name文本框自定义您的大盘名称,在HTTP区域的Prometheus server URL输入框输入您在步骤一:获取Prometheus server URL地址中获取的URL。
说明如果您单击生成了token,还需要在Custom HTTP Headers区域单击+ Add header,设置Header为Authorization,设置Value为步骤一:获取Prometheus server URL地址中生成的鉴权Token。
单击页面底部的Save & test进行保存。
步骤三:结果验证
以管理员账号登录自建Grafana。
登录成功后,单击页面左上角的图标,然后在左侧导航栏单击Dashboards。
在Dashboards页面右上角单击New,然后在下拉菜单中选择New dashboard。
单击+ Add visualization,在弹出的Select data source页面选择您自定义命名的数据源。
在A区域的Metrics字段输入指标名称并按回车。如果能显示出相应指标的图表,则说明操作成功。
说明如果未能显示出相应指标的图表,则说明操作失败,请检查填写的接口地址或鉴权Token是否正确,以及Prometheus数据源是否有监控数据。
为自建Prometheus配置Remote Read地址
使用限制
可观测监控 Prometheus 版Remote Read接口暂不支持HTTP/2。
步骤一:获取Remote Read地址
登录ARMS控制台。
在左侧导航栏选择 ,进入可观测监控 Prometheus 版的实例列表页面。
在顶部菜单栏选择Prometheus实例所属的地域,然后在实例列表页面单击目标实例操作列的设置。
进入页面后,单击设置页签,按需获取公网或内网的Remote Read 地址。
步骤二:配置Remote Read地址
下载开源版Prometheus,下载地址,请参见Prometheus官方网站。
解压Prometheus安装包。
打开Prometheus的配置文件
prometheus.yml
,并在文件末尾增加以下内容,将remote_read.url
替换为步骤一中获取的Remote Read地址,然后保存并启动开源Prometheus服务。remote_read: # 替换 ARMS Prometheus Remote Read 地址 - url: "http://xx-xxx.aliyuncs.com:9443/xxx/api/v1/read" read_recent: true
步骤三:在开源Prometheus中查看可观测监控 Prometheus 版数据
浏览器访问http://localhost:9090
,在文本框中输入指标名称,单击页面右侧的Execute就可以远程读取到可观测监控 Prometheus 版的监控数据。