一、操作场景
注意:说明:
二、操作步骤
1. 登录 Prometheus 控制台。
2. 在实例列表中,选择并进入对应的 Prometheus 实例。
3. 在实例详情页,选择数据采集 > 集成中心。
4. 在集成中心单击云监控,默认进入安装页面。配置基本信息、选择对应的云产品,并进行 Exporter 配置。
三、配置说明
| 参数 | 说明 |
| 名称 | 集成名称,命名规范如下:名称具有唯一性。名称需要符合下面的正则:'^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$'。 |
| 地域 | 必填,云产品所在地域。如果云产品不区分地域,则填写任意地域。支持地域(例如:广州)和腾讯云标准地域(例如:ap-guangzhou)两种地域命名格式,不同地域命名格式仅指标采集的地域 Label 值不同,用户可根据使用场景选择其中一种地域格式。 |
| 云产品选择 | 勾选想要采集的云产品。 |
| 数据拉取配置 | 单位为秒。若设置为0,将忽略原始数据的时间戳;若设置大于0,将上报原始数据的时间戳,由于云产品监控数据上报到基础监控存在一定的延迟,该延迟将会体现在最新的数据上。拉取数据范围:(当前时间 – 数据采集延迟 – 固定的时间间隔, 当前时间 – 数据采集延迟)。 |
| 实例刷新间隔 | 单位为分钟,最小值为10。每隔一个实例刷新间隔,集成会重新拉取云产品实例信息。如果修改了实例名、云标签或者增删实例,会在一个实例刷新间隔内更新监控数据。 |
| 实例 ID 过滤 | 选填。不填默认采集主账号下所有实例的数据。键值对形式填写,键是集成定义的云产品 唯一 ID,值是逗号分隔的云产品实例 ID。填写键值对的云产品,只会采集填写的实例。 |
| 云标签过滤 | 选填。键值对形式填写,一个标签键可以对应多个标签值,以 | 分隔。不同的标签键取交集,同一标签键下的多个标签值取并集。对于支持云标签过滤的产品,如果同时配置了实例 ID 过滤,该产品的云标签过滤将不会生效。 |
| 云标签键替换 | 选填。将不合法的云产品标签键替换为合法值,例如将中文名转换成自定义的英文名。 |
| 云标签键操作 | 集成默认将标签键的大写字母转换成下划线+小写字母。支持对云产品标签键的转换操作:ToUnderLineAndLower:默认操作。ToLower:表示全转成小写字母。NoOperation:表示不做转换。 |
| 额外实例信息 | 添加额外的实例信息。Project:添加项目 ID 和项目名称标签,只有部分云产品支持。MetricAliasName:添加指标中文名标签。cvm:OsName:云服务器指标添加操作系统名称标签。cvm:InstanceType:云服务器指标添加机型标签。cbs:InstanceName:云硬盘指标添加云服务器实例名称标签。ti_model:TokenName:TI-ONE(在线服务)Token 维度添加 Token 名称标签。cynosdb_mysql:InstanceRole:TDSQL-C MySQL 版指标添加实例角色标签。postgres:DBInstanceCpu:数据库 PostgreSQL 指标添加实例 cpu 标签。private_link:EndPointVip:私有连接指标添加终端节点 VIP 标签。private_link:ServiceVip:私有连接指标添加终端节点服务 VIP 标签。 |
| 维度开白 | 选填。部分云产品的维度存在指标名称相同、功能需要开白等问题,默认不采集,可通过该配置开启采集。lb_public:listener:负载均衡(公网)-监听器维度。lb_public:target:负载均衡(公网)-后端服务器维度。lb_public:domain:负载均衡(公网)-转发规则域名维度。lb_private:listener:负载均衡(内网)-监听器维度。lb_private:target:负载均衡(内网)-后端服务器维度。lb_private:domain:负载均衡(内网)-转发规则域名维度。apigw_cloudnative:node:云原生 API 网关-节点维度。apigw_cloudnative:service:云原生 API 网关-服务维度。apigw_cloudnative:route:云原生 API 网关-路由维度。scf_v2:version:云函数-版本维度。vbc:qosid:云联网-调度队列维度。ces:node:Elasticsearch-节点维度。 |
| 标签 | 选填。可以给集成采集到的指标添加额外的自定义标签。 |
| 跨账号采集 | 开启后可填写 跨账号采集 配置。关于授权策略信息请参见 云监控集成跨账号采集授权策略。本账号角色:自定义角色,用于获取本账号临时密钥。目标账号角色:自定义角色,用于获取目标账号临时密钥。目标账号 uin:目标账号的主账号 ID。 |
| 资源规格 | 底层 Pod 资源规格。可以通过 资源占用 查看 cpu/内存使用率。 |
| 抓取间隔 | 最小1分钟。因为监控数据粒度是1分钟,低于1分钟的抓取间隔没有意义。填写示例:60s、1m30s、5m、1h30m。 |
| 抓取超时 | 抓取超时必须小于等于抓取间隔。填写方式同抓取间隔。 |
| Metric Relabel 配置 | 选填。兼容 Prometheus 原生的 metric_relabel_configs 和 Prometheus Operator 原生的 metricRelabelings 配置。不可混用。 |
四、Metric Relabel 配置示例
下面是常用的 metric_relabel_configs 示例:
metric_relabel_configs:- action: labeldrop # 去掉名为 labelA 的 label。regex是正则表达式,多个正则表达式用 | 分隔 regex: labelA- regex: ins-(.*) # 新增一个名为 id 的 label,其值通过名为 instance_id 的 label 的值经过正则处理后得到。例如 instance_id="ins-a",新得到的 id="a" replacement: $1 source_labels: – instance_id target_label: id- target_label: region # 新增一个 region="ap-guangzhou" 的 label replacement: ap-guangzhou- action: drop # 去掉名为 metricA 或 metricB 的指标 source_labels: – __name__ regex: metricA|metricB
五、支持的云产品
| 云产品/指标文档 | 是否支持采集云标签 | 唯一 ID | 补充说明 |
| 云服务器 | 是 | cvm | 仅支持实例维度指标。 |
| 云服务器(内网) | 是 | sdn_vm | – |
| 云硬盘 | 是 | cbs | – |
| 负载均衡(公网) | 是 | lb_public | 默认采集实例维度指标,如需监听器、转发规则域名或后端服务器维度指标,请自行添加维度开白配置。不同维度的指标名相同,可以通过 monitor_view 标签来区分维度:实例维度:instance;监听器维度:listener;后端服务器维度:target;转发规则域名维度:domain。 |
| 负载均衡(内网) | 是 | lb_private | 默认采集实例维度指标,如需监听器或转发规则域名维度指标,请自行添加维度开白配置。不同维度的指标名相同,可以通过 monitor_view 标签来区分维度:实例维度:instance;监听器维度:listener;后端服务器维度:target;转发规则域名维度:domain。 |
| 负载均衡(四层独占集群) | 是 | tgw_set | 该产品是负载均衡开白产品,指标随时可能变化,不提供对外指标文档。 |
| 负载均衡(七层独占集群) | 是 | tgw_set_l7 | 该产品是负载均衡开白产品,指标随时可能变化,不提供对外指标文档。 |
| 云数据库 MongoDB | 是 | cmongo | – |
| 云数据库 MySQL(CDB) | 是 | cdb | – |
| 云数据库 Redis(CKV 版) | 是 | redis | – |
| 云数据库 Redis(内存版) | 是 | redis_mem | 支持实例维度和节点维度指标。 |
| 云数据库 Tendis | 是 | tendis | – |
| CTSDB(InfluxDB 版) | 是 | xstor | 该产品是 CTSDB 开白产品,指标随时可能变化,不提供对外指标文档。 |
| 云数据库 MariaDB | 是 | mariadb | 仅支持实例维度指标。 |
| 云数据库 PostgreSQL | 是 | postgres | – |
| TDSQL MySQL 版 | 是 | tdmysql | 仅支持实例维度指标。 |
| TDSQL TDStore 引擎版 | 是 | tdstore | – |
| TDSQL-C MySQL 版 | 是 | cynosdb_mysql | 仅支持实例维度指标。 |
| 云数据库 SQL Server | 是 | sqlserver | – |
| 云数据库 KeeWiDB | 是 | keewidb | – |
| 向量数据库 | 是 | vecdb | – |
| NAT 网关 | 是 | nat_gateway | – |
| NAT 实例监控丢包率 | 是 | vpc_gw_detect | NAT 网关指标。 |
| 消息队列 CKafka 版 | 是 | ckafka | – |
| 消息队列 Pulsar 版 | 是 | tdmq_pulsar | – |
| 消息队列 RocketMQ 版 | 是 | rocketmq | 指标文档和唯一 ID 对应新指标,使用旧指标的用户建议尽快切换。 |
| 消息队列 RabbitMQ 版 | 是 | rabbitmq | – |
| 消息队列 RabbitMQ Serverless 版 | 是 | amqp | – |
| 消息队列 MQTT 版 | 是 | mqtt | – |
| 弹性公网 IP | 是 | lb | – |
| VPN 网关 | 是 | vpngw | – |
| VPN 通道 | 是 | vpnx | – |
| 网络探测 | 是 | vpc_net_detect | – |
| 私有网络-跨可用区流量 | 是 | sdn_az | 指标不支持1分钟粒度,默认拉取5分钟粒度数据。 |
| 私有网络-私有连接 | 是 | private_link | – |
| 网络性能大盘-地域内 | 是 | vpc_fullmesh_zone | 私有网络-网络性能大盘。 |
| 网络性能大盘-地域间 | 是 | vpc_detect_fullmesh_region | 私有网络-网络性能大盘。 |
| CDN(中国境内域名) | 是 | cdn | 不区分地域。仅支持域名维度指标。 |
| CDN(中国境外域名) | 是 | ov_cdn | 不区分地域。 |
| COS | 是 | cos | 存储相关指标延迟过高(2小时左右),不会保留数据的原始时间戳。存储相关指标不支持1分钟粒度,默认拉取5分钟粒度数据。 |
| 专线接入-物理专线 | 是 | dc | 不区分地域。 |
| 专线接入-专用通道 | 是 | dcx | 不区分地域。 |
| 专线接入-专线网关 | 是 | dcg | 同私有网络/网络连接/专线网关。 |
| 轻量应用服务器 | 是 | lighthouse | – |
| 云原生 API 网关 | 是 | apigw_cloudnative | 默认采集实例维度和公网负载均衡维度指标,如需节点、服务、路由维度指标,请自行添加维度开白配置。实例维度与节点维度的指标名相同、与服务/路由维度的请求监控指标名相同,可以通过 monitor_view 标签来区分维度:实例维度:gateway;公网负载均衡维度:loadbalancer;节点维度:node;服务维度:service;路由维度:route。 |
| Nacos | 是 | nacos | – |
| Zookeeper | 是 | zookeeper | – |
| Elasticsearch | 是 | ces | 默认采集实例维度指标,如需节点维度指标,请自行添加维度开白配置。可以通过 monitor_view 标签来区分维度:实例维度:instance;节点维度:node。 |
| Elasticsearch Logstash | 是 | logstash | – |
| 流计算 Oceanus | 是 | tstream | 需要在 流计算控制台 > 成员管理中将服务角色 CM_QCSLinkedRoleInTMP 设为访客角色。 |
| 数据湖计算 DLC | 是 | dlc | 支持内部存储桶、Spark 引擎、Presto 引擎、网关 ID、Spark 作业、引擎维度指标。可以通过 monitor_view 标签来区分维度:内部存储桶:bucketSpark 引擎:spark_enginePresto 引擎:presto_engine网关 ID:gatewaySpark 作业:spark_job引擎(包括 Spark 和 Presto 引擎):engine |
| 腾讯云数据仓库 TCHouse-C | 是 | cdwch | – |
| 腾讯云数据仓库 TCHouse-D | 是 | cdwdrs | – |
| 数据传输服务 | 是 | dts | 不支持 Kafka 相关维度指标。 |
| 云联网 | 是 | vbc | 如需调度队列维度指标,请自行添加维度开白配置。 |
| 全球应用加速 | 是 | gaap | – |
| 全球加速2.0 | 不支持标签 | ga2 | 中国站地域选择广州;国际站地域选择新加坡。 |
| EdgeOne(七层) | 是 | edgeone_l7 | 仅支持【站点】、【子域名-站点】维度指标。 |
| EdgeOne(四层) | 是 | edgeone_l4 | – |
| Web 应用防火墙 | 是 | waf | – |
| 文件存储 | 是 | cfs | 目前未采集元数据、快照相关指标。 |
| 数据加速器 GooseFS | 是 | goosefs | – |
| 数据加速器 GooseFSx | 是 | goosefsx | – |
| 共享带宽包 | 是 | bwp | – |
| 云函数 | 是 | scf_v2 | 默认采集别名维度指标,如需版本维度指标,请自行添加维度开白配置。别名维度与版本维度的指标名相同,可以通过 monitor_view 标签来区分维度:别名维度:alias。版本维度:version。 |
| 云点播(VOD) | 是 | vod | 不区分地域。目前 FluxHitRate、RequestsHitRate、BackOriginBandwidth、BackOriginFlux 四个指标未对外,无法采集。 |
| 云直播(CSS) | 是 | live | 不区分地域。仅支持域名维度的 Bandwidth、Flux、Online、Request 四个指标。 |
| 云直播 MCDN | 是 | xmcdn | 不区分地域。 |
| 日志服务(CLS)-日志主题 | 是 | cls | – |
| 数据万象 | 是 | ci | – |
| API 网关 | 是 | apigateway | 仅支持 API 维度指标。 |
| TI-ONE(任务式建模) | 是 | ti_traintask | – |
| TI-ONE(Notebook) | 是 | ti_notebook | – |
| TI-ONE(在线服务) | 是 | ti_model | – |
| TI-ONE(资源组) | 是 | ti_resource | – |
| 大模型服务平台 TokenHub | 是 | token_hub | – |
| Prometheus | 是 | prometheus | 仅支持实例维度指标。 |
注意:说明:
注意:为了区分不同云产品的指标,云监控集成对云产品指标名(指标文档中的指标英文名)做了转换。指标页中提供了云监控集成支持采集的指标信息,方便用户直接查看和使用。
注意:
六、跨账号采集
注意:不支持跨站采集(国内站账号与国际站账号不能互相采集)。
场景:账号 A 跨账号采集账号 B 的监控数据。
配置填写:
·在账号 A 下的 Prometheus 监控服务实例中创建云监控集成。
·开启跨账号采集。
·本账号角色选择账号 A 创建的自定义角色。
·目标账号角色填入账号 B 创建的自定义角色。
·目标账号 uin 填入账号 B 的主账号 ID。
八、自定义角色
下文以云服务器(cvm)作为角色载体,设置预设策略 ReadOnlyAccess 为例进行介绍,更多关于授权策略信息请参见 云监控集成跨账号采集授权策略。
九、账号 A 创建自定义角色
1. 在 策略 页面,通过策略语法创建 自定义策略,添加 sts:AssumeRole 权限,该权限用于扮演账号 B 的角色。策略语法如下:
{ "version": "2.0", "statement": [ { "effect": "allow", "action": ["sts:AssumeRole"], "resource": ["*"] } ]}
注意:如果需要限制权限,例如只能扮演账号 B 的自定义角色,可以将 resource 修改为 "qcs::cam::uin/[账号 B 主账号 ID]:roleName/[账号 B 自定义角色]"。
2. 在 角色 列表页面,单击新建角色。
3. 在弹出的选择角色载体窗口,选择腾讯云产品服务,进入角色信息填写页面。
4. 勾选云服务器(cvm)作为角色载体,使用案例选择云服务器,单击下一步。
5. 在策略列表内,勾选第1步创建的策略为角色配置策略,单击下一步。
6. 标记角色的标签键和标签值,可不填,单击下一步。
7. 输入你的角色名称,单击完成后即可完成自定义角色创建。
十、账号 B 创建自定义角色
1. 在角色列表页面,单击新建角色。
2. 在弹出的选择角色载体信息窗口,选择腾讯云账户作为角色载体,进入角色信息填写页面。
3. 在输入角色载体信息页面,云账号类型选择其他主账号,账号 ID 填写账号 A 主账号 ID,其它可不填,单击下一步。
4. 在策略列表内,勾选预设策略 ReadOnlyAccess 为角色配置策略,单击下一步。
5. 标记角色的标签键和标签值,可不填,单击下一步。
6. 输入你的角色名称,单击完成后即完成自定义角色创建。
十二、前提条件
Prometheus 实例已绑定 Grafana 实例。
十三、操作步骤
1. 登录 Prometheus 监控服务控制台,选择对应 Prometheus 实例进入管理页面。
2. 选择数据采集 > 集成中心,在集成中心页面,找到并单击云监控,选择 Grafana > Grafana Dashboard 操作下的安装/升级 Grafana Dashboard,单击安装/升级可安装对应的 Grafana Dashboard。
3. 选择已集成,在已集成列表中单击 Grafana 图标即可自动打开云监控集成大盘列表,选择对应云产品大盘,查看实例相关的监控数据:
21、更新动态
云监控集成每次保存,都会将集成更新为最新版本。下面是集成每次版本更新的主要时间节点与内容,可以用来评估集成更新的影响。
| 时间 | 更新内容 |
| 2026年8月 | 支持 TI-ONE(资源组);消息队列 MQTT 版支持共享订阅、TLS Alerts 维度指标。 |
| 2026年7月 | 支持云服务器 RDMA 新机型 HCCGC50se;云硬盘 project 标签优化;集成更新后,云硬盘指标会产生新时间线。 |
| 2026年5月 | 支持 Elasticsearch Logstash;GooseFSx fileset 视图。 |
| 2026年4月 | 支持云服务器 RDMA 机型(HCCPNV6e、HCCPNV5b、HCCSA4、HCCPNV6se、GC88)。 |
| 2026年3月 | 消息队列 RabbitMQ 版支持节点下 Vhost、队列、交换机维度指标;支持腾讯云数据仓库 TCHouse-D 存算分离集群。 |
| 2026年2月 | 支持网络性能大盘-地域内、网络性能大盘-地域间;云原生 API 网关支持服务、路由维度指标;COS 支持内网跨地域采集;消息队列 RabbitMQ 版支持 Vhost、队列、交换机维度指标。 |
| 2026年1月 | TI-ONE 支持多空间实例;消息队列 CKafka 版支持实例资源、Broker IP 维度指标。 |
| 2025年12月 | 支持数据加速器 GooseFS、云直播 MCDN;EdgeOne(七层)支持站点维度指标。 |
| 2025年11月 | 支持 EdgeOne(四层)、Prometheus;数据加速器 GooseFSx 支持用户、节点维度指标;TDSQL-C MySQL 版支持分析引擎相关指标。 |
| 2025年10月 | 支持消息队列 RabbitMQ Serverless 版。 |
| 2025年9月 | 支持云直播;云数据库 MySQL(CDB)支持只读分析引擎维度指标。 |
| 2025年8月 | 支持 TDSQL TDStore 引擎版;云数据库 SQL Server 支持地域维度指标;网络探测支持采集云标签和云标签过滤;TI-ONE 新增 cpu、memory 等标签;最小粒度是5分钟粒度的指标,新增 tcop_period 标签。指标名变更(集成更新后生效):qce_apigw_cloudnative_sysrecvnettraffic_sum -> qce_apigw_cloudnative_sysrecvnettraffic_maxqce_apigw_cloudnative_syssendnettraffic_sum -> qce_apigw_cloudnative_syssendnettraffic_maxqce_mqtt_mqttconnectlimitedcount_count -> qce_mqtt_mqttconnectlimitedcount_sumqce_lb_private_reqavg_avg -> qce_lb_private_reqavg_exprqce_lb_private_rspavg_avg -> qce_lb_private_rspavg_exprqce_lb_public_reqavg_avg -> qce_lb_public_reqavg_exprqce_lb_public_rspavg_avg -> qce_lb_public_rspavg_expr注意:集成更新后,TI-ONE 指标、COS 5分钟粒度指标、云数据库 SQL Server 5分钟粒度指标会产生新时间线;指标名变更涉及云原生 API 网关、消息队列 MQTT 版、负载均衡(公网/内网)。 |
| 2025年7月 | 支持全球加速2.0;云函数新增异步请求相关指标;支持通过额外实例信息配置添加指标中文名标签。 |
| 2025年6月 | 修复消息队列 RocketMQ 版在特殊情况下不采集部分 topic 监控数据的问题;向量数据库新增集群相关指标。 |
| 2025年5月 | Elasticsearch 支持节点维度指标,新增标签 monitor_view;TI-ONE 新增 gpu、gpu_type、app_id、sub_uin、sub_uin_name 标签。注意:gpu 表示 GPU 卡资源,单位为1单位的 gpu_type;gpu_type 表示 GPU 类型;集成更新后, Elasticsearch 和 TI-ONE 指标会产生新时间线。 |
| 2025年4月 | 支持数据湖计算 DLC、数据加速器 GooseFSx;负载均衡(内网)支持后端服务器维度、清理重复标签 vpcid、loadbalancerid、loadbalancerport;云服务器新增标签 gpu_type,仅影响 GPU 云服务器。注意:gpu_type 表示 GPU 类型,存量 GPU 云服务器实例更新后会产生新时间线;集成更新后,负载均衡(内网)指标会产生新时间线。 |
| 2025年3月 | 支持 NAT 实例监控丢包率;云服务器支持 HCCPNV6e、HCCPNV5b、HCCSA4机型的 vRDMA 指标;云联网支持网络实例维度。 |
| 2025年2月 | 云数据库 Tendis 新增标签 node_zone_id。注意:node_zone_id 表示节点可用区 ID;集成更新后,云数据库 Tendis 指标会产生新时间线。 |
| 2025年1月 | 支持数据万象、消息队列 MQTT 版;文件存储支持 Turbo 文件系统指标。注意:文件系统新增标签 protocol,表示文件系统协议;集成更新后,文件存储指标会产生新时间线。 |
| 2024年12月 | 云联网支持服务等级维度和调度队列维度。 |
| 2024年11月 | 支持流计算 Oceanus、腾讯云数据仓库 TCHouse-C。 |
| 2024年10月 | 云数据库 MongoDB 支持 mongos 节点维度。 |
| 2024年9月 | 支持向量数据库;云产品全量支持采集云标签和云标签过滤;支持跨账号采集;负载均衡支持转发规则域名维度。 |
| 2024年8月 | 支持私有网络-跨可用区流量、私有网络-私有连接;COS 支持5分钟粒度的存储相关指标;TDSQL-C MySQL 版支持集群 ID 过滤。 |
| 2024年7月 | 支持消息队列 Pulsar 版;云函数支持版本维度。注意:云函数新增固定标签 monitor_view;集成更新后,云函数指标会产生新时间线。 |
| 2024年6月 | 支持负载均衡(七层独占集群)、腾讯云数据仓库 TCHouse-D、云服务器(内网);负载均衡(内网)支持监听器维度;云原生 API 网关支持公网负载均衡维度。注意:负载均衡(内网)新增固定标签 monitor_view;集成更新后,负载均衡(内网)指标会产生新时间线。 |
| 2024年5月 | 支持云数据库 KeeWiDB;负载均衡(公网)支持后端服务器维度。 |
| 2024年3月 | 支持云原生 API 网关、消息队列 RabbitMQ 版、EdgeOne(七层);支持配置云标签键替换和云标签键转换规则。 |
| 2023年12月 | 支持消息队列 RocketMQ 版 v5、CTSDB(InfluxDB 版)、TI-ONE、云数据库 Tendis、弹性公网 IPv6。 |
| 2023年11月 | 支持网络探测;负载均衡(公网)支持监听器维度、云数据库 MySQL 支持代理节点维度。 |
| 2023年9月 | 支持日志服务、API 网关、负载均衡(四层独占集群)。 |
| 2023年8月 | 支持 CDN(国外域名)、云点播、云函数(别名)、消息队列 RocketMQ 版。 |
| 2023年7月 | 支持采集域名型负载均衡(公网);支持采集 TDSQL-C MySQL 版云标签。 |
| 2023年6月 | 支持共享带宽包。云数据库 Redis(内存版)Redis 节点维度添加节点类型标签。 |
| 2023年5月 | 支持采集消息队列 CKafka 版云标签。 |
| 2023年4月 | 支持文件存储。 |
| 2023年3月 | 支持云硬盘。 |
| 2023年2月 | 支持负载均衡(内网)、Web 应用防火墙。 |
| 2022年11月 | 支持全球应用加速、云联网、数据传输服务。 |
| 2022年9月 | 支持专线网关;支持采集云产品标签。 |
| 2022年7月 | 支持 Zookeeper、Nacos、COS、CDN(国内域名)。 |
| 2022年6月 | 云监控集成上线。 |