文档中心

云监控

云监控与 Grafana 集成

通过 Grafana 插件自定义看板

如果您希望集成 Grafana，云监控提供了 Grafana 插件，用于适配开源软件 Grafana 的数据源。本文介绍如何通过 Grafana 插件对数据进行自定义 Dashboard 展示。

注意事项

为避免该功能使用中断，请在使用前，开通云监控按量付费，详情请参见开通按量付费。

目前使用该功能免费，后续会按照使用该插件调用相关 API 的调用次数按量计费。

云产品通过 Grafana 插件获取监控数据源需运行在 Grafana 7.3 或更高的版本上。请提前安装 Grafana 环境，详情请参见 Grafana下载与安装。

如果是子账号配置云监控数据源服务，请为子账号授权云监控只读权限 CloudMonitorReadOnlyAccess，详情请参见为IAM用户授权。

步骤一：安装 Grafana 插件并配置

在已安装 Grafana 环境的机器上，安装 Grafana 插件。

执行以下命令，下载插件到目录/var/lib/grafana/plugins/。

cd /var/lib/grafana/plugins/
wget https://lf-paas-fe-cn.volccdn.com/obj/paas-fe-tos-cn/toutiao/paas/cloud-monitor-grafana-plugin/vestack-cloudmonitor-datasource-1.1.6-672440.tar.gz

执行以下命令，将插件解压到目录vestack-cloudmonitor-datasource。

tar -xzvf vestack-cloudmonitor-datasource-1.1.6-672440.tar.gz

配置云监控数据源服务插件。

执行以下命令，打开目录/usr/share/grafana/conf中的配置文件defaults.ini。

cd /usr/share/grafana/conf
vi defaults.ini

配置allow_loading_unsigned_plugins为插件的解压目录 vestack-cloudmonitor-datasource，允许未签名的云监控数据源服务插件运行。

allow_loading_unsigned_plugins = vestack-cloudmonitor-datasource

按 Esc 键，输入:wq，再按 Enter 键，保存并退出文件defaults.ini。

执行以下命令，重启 Grafana 服务。

service grafana-server restart

步骤二：配置云监控数据源服务

在左侧菜单选择 Data sources，然后单击右上角 Add new data source。

完成以下配置，输入具有云监控只读权限 CloudMonitorReadOnlyAccess 的子账号 AK 和 SK。然后单击 Save & Test。

参数	说明
Name	数据源名称。默认名称为 Cloud Monitor。
Access Key ID	主账号或者 IAM 用户的 AccessKey ID。详情请参见 Access Key（密钥）管理。
Secret Key ID	主账号或者 IAM 用户的 SecretKey ID。详情请参见 Access Key（密钥）管理。
API Host	云监控的 API 域名，默认为 open.volcengineapi.com。使用公有云服务时无需修改。如需使用私网解析，请配置为对应的 API 域名。
API Region	云监控 API 对应的地域，默认为 cn-beijing。使用公有云服务时无需修改。如需使用私网解析，请配置为对应的云监控 API 地域。

步骤三：添加监控大盘和监控图表

在 New dashboard 页面，单击 Add an empty panel。

在 Query 页签，选择数据源 Cloud Monitor，并设置目标云服务的监控指标。

参数	说明	是否支持模板变量
Namespace	要查询的监控指标所属的产品空间。参见云产品监控指标下各产品的 Namespace。	否
region	地域列表会根据 Namespace 选项自动获取，单击选择某一地域。	是使用模板变量配置的详细步骤，请参见使用Grafana模板变量。
MetricName	要查询的监控指标名称。参见云产品监控指标下各产品的 MetricName。	否
SubNamespace	要查询的指标所属的维度。SubNamespace 在不同 Namespace 下的可选值不同，参见云产品监控指标下各产品的 SubNamespace。	否
projectName	要查询的监控产品资源所属的项目。详情请参见项目管理。	是
资源	要查询的监控产品资源的分类。	否
资源名称	要查询的监控产品资源，会根据所选 Namespace、region 和资源自动获取，单击选择某一资源。	是使用模板变量配置的详细步骤，请参见使用Grafana模板变量。
Period	查询数据的间隔粒度，支持秒（s）、分钟（m）、时（h）、天（d）和周（w）粒度。例如查询 10 分钟内的数据，并根据 1 分钟进行分割，则会返回 10 条数据。当时间选段较长时，不建议使用小单位作为间隔，否则将会导致数据集过大。关于传入 Period 后，StartTime、EndTime 偏移的说明，请参见 Period说明。	是使用模板变量配置的详细步骤，请参见使用Grafana模板变量。
GroupBy	要查询的指标所使用的分组维度。默认所有 Dimension 会作为指标分组维度。如果指标存在可选 Dimension，使用时需要额外指定 GroupBy 参数。详情请参见查看云产品监控下各产品的可选 Dimensions。注意 SDK 必须升级到以下版本，才支持通过 GroupBy 筛选分组维度。 Python：1.0.37 版本以上 Java：0.1.75 版本以上 Go：1.0.97 版本以上	否

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

单击右上角的 Apply，创建监控图表。

单击右上角的 Save，创建监控大盘。

在 Manage 页签，单击目标监控大盘，查看监控图表。

最近更新时间：2026.08.27 15:00:17

这个页面对您有帮助吗？

有用

无用