简体中文 | English
注意：该插件从 2.0.0 版本起的最低运行要求为 Grafana 7.3 或更高的版本上。请优先安装 Grafana 环境，详情参考 Grafana 安装文档。
腾讯云监控 为用户提供云服务器、云数据库等多个云产品的负载和性能监控指标，用户可以使用云监控控制台、云监控 API 等方式获取相关监控数据。腾讯云监控应用插件 Tencent Cloud Monitor App，是一款适配开源软件 Grafana 的应用插件，通过调用 腾讯云监控 API 3.0 的方式获取监控数据，并对数据进行自定义 Dashboard 展示。
该插件提供了云服务器、云数据库 MySQL、负载均衡 等具有代表性的 Dashboard 预设模板
支持的云产品监控及文档如下表所示，更多云产品的监控指标数据源在陆续完善中。
前置条件：腾讯云监控应用插件是运行在 Grafana 7.3 或更高的版本上。请优先安装 Grafana 环境，详情参考 Grafana 安装文档。
使用 Grafana CLI 安装：
$ grafana-cli plugins install tencentcloud-monitor-app或者阅读更多安装与更新方式。
鼠标悬浮左侧导航栏的 齿轮 图标，点击 Plugins 选项，进入 Plugins 管理页面，如果插件列表中正常展示 Tencent Cloud Monitor APP 插件，表示插件安装成功；
进入应用详情页面，点击 Enable 按钮，启用成功后，即可在 Grafana 中使用腾讯云监控应用插件。
腾讯云监控应用插件通过调用 云监控 API 的方式获取各云产品的监控指标数据，通过以下步骤，配置相应云产品的数据源。
- 鼠标悬浮左侧导航栏的 齿轮 图标，单击 【Data Sources】选项，进入数据源管理页面；
- 点击右上角的
Add data source按钮，然后单击【Tencent Cloud Monitoring】数据源，进入数据源配置页面；
Name数据源名称，可以是任意名称，默认为Tencent Cloud Monitoring；SecretId和SecretKey是调用云监控 API 必需的安全证书信息，二者可以通过腾讯云控制台 云 API 密钥页面 获取；- 选择需要获取监控数据的云产品；
- 单击【Save & Test】按钮，测试数据源的配置信息是否正确，配置成功后，即可以在 Dashboard 中使用该数据源。
支持快捷创建、管理页面和导入模板三种方式创建 Dashboard。
鼠标悬浮左侧导航栏的 加号 图标，单击【Dashboard】选项，即可创建一个新的 Dashboard。
鼠标悬浮左侧导航栏的 田字格 图标，单击【Manage】选项，进入 Dashboard 管理页面，单击【New Dashboard】按钮，即可创建一个新的 Dashboard。同时，在该页面可以对 Dashboard 进行各种管理操作，如新建文件夹、移动 Dashboard、导入 Dashboard 等。
鼠标悬浮左侧导航栏的 齿轮 图标，单击【Plugins】选项，进入 Plugins 管理页面。然后，单击【Tencent Cloud Monitor】应用，进入应用详情页面，切换至 Dashboards 选项卡，选择 Dashbboard 模板导入。
创建 Dashboard 之后，通过配置 Panel 信息，即可获取腾讯云监控的相应监控数据。现在以简单的 Graph 为例，展示如何配置 Panel 信息。
- 点击 New Panel 面板的 Add Query 选项，进入 Panel 配置页面。在左侧第一个
Query选项卡，选择 上面配置的腾讯云监控数据源。 Namespace命名空间，例如云服务器监控的命名空间为QCE/CVM。Region地域，地域列表会根据Namespace选项自动获取，单击选择某一地域。MetricName指标名称，指标列表会根据Namespace和Region选项自动获取，单击选择某一指标。点击查看各个云产品的指标文档。Period监控统计周期，周期列表会根据MetricName选项自动获取，单击选择某一统计周期。Instance实例，对应输入参数的Instances.N字段，实例列表会自动获取。点击查看各个云产品的实例列表接口文档。- 为了适应不同用户的习惯，实例列表会以不同的字段展示，默认以各产品的 ID 展示。
Show Details按钮仅在选择非模板变量时显示，切换Show Details为true，可展示实例请求参数，默认参数为Offset = 0和Limit = 20。如果需要变更实例查询条件，可参考接口文档，配置相应参数。- 注意： 在本应用中，监控数据的单次查询为原子操作，即查询某一实例的某一指标的监控数据，故实例只能单选，如需查询多实例的监控数据，点击底部
+ Query增加新的查询。
模板变量 Variables 是 Grafana 提供的一种 Dashboard 优化特性，用于创建高度可复用和交互式 Dashboard。模板变量的一般思想是允许 Grafana 从数据源获得不同的度量，并提供一种无需修改仪表板就可以动态更改它的方法。腾讯云监控应用目前提供了地域、云服务器实例、云数据库 MySQL 实例 等变量。
所有实例类 Query 支持自定义下拉框选项展示字段，通过 display 字段设置，如：Namespace=QCE/CVM&Action=DescribeInstances&Region=$region&display=${InstanceId}-${InstanceName}。如果同时存在 InstanceAlias 和 display 字段，则仅会展示 display 的值。
2.1.0 版本起新增 payload 参数，支持在模板变量中过滤实例，如：
Namespace=QCE/CVM&
Action=DescribeInstances&
Region=ap-guangzhou&
InstanceAlias=InstanceId&
payload={
"Filters":[
{
"Name": "zone",
"Values": ["ap-guangzhou-1"]
}
]
}
可过滤可用区为 广州一区 的实例。注意 payload 参数为严格 JSON 字符串。
已经提供的模板变量如下表所示：
| 变量 | 描述 | 示例 |
|---|---|---|
| 地域 | 参考 地域接口文档。Action 固定为 DescribeRegions，Namespace 为云产品对应的命名空间，如 QCE/CVM QCE/CDB等。地区作为变量模板，只支持单选，如设置成多选或者选中 All, 默认选中第一个地区值。 |
Namespace=QCE/CVM&Action=DescribeRegions |
| CVM 云服务器实例 | 参考 云服务器查询实例列表接口文档。Namespace 固定为QCE/CVM，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName、PrivateIpAddresses、PublicIpAddresses。云服务器实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CVM&Region=ap-beijing&Action=DescribeInstances&InstanceAlias=PublicIpAddresses |
| CDB 云数据库 MySQL 实例 | 参考 云数据库MySQL查询实例列表接口文档。Namespace 固定为QCE/CDB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName、Vip。云数据库实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CDB&Region=ap-beijing&Action=DescribeInstances&InstanceAlias=InstanceId |
| 云数据库 PostgreSql 实例 | 参考 云数据库PostgreSQL查询实例列表接口文档。Namespace 固定为QCE/CDB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 DBInstanceId，可选值为 DBInstanceName, PrivateIpAddresses, PublicIpAddresses。云数据库实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/POSTGRES&Region=ap-beijing&Action=DescribeInstances&InstanceAlias=DBInstanceId |
| 云数据库 MongoDB 实例 | 参考 CMONGO实例查询实例列表接口文档。Namespace 固定为QCE/CMONGO，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。CMONGO实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CMONGO&Region=$region&Action=DescribeInstances |
| 云数据库 Redis 实例 | 参考 REDIS实例查询实例列表接口文档。Namespace 固定为QCE/REDIS，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。REDIS实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/REDIS&Region=$region&Action=DescribeInstances |
| 云数据库 TDSQL-C (原CynosDB) | 参考 CYNOSDBMYSQL实例查询实例列表接口文档。Namespace 固定为QCE/CYNOSDB_MYSQL，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。CYNOSDBMYSQL实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CYNOSDB_MYSQL&Region=$region&Action=DescribeInstances |
| 云数据库 TcaplusDB 实例 | 参考 TCAPLUS实例查询实例列表接口文档。Namespace 固定为QCE/TCAPLUS，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。TCAPLUS实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/TCAPLUS&Region=$region&Action=DescribeInstances |
| 云数据库 SQL Server 实例 | 参考 SQLSERVER实例查询实例列表接口文档。Namespace 固定为QCE/SQLSERVER，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 Name。SQLSERVER实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/SQLSERVER&Region=$region&Action=DescribeInstances |
| 私有网络 NateGateway 实例 | 参考 私有网络Nat网关查询实例列表接口文档。Namespace 固定为QCE/NAT_GATEWAY，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 NatGatewayId，可选值为 NatGatewayName。NateGateway 网关实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/NAT_GATEWAY&Region=ap-beijing&Action=DescribeInstances&InstanceAlias=NatGatewayId |
| 私有网络对等连接实例 | 参考 私有网络对等连接查询实例列表接口文档。Namespace 固定为QCE/PCX，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 peeringConnectionId，可选值为 peeringConnectionName。对等连接实例作为模板变量，同时支持单选和多选（如果是负载均衡则不支持多选，可选多个监听器）。 |
Namespace=QCE/PCX&Region=ap-beijing&Action=DescribeInstances&InstanceAlias=peeringConnectionId |
| CLB 负载均衡实例 | 参考 负载均衡实例列表接口文档。Namespace 可为QCE/LB_PRIVATE，QCE/LB_PUBLIC，QCE/LOADBALANCE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 LoadBalancerId，可选值为 LoadBalancerName，LoadBalancerVips。同时支持单选和多选。 |
Namespace=QCE/LB_PRIVATE&Action=DescribeInstances&Region=$region&InstanceAlias=LoadBalancerId |
| 负载均衡监听器 | 参考 负载均衡监听器列表接口文档。Namespace 可为QCE/LB_PRIVATE，QCE/LB_PUBLIC，QCE/LOADBALANCE，Action 固定为DescribeListeners。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。Instance 为实例id，可以为特定的实例，如 lbl-rbw529fz；也可以为变量值，如 $instance。listenerAlias 为监听器的展示字段，默认为 ListenerId，可选值为 ListenerName，Port。同时支持单选和多选。 |
Namespace=QCE/LB_PRIVATE&Action=DescribeListeners&Region=$region&Instance=$instance&listenerAlias=ListenerId |
| CDN 内容分发式网络实例 | 参考 CDN实例查询实例列表接口文档。Namespace 固定为QCE/CDN，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 Domain，可选值为 Domain, ProjectId。CDN实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CDN&Region=$region&Action=DescribeInstances |
| CDN 省份域名 | 参考 CDNPROVINCE实例查询实例列表接口文档。Namespace 固定为QCE/CDN_LOG_DATA，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 Domain，可选值为 ProjectId。 |
Namespace=QCE/CDN_LOG_DATA&Region=$region&Action=DescribeInstances |
| CDN 省份运营商 | 参考 CDNPROVINCE的map信息列表接口文档。Namespace 固定为QCE/CDN_LOG_DATA，Action 固定为DescribeMapInfo。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。Instance 为实例,可为变量值，如$instance。Name为接口必填参数，用于获取运营商或者省份列表，isp-运营商，district-省份。详见参考文档 |
Namespace=QCE/CDN_LOG_DATA&Region=$region&Action=DescribeInstances&Instance=$instance&Name=isp |
| BWP 带宽包实例 | 参考 BWP实例查询实例列表接口文档。Namespace 固定为QCE/BWP，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 BandwidthPackageId，可选值为 BandwidthPackageId, BandwidthPackageName。BWP实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/BWP&Region=$region&Action=DescribeInstances |
| CKafka 消息队列实例 | 参考 CKAFKA实例查询实例列表接口文档。Namespace 固定为QCE/CKAFKA，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。CKAFKA实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CKAFKA&Region=$region&Action=DescribeInstances |
| LB 弹性公网IP 实例 | 参考 LB实例查询实例列表接口文档。Namespace 固定为QCE/LB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 AddressId，可选值为 AddressId, AddressName, AddressIp。LB实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/LB&Region=$region&Action=DescribeInstances |
| CFS 文件存储实例 | 参考 CFS实例查询实例列表接口文档。Namespace 固定为QCE/CFS，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 FileSystemId，可选值为 FileSystemId, FsName。CFS实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CFS&Region=$region&Action=DescribeInstances |
| SCF云函数实例 | 参考 SCF实例查询实例列表接口文档。Namespace 固定为QCE/SCF_V2，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 FunctionId，可选值为 FunctionId, FunctionName。SCF实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/SCF_V2&Region=$region&Action=DescribeInstances |
| DCX 专线接入-专用通道实例 | 参考 DCX实例查询实例列表接口文档。Namespace 固定为QCE/DCX，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 DirectConnectTunnelId，可选值为 DirectConnectTunnelName。DCX实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/DCX&Region=$region&Action=DescribeInstances |
| DC 专线接入-物理专线实例 | 参考 DC实例查询实例列表接口文档。Namespace 固定为QCE/DC，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 DirectConnectId，可选值为 DirectConnectName。DC实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/DC&Region=$region&Action=DescribeInstances |
| 私有网络-VPN 网关实例 | 参考 VPNGW实例查询实例列表接口文档。Namespace 固定为QCE/VPNGW，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 VpnGatewayId，可选值为 VpnGatewayName。VPNGW实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/VPNGW&Region=$region&Action=DescribeInstances |
| 私有网络-专线网关实例 | 参考 DCG实例查询实例列表接口文档。Namespace 固定为QCE/DCG，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 DirectConnectGatewayId，可选值为 DirectConnectGatewayName。DCG实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/DCG&Region=$region&Action=DescribeInstances |
| 私有网络-VPN 通道 | 参考 VPNX实例列表接口文档。Namespace 固定为QCE/VPNX，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 VpnConnectionId，可选值为 VpnConnectionId，VpnConnectionName。同时支持单选和多选。 |
Namespace=QCE/VPNX&Action=DescribeInstances&Region=$region&InstanceAlias=VpnConnectionId |
| 私有网络-Anycast弹性公网IP | 参考 CEIP_SUMMARY实例列表接口文档。Namespace 固定为QCE/CEIP_SUMMARY，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 AddressId，可选值为 AddressId，AddressName，AddressIp。同时支持单选和多选。 |
Namespace=QCE/CEIP_SUMMARY&Action=DescribeInstances&Region=$region&InstanceAlias=AddressId |
| 私有网络-网络探测 | 参考 VPC_NET_DETECT实例列表接口文档。Namespace 固定为QCE/VPC_NET_DETECT，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 NetDetectId，可选值为 NetDetectId，NetDetectName。同时支持单选和多选。 |
Namespace=QCE/VPC_NET_DETECT&Action=DescribeInstances&Region=$region&InstanceAlias=NetDetectId |
| 私有网络-云联网 | 参考 VBC实例列表接口文档。Namespace 固定为QCE/VBC，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 CcnId，可选值为 CcnId，CcnName。同时支持单选和多选。 |
Namespace=QCE/VBC&Action=DescribeInstances&Region=$region&InstanceAlias=CcnId |
| API 网关实例 | 参考 APIGATEWAY实例查询实例列表接口文档。Namespace 固定为QCE/APIGATEWAY，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ServiceId，可选值为 ServiceName。 |
Namespace=QCE/APIGATEWAY&Region=$region&Action=DescribeInstances |
| API 网关服务环境 | 参考 APIGATEWAY服务环境列表接口文档。Namespace 固定为QCE/APIGATEWAY，Action 固定为DescribeServiceEnvironmentList。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。Instance 为实例，可以为特定的地域值；也可以为变量值，如 $instance。 |
Namespace=QCE/APIGATEWAY&Region=$region&Action=DescribeInstances&Instance=$instance |
| CBS 云硬盘实例 | 参考 CBS实例查询实例列表接口文档。Namespace 固定为QCE/BLOCK_STORAGE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 DiskId，可选值为 DiskName。CBS实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/BLOCK_STORAGE&Region=$region&Action=DescribeInstances |
| Elasticsearch 实例 | 参考 CES实例查询实例列表接口文档。Namespace 固定为QCE/CES，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceName。CES实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CES&Region=$region&Action=DescribeInstances |
| CMQ 消息队列实例 | 参考 CMQ实例查询实例列表接口文档。Namespace 固定为QCE/CMQ，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 QueueName，可选值为 QueueId。CMQ实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CMQ&Region=$region&Action=DescribeInstances |
| CMQ 消息队列主题订阅实例 | 参考 CMQTOPIC实例查询实例列表接口文档。Namespace 固定为QCE/CMQTOPIC，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-beijing；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 TopicName，可选值为 TopicId。CMQTOPIC实例作为模板变量，同时支持单选和多选。 |
Namespace=QCE/CMQTOPIC&Region=$region&Action=DescribeInstances |
| 分布式数据库 TDSQL MySQL(TDMYSQL) | 参考 分布式数据库 TDSQL MySQL(TDMYSQL)实例列表接口文档。Namespace 固定为QCE/TDMYSQL，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceId，InstanceName。同时支持单选和多选。 |
Namespace=QCE/TDMYSQL&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceId |
| 对象存储(COS) | 参考 对象存储(COS)实例列表接口文档。Namespace 固定为QCE/COS，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 BucketName，可选值为 BucketName。同时支持单选和多选。 |
Namespace=QCE/COS&Action=DescribeInstances&Region=$region&InstanceAlias=BucketName |
| 消息队列 TDMQ(TDMQ) | 参考 消息队列 TDMQ(TDMQ)实例列表接口文档。Namespace 固定为QCE/TDMQ，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TDMQ&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 黑石物理服务器(CPM) | 参考 黑石物理服务器(CPM)实例列表接口文档。Namespace 固定为QCE/CPM，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceId，Name。同时支持单选和多选。 |
Namespace=QCE/CPM&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceId |
| 黑石对等连接(BM_PCX) | 参考 黑石对等连接(BM_PCX)实例列表接口文档。Namespace 固定为QCE/BM_PCX，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 VpcPeerConnectionId，可选值为 VpcPeerConnectionId，VpcPeerConnectionName。同时支持单选和多选。 |
Namespace=QCE/BM_PCX&Action=DescribeInstances&Region=$region&InstanceAlias=VpcPeerConnectionId |
| 黑石外网负载均衡(BM_LB) | 参考 黑石外网负载均衡(BM_LB)实例列表接口文档。Namespace 固定为QCE/BM_LB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 LoadBalancerId，可选值为 LoadBalancerId，LoadBalancerVips，LoadBalancerName。同时支持单选和多选。 |
Namespace=QCE/BM_LB&Action=DescribeInstances&Region=$region&InstanceAlias=LoadBalancerId |
| 黑石内网负载均衡(BM_INTRA_LB) | 参考 黑石内网负载均衡(BM_INTRA_LB)实例列表接口文档。Namespace 固定为QCE/BM_INTRA_LB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 LoadBalancerId，可选值为 LoadBalancerId，LoadBalancerVips，LoadBalancerName。同时支持单选和多选。 |
Namespace=QCE/BM_INTRA_LB&Action=DescribeInstances&Region=$region&InstanceAlias=LoadBalancerId |
| 弹性MapReduce(HDFS) | 参考 弹性MapReduce(HDFS)实例列表接口文档。Namespace 固定为QCE/TXMR_HDFS，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_HDFS&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(HBASE) | 参考 弹性MapReduce(HBASE)实例列表接口文档。Namespace 固定为QCE/TXMR_HBASE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_HBASE&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(HIVE) | 参考 弹性MapReduce(HIVE)实例列表接口文档。Namespace 固定为QCE/TXMR_HIVE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_HIVE&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(NODE) | 参考 弹性MapReduce(NODE)实例列表接口文档。Namespace 固定为QCE/TXMR_NODE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_NODE&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(PRESTO) | 参考 弹性MapReduce(PRESTO)实例列表接口文档。Namespace 固定为QCE/TXMR_PRESTO，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_PRESTO&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(SPARK) | 参考 弹性MapReduce(SPARK)实例列表接口文档。Namespace 固定为QCE/TXMR_SPARK，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_SPARK&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(YARN) | 参考 弹性MapReduce(YARN)实例列表接口文档。Namespace 固定为QCE/TXMR_YARN，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_YARN&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 弹性MapReduce(ZOOKEEPER) | 参考 弹性MapReduce(ZOOKEEPER)实例列表接口文档。Namespace 固定为QCE/TXMR_ZOOKEEPER，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 ClusterId，可选值为 ClusterId，ClusterName。同时支持单选和多选。 |
Namespace=QCE/TXMR_ZOOKEEPER&Action=DescribeInstances&Region=$region&InstanceAlias=ClusterId |
| 全球应用加速(QAAP) | 参考 全球应用加速(QAAP)实例列表接口文档。Namespace 固定为QCE/QAAP，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceId。同时支持单选和多选。 |
Namespace=QCE/QAAP&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceId |
| 边缘计算和网络监控(ECM) | 参考 边缘计算和网络监控(ECM)实例列表接口文档。Namespace 固定为QCE/ECM，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceId，InstanceName。同时支持单选和多选。 |
Namespace=QCE/ECM&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceId |
| 边缘计算存储监控(ECM_BLOCK_STORAGE) | 参考 边缘计算存储监控(ECM_BLOCK_STORAGE)实例列表接口文档。Namespace 固定为QCE/ECM_BLOCK_STORAGE，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 InstanceId，可选值为 InstanceId，InstanceName。同时支持单选和多选。 |
Namespace=QCE/ECM_BLOCK_STORAGE&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceId |
| 边缘计算负载均衡(ECM_LB) | 参考 边缘计算负载均衡(ECM_LB)实例列表接口文档。Namespace 固定为QCE/ECM_LB，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 LoadBalancerId，可选值为 LoadBalancerId，LoadBalancerName。同时支持单选和多选。 |
Namespace=QCE/ECM_LB&Action=DescribeInstances&Region=$region&InstanceAlias=LoadBalancerId |
| Web 应用防火墙(WAF) | 参考 Web 应用防火墙(WAF)实例列表接口文档。Namespace 固定为QCE/WAF，Action 固定为DescribeInstances。Region 为地域参数，可以为特定的地域值，如 ap-guangzhou；也可以为变量值，如 $region。InstanceAlias 为实例的展示字段，默认为 Domain，可选值为 Domain，ProjectId。同时支持单选和多选。 |
Namespace=QCE/WAF&Action=DescribeInstances&Region=$region&InstanceAlias=Domain |
- 进入某一 Dashboard 页面，点击右上角的 齿轮 图标，进入 Dashboard 设置页面；
- 点击左侧 Variables 选项，进入变量设置页面，然后点击
+ Add variable按钮，进入变量编辑页面；
Name变量名，一般为英文字符串，在 Dashboard 的编辑中使用该变量名替换原特定值。Label变量的可见标签，用于更显式地描述变量名称。例如，Name设置为 "region"，Lable可设置为 "地区"。Type变量查询方式，此处只能选择Query方式，即通过向数据源发送请求获取变量的列表。Data source要获取变量列表的数据源，选择已配置的任意腾讯云监控数据源。Refresh更新变量的方式，定义变量数据何时被更新。Query变量查询语句，详情参见上述表格的变量示例和描述。
变量信息填写完毕，可在页面下方预览查询得到的变量值，如果与期望值相符，点击 Add 按钮添加变量。添加成功后，点击右侧菜单的 Save 保存至 Dashboard 配置。
以云服务器单机监控 Dashboard 为例，展示如何配置级联变量：地域变量、云服务器实例变量，如下图所示。
如需多选实例可将 Selection Options 下的 Multi-value 激活；地域模板变量仅支持单选；
创建变量后，在 Dashboard 页面的左上角会展示变量选择框，可以切换变量值。变量有两种引用语法，$varname 和 [[varname]]。变量常用于 Panel 的查询语句中，以云服务器单机监控 Dashboard 为例，展示如何在查询中使用变量，如下图所示。此外，变量还可以应用在 Panel 标题、Text 文本面板等。
Q: 插件支持在同一个 Panel 中多地域查询吗？
A: 如果在 Dashboard 中使用 region 模板变量，则仅支持单地域查询。多地域实例对比可在同一个 Panel 中建多个 Query Target；
Q: 插件支持在同地域多个实例对比吗？
A: 可以将模板变量中 Selection Options 下的 Multi-value 设置为 true， Dashboard 中下拉框便可以进行多选实例，如图所示：
Q: 对比多个实例时，模板中报错 Only queries that return single series/table is supported。
A: 部分 Panel 类型如仪表盘图表仅支持单 query 查询，如需对比多实例请使用折线图 (Line)。
Q: 模板变量中的实例下拉框的选项显示的是 InstanceId ，如何展示 InstanceName ？
A: 可以在模板变量中使用 InstanceAlias=InstanceName ，或者使用 display 属性进行拼接，例：
Namespace=QCE/CVM&Action=DescribeInstances&Region=$region&InstanceAlias=InstanceNameNamespace=QCE/CVM&Action=DescribeInstances&Region=$region&display=${InstanceId}-${InstanceName}
如果同时存在 InstanceAlias 和 display 字段，则仅会展示 display 的值。
若在使用过程中遇到任何问题，您可以在此创建 issue，或者扫码添加 云监控插件@Grafana 使用交流QQ群，我们将竭诚为您服务！
| QQ 群 (861359693) |
|---|
 |
感谢这些可爱的人对此项目的热爱 (emoji key):
 heriky 💻 |
 jamesxwang 💻 📖 |
 leonlysu 💻 |
 smallpath 💻 |
 susiezhao 💻 |
 taoran34 💻 |
 Cloudlie 💻🐛 |
 woson-wang 🐛 |
该项目遵循 all-contributors 规范。 欢迎任何形式的贡献！
欢迎大家参与到 腾讯云监控插件 @ Grafana 的开发工作，贡献一份力量！
您可以选择如下的贡献方式：
我们会将您加入 我们的贡献者名单；
贡献方式请参考 贡献指南 文档。
腾讯云监控应用插件在 Apache License 2.0 许可证下提供。