模板变量 Variables 是 Grafana 提供的一种 Dashboard 优化特性，用于创建高度可复用和交互式 Dashboard。模板变量的一般思想是允许 Grafana 从数据源获得不同的度量，并提供一种无需修改仪表板就可以动态更改它的方法。云产品监控数据源插件目前提供了地域、实例变量的支持。

配置和应用变量

在 dashboard 仪表盘，单击右上角设置图标。

在左侧菜单栏，单击 varibles，然后单击 New variable。

设置查询变量。变量书写规则，请参见变量书写规则。

预览查看效果。

数据源 query 设置输入框中输入 ${varname} 来使用变量。其中 varname 和变量 Name 保持一致即可应用。

变量书写规则

变量查询语句整体数据格式为JSON，目前支持地域、项目、实例、Period 四种类型。

变量类型	是否支持多选	写法
地域类型	仅支持单选	{"type": "region"}
项目类型	仅支持单选	{"type":"projectName"}
实例类型	支持单选和多选	{ // type固定为intance "type": "instance", // 必填参数 namespace为各个云产品实际的namespace变量，具体见附录表格，region 为地域参数，可以为特定的地域值，如 cn-beijing；也可以为变量值，如例子中的 ${region}。projectName同理，用于筛选不同project下的实例，可以不设置该变量，如不设置projectName表示默认从所有project下筛选实例。 "params": {"namespace":"VCM_ECS", "region": "${region}", "projectName":"${projectName}" }, // 可选参数，为相应产品实例以什么维度筛选。不填时为当前产品ID "field": "Status" }
period类型	仅支持单选	{"type":"period"}

以云服务器为例，介绍变量配置的具体写法和返回示例。

操作	写法	返回
获取当前账号下所有云服务器实例ID	{ "type": "instance", "params": { "namespace": "VCM_ECS", "region": "${region}" } }
获取云服务器所有状态	{ "type": "instance", "params": { "namespace": "${namespace}", "region": "${region}" }, "field": "Status" }

云产品支持的筛选项

云产品名称	NameSpace	支持的筛选项
应用型负载均衡	VCM_ALB	Name(实例名称),Id(实例ID),VpcID(私有网络 ID),PrivateIP(私网 IP)
Anycast公网IP	VCM_AnycastEIP	Name(实例名称),Id(实例ID),AnycastEipAddress(Anycast公网IP)
云原生消息引擎	VCM_BMQ	Name(集群名称 ),Id(集群ID),Status(集群状态)
共享带宽包	VCM_BandwidthPackage	Name(实例名称),Id(实例ID),Protocol(协议类型)
ByteHouse 云数仓版	VCM_ByteHouse	Name(Instance Name),Id(Id),Status(Status)
ByteHouse 企业版	VCM_ByteHouse_Ce	Name(集群名称),Id(实例ID),Status(集群状态),Zone(可用区),Specification(集群规格)
ByteHouse 云数仓版 - 数据导入	VCM_ByteHouse_DataLoading	Name(Name),Id(Id),Status(Status)
内容分发网络	VCM_CDN	ServiceType(业务类型),Status(状态)
云企业网	VCM_CEN	Name(实例名称),Id(实例ID)
大数据文件存储	VCM_CFS	Name(集群名称 ),CacheCapacityTiB(缓存容量 (TiB))
负载均衡	VCM_CLB	Name(实例名称),Id(实例ID),VpcID(私有网络 ID),PrivateIP(私网 IP)
负载均衡独占集群	VCM_CLB_EC	Name(实例名称),Id(实例ID)
云连接器	VCM_CloudConnector	Name(实例名称),Id(实例ID)
配置中心-Etcd	VCM_ConfigCenter_Etcd	Name(实例名称),Id(实例Id)
配置中心-Zookeeper	VCM_ConfigCenter_ZooKeeper	Name(实例名称),Id(实例Id)
DCDN	VCM_DCDN	Name(加速域名)
数据库传输服务 DTS	VCM_DTS	Name(任务名称),Id(任务 ID),TaskType(任务类型),Status(任务状态)
全域数据集成	VCM_DataSail	Name(作业名称&作业ID),Id(作业ID),Project(项目名称),Status(作业状态),UpdateTime(更新时间),CreateTime(创建时间),Version(指标类型版本)
全域数据集成-采集Topic	VCM_DataSail_Topic	Name(Topic名称),Id(Id),采集类型(采集类型),状态(状态)
专线连接-物理专线	VCM_DirectConnectConnection	Name(实例名称),Id(实例ID)
专线连接-专线网关	VCM_DirectConnectGateway	Name(实例名称),Id(实例ID)
专线连接-虚拟接口	VCM_DirectConnectVIF	Name(实例名称),Id(实例ID),DirectConnectGatewayId(专线网关ID),DirectConnectConnectionId(物理专线ID),RouteType(路由方式)
弹性块存储	VCM_EBS	Id(ID),Name(名称),Status(状态),VolumeType(规格),Kind(类型)
云服务器	VCM_ECS	Id(ID),Name(名称),Status(状态),IP.Inside(私网)
公网IP	VCM_EIP	Name(实例名称),Id(实例ID),EipAddress(公网IP)
E-MapReduce	VCM_EMR	Name(集群名称),Id(集群ID),Status(集群状态),ClusterType(集群类型),PayType(付费类型)
E-MapReduce StarRocks	VCM_EMR_StarRocks	Name(实例名称),Id(实例ID),Type(实例类型),Version(实例版本)
云搜索服务	VCM_ESCloud	Name(实例名称),Id(实例ID)
网际快车	VCM_Fasttrack	Name(实例名称),Id(实例ID)
文件存储 NAS 极速型	VCM_FileNAS	Name(实例名称),Id(实例ID),Status(状态),ProtocolType(协议类型)
流式计算 Flink 版	VCM_Flink	Id(作业ID),Name(作业名字),State(作业状态)
全球加速	VCM_GA	Name(名称),Id(加速器Id)
表格数据库 HBase 版	VCM_HBase	Name(实例名称),Id(实例ID),Status(状态),ZoneId(可用区),EngineVersion(版本)
IPsec连接	VCM_IPsec	Id(IPsec连接ID),AttachType(绑定资源类型)
互联网通道-公网带宽	VCM_InternetTunnelBandwidth	Name(实例名称),Id(实例ID),ISP(线路类型)
互联网通道虚拟接口	VCM_InternetTunnelVirtualInterface	Name(实例名称),Id(实例ID),Status(状态)
IPv6公网带宽	VCM_Ipv6AddressBandwidth	Name(IPv6地址),Id(实例ID)
IPv6网关	VCM_Ipv6Gateway	Name(实例),Id(实例ID),Status(状态)
消息队列Kafka版	VCM_Kafka	Id(实例Id),Name(实例名称)
湖仓一体分析服务	VCM_LAS	Name(作业名称/ID),JobState(作业状态),JobType(作业类型),QueueName(运行队列)
文档数据库 MongoDB 版-副本集	VCM_MongoDB_Replica	Id(实例Id),Name(实例名称),Status(实例状态)
文档数据库 MongoDB 版-分片集	VCM_MongoDB_Sharded_Cluster	Id(实例Id),Name(实例名称),Status(实例状态)
云数据库 MySQL Sharding 版	VCM_MySQL_Sharding	Name(实例名称),Id(实例Id),Status(实例状态),Zone(地域)
NAT网关	VCM_NAT	Name(实例名称),Id(实例ID)
NAT64网关	VCM_NAT64	Name(实例名称),Id(实例ID),Status(状态),Spec(规格)
私网连接-终端节点	VCM_PrivateLinkEndpoint	Id(终端节点ID),Name(名称),Status(状态),VPC(私有网络)
私网连接-终端节点服务	VCM_PrivateLinkEndpointService	Name(实例名称),Id(实例ID)
私网NAT网关	VCM_PrivateNAT	Name(实例名称),Id(实例ID)
云数据库 MySQL 版	VCM_RDS_MySQL	Id(实例Id),Name(实例名称),Status(实例状态),InstanceType(实例类型),InstanceSubCategory(InstanceSubCategory)
云数据库 PostgreSQL 版	VCM_RDS_PostgreSQL	Name(实例名称),Id(实例ID),Status(实例状态),InstanceType(实例类型),Zone(地域),DeployType(部署版本),ReadWriteSplitting(读写分离标识)
云数据库 RDS SQL Server 版	VCM_RDS_SQLServer	Name(实例名称),Id(实例Id),Status(实例状态),InstanceSpecStr(实例规格),InstanceType(实例类型)
消息队列 RabbitMQ版	VCM_RabbitMQ	Id(实例Id),Name(实例名称)
缓存数据库 Redis 版	VCM_Redis	Id(实例ID),Name(实例名称),Status(状态),EngineVersion(版本)
消息队列RocketMQ版	VCM_RocketMQ	Id(实例Id),Name(实例名称),Status(状态)
边缘联网 SD-WAN	VCM_SDWAN	Name(名称),Id(ID),Status(状态),Location(部署位置)
半托管文件缓存 SFCS	VCM_SFCS	Name(集群名称 )
批式计算 Spark 版	VCM_Spark	Name(作业id & 作业名字),state(作业状态)
日志服务	VCM_TLS	Name(日志项目名称),Id(日志项目id)
对象存储	VCM_TOS	Name(存储桶名称),Id(存储桶名称)
TrafficRoute-云解析DNS	VCM_TrafficRoute_DNS	Name(域名),DnsStatus(DNS状态),Version(功能版本)
TrafficRoute-私网解析PrivateZone	VCM_TrafficRoute_PrivateZone	Name(域名)
中转路由器	VCM_TransitRouter	Name(实例名称),Id(ID)
中转路由器带宽包	VCM_TransitRouterBandwidthPackage	Name(名称),Id(ID)
边缘计算-边缘智能	VCM_VEI	Name(项目名称)
视频点播	VCM_VOD	Name(空间名)
视频点播-CDN	VCM_VODCDN	Id(域名)
VPN连接	VCM_VPN	Name(网关名字),Id(网关ID)
向量数据库	VCM_VikingDB	Id(实例ID),Status(实例状态)
云数据库 veDB MySQL 版	VCM_veDB_MySQL	Name(实例名称),Id(实例ID),Status(实例状态),NodeClass(实例规格)
函数服务	VCM_veFaaS	Name(函数名称),Id(函数 Id),Runtime(函数运行时)
文件存储 NAS 通用型	VCM_veFileNAS	Name(实例名称),Id(实例ID),Status(状态),ZoneId(可用区),ProtocolType(协议类型),CreateTime(创建时间)
文件存储 NAS 缓存型	VCM_veFileNAS_Cache	Name(实例名称),Id(实例ID),Status(状态),ProtocolType(协议类型)
图数据库 veGraph	VCM_veGraph_db	Name(实例名称),Id(实例ID),Status(实例状态)
veImageX	VCM_veImageX	-
文件存储 vePFS	VCM_vePFS	Name(实例名称),Id(实例ID),StoreType(规格)

云监控