如果您希望集成 Grafana，云监控提供了 Grafana 插件，用于适配开源软件 Grafana 的数据源。本文介绍如何通过 Grafana 插件对数据进行自定义 Dashboard 展示。 ## 注意事项 * 为避免该功能使用中断，请在使用前，开通云监控按量付费，详情请参见 [开通按量付费](https://www.volcengine.com/docs/6408/192702)。目前使用该功能免费，后续会按照使用该插件调用相关 API 的调用次数按量计费。 * 云产品通过 Grafana 插件获取监控数据源需运行在 Grafana 7.3 或更高的版本上。请提前安装 Grafana 环境，详情请参见 [Grafana下载与安装](https://grafana.com/grafana/download)。 * 如果是子账号配置云监控数据源服务，请为子账号授权云监控只读权限 **CloudMonitorReadOnlyAccess**，详情请参见 [为IAM用户授权](https://www.volcengine.com/docs/6408/1130957)。 ## 步骤一：安装 Grafana 插件并配置在已安装 Grafana 环境的机器上，安装 Grafana 插件。 1. 执行以下命令，下载插件到目录`/var/lib/grafana/plugins/`。 ```Shell 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 ``` 2. 执行以下命令，将插件解压到目录`vestack-cloudmonitor-datasource`。 ```Shell tar -xzvf vestack-cloudmonitor-datasource-1.1.6-672440.tar.gz ``` 3. 配置云监控数据源服务插件。 1. 执行以下命令，打开目录`/usr/share/grafana/conf`中的配置文件`defaults.ini`。 ```Shell cd /usr/share/grafana/conf vi defaults.ini ``` 2. 配置`allow_loading_unsigned_plugins`为插件的解压目录 vestack\-cloudmonitor\-datasource，允许未签名的云监控数据源服务插件运行。 ```Plain allow_loading_unsigned_plugins = vestack-cloudmonitor-datasource ``` 3. 按 Esc 键，输入`:wq`，再按 Enter 键，保存并退出文件`defaults.ini`。 4. 执行以下命令，重启 Grafana 服务。 ```PowerShell service grafana-server restart ``` ## 步骤二：配置云监控数据源服务 1. 登录 Grafana。 2. 在左侧菜单选择 **Data sources**，然后单击右上角 **Add new data source**。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/45ec1a1ff3394f7e9c17d763725e9c7b~tplv-goo7wpa0wc-image.image) 2. 完成以下配置，输入具有云监控只读权限 **CloudMonitorReadOnlyAccess ** 的子账号 AK 和 SK。然后单击 **Save & Test**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c96e0baf626b22b282ff25cf2550cf12.png) |参数 |说明 | |---|---| |Name |数据源名称。默认名称为 Cloud Monitor。 | |Access Key ID |主账号或者 IAM 用户的 AccessKey ID。详情请参见 [Access Key（密钥）管理](https://www.volcengine.com/docs/6291/65568)。 | |Secret Key ID |主账号或者 IAM 用户的 SecretKey ID。详情请参见 [Access Key（密钥）管理](https://www.volcengine.com/docs/6291/65568)。 | |API Host |云监控的 API 域名，默认为 open.volcengineapi.com。使用公有云服务时无需修改。如需使用私网解析，请配置为对应的 API 域名。 | |API Region |云监控 API 对应的地域，默认为 cn\-beijing。使用公有云服务时无需修改。如需使用私网解析，请配置为对应的云监控 API 地域。 | ## 步骤三：添加监控大盘和监控图表 1. 在 **New dashboard ** 页面，单击 **Add an empty panel**。 2. 在 **Query ** 页签，选择数据源 **Cloud Monitor**，并设置目标云服务的监控指标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8ceccf525f7c257d932cb9fd9483e3c5.png) |参数 |说明 |**是否支持模板变量** | |---|---|---| |Namespace |要查询的监控指标所属的产品空间。参见 [云产品监控指标](https://console.volcengine.com/cloud_monitor/metricDoc?tabKey=metric) 下各产品的 Namespace。 |否 | |region |地域列表会根据 Namespace 选项自动获取，单击选择某一地域。 |是

使用模板变量配置的详细步骤，请参见 [使用Grafana模板变量](https://www.volcengine.com/docs/6408/1254188)。 | |MetricName |要查询的监控指标名称。参见 [云产品监控指标](https://console.volcengine.com/cloud_monitor/metricDoc?tabKey=metric) 下各产品的 MetricName。 |否 | |SubNamespace |要查询的指标所属的维度。SubNamespace 在不同 Namespace 下的可选值不同，参见 [云产品监控指标](https://console.volcengine.com/cloud_monitor/metricDoc?tabKey=metric) 下各产品的 SubNamespace。 |否 | |projectName |要查询的监控产品资源所属的项目。详情请参见 [项目管理](https://www.volcengine.com/docs/6649/189152)。 |是 | |资源 |要查询的监控产品资源的分类。 |否 | |资源名称 |要查询的监控产品资源，会根据所选 Namespace、region 和资源自动获取，单击选择某一资源。 |是

使用模板变量配置的详细步骤，请参见 [使用Grafana模板变量](https://www.volcengine.com/docs/6408/1254188)。 | |Period |查询数据的间隔粒度，支持秒（s）、分钟（m）、时（h）、天（d）和周（w）粒度。

例如查询 10 分钟内的数据，并根据 1 分钟进行分割，则会返回 10 条数据。当时间选段较长时，不建议使用小单位作为间隔，否则将会导致数据集过大。关于传入 Period 后，StartTime、EndTime 偏移的说明，请参见 [Period说明](https://www.volcengine.com/docs/6408/105542)。 |是

使用模板变量配置的详细步骤，请参见[使用Grafana模板变量](https://www.volcengine.com/docs/6408/1254188)。 | |GroupBy |要查询的指标所使用的分组维度。默认所有 Dimension 会作为指标分组维度。如果指标存在可选 Dimension，使用时需要额外指定 GroupBy 参数。详情请参见 [查看云产品监控](https://www.volcengine.com/docs/6408/68116) 下各产品的可选 Dimensions。

注意

SDK 必须升级到以下版本，才支持通过 GroupBy 筛选分组维度。

Python：1.0.37 版本以上

Java：0.1.75 版本以上

Go：1.0.97 版本以上

|否 | 3. 在右侧设置监控图表的名称、类型、展示样式等。 4. 单击右上角的 **Apply**，创建监控图表。 5. 单击右上角的 **Save**，创建监控大盘。 6. 在 **Manage** 页签，单击目标监控大盘，查看监控图表。