Tencent Cloud Observability Platform
- 动态与公告
- 产品公告
- 购买指南
- Prometheus 监控服务
- 按量付费（后付费）
- 快速入门
- 云产品监控
- 云产品监控指标
- 微服务工具与平台
- 云上网络
- 关系型数据库
- 云数据库 Redis
- 边缘计算机器
- CDN 与边缘平台
- 控制台操作指南
- 云监控概况
- 获取监控图表
- 云服务器监控组件
- 应用性能监控
- 接入指南
- 接入 Python 应用
- 接入 PHP 应用
- 控制台操作指南
- 关联日志
- 在日志中注入 TraceID
- 实践教程
- 参考信息
- APM 数据协议标准
- 终端性能监控
- 接入指南
- iOS 应用场景
- 实践教程
- 前端性能监控
- 控制台操作指南
- 云拨测
- 控制台操作指南
- 常见问题
- 云压测
- 控制台操作指南
- 脚本模式压测
- JMeter 模式压测
- 流量录制
- JavaScript API 列表
- pts/http
- Response
- pts/grpc
- pts/jsonpath
- pts/redis
- pts/sql
- pts/url
- URL
- pts/util
- pts/ws
- pts/socketio
- socketio
- pts/socket
- Prometheus 监控
- 接入指南
- EMR 接入
- Java 应用接入
- Exporters 接入
- 控制台操作指南
- 容器监控
- 实践教程
- Terraform
- Grafana 服务
- Dashboard
- 控制台操作指南
- Dashboard 列表
- 告警管理
- 控制台操作指南
- 告警接收
- 事件总线
- 相关协议
- API 文档
- Making API Requests
- Monitoring Data Query APIs
- Alarm APIs
- Notification Template APIs
- Legacy Alert APIs
- Prometheus Service APIs
- Grafana Service APIs
- Event Center APIs
- TencentCloud Managed Service for Prometheus APIs
- Monitoring APIs
APM 指标协议标准
最后更新时间：2025-03-13 15:13:47
本文将阐述应用性能监控 APM 固有指标的协议标准，用户可以通过如下两种方式获取应用性能监控 APM 的固有指标：
通过云 API 查询指标，请参见 DescribeGeneralMetricData 接口文档。
将指标同步到腾讯云 Prometheus 监控服务，请参见 Prometheus 数据集成以及 Dashboard 关联展示。
指标数据结构
指标名称
每种指标都有唯一云 API 指标名称和唯一的 Prometheus 指标名称，分别用于云 API 查询以及同步至 Prometheus 这两种获取 APM 固有指标的方式。
指标视图
APM 的固有指标分包含4个类别，通过4个指标视图进行标识。在云 API 查询场景，需要在
ViewName字段中指定视图名称；在 Prometheus 集成场景，可以忽略视图。视图名称 | 描述 |
service_metric | 统计应用的通用性能表现，例如请求数量、响应时间等。 |
error_metric | 统计链路中的错误数量。 |
sql_metric | 统计应用访问数据库的性能表现，例如 SQL 执行次数、响应时间等。 |
mq_metric | 统计应用访问消息队列的性能表现，例如消息生产的次数、响应时间等。 |
指标维度
每种指标都支持多个维度：在云 API 查询场景，维度用于数据过滤；在 Prometheus 集成场景，维度信息将以 Prometheus 标签（Label）的形式输出到 Prometheus 指标中。
通用维度
云 API 维度名称 | Prometheus 标签名称 | 描述 |
tapm.app.id | tapm_app_id | 云 AppID |
tapm.instance.key | apm_instance | APM 实例 ID |
service.name | apm_service_name | 应用名 |
service.instance | service_instance | 应用实例 |
agent.version | agent_version | 探针版本号 |
service.version | service_version | 应用版本 |
除了通用维度之外，每一种视图下的指标，还支持一系列特有维度。例如 service_metric 视图下的指标支持
span.kind，代表 Span 类型。详情请参见下文。service_metric 视图
指标
云 API 指标名称 | Prometheus 指标名称 | 类型 | 描述 | 单位 | 桶分布 |
request_count | service_request_count | Gauge | 请求数量 | - | - |
error_request_count | service_error_request_count | Gauge | 错误请求数量 | - | - |
duration_avg | service_duration_avg | Gauge | 平均耗时 | ms | - |
duration_max | service_duration_max | Gauge | 最大耗时 | ms | - |
duration_min | service_duration_min | Gauge | 最小耗时 | ms | - |
slow_request_count | service_slow_request_count | Gauge | 慢调用数量(>2000ms) | - | - |
tolerate_request_count | service_tolerate_request_count | Gauge | 容忍调用数量(500 - 2000ms) | - | - |
duration_p50 | service_duration_p50 | Gauge | 耗时 p50 | ms | - |
duration_p90 | service_duration_p90 | Gauge | 耗时 p90 | ms | - |
duration_p95 | service_duration_p95 | Gauge | 耗时 p95 | ms | - |
duration_p99 | service_duration_p99 | Gauge | 耗时 p99 | ms | - |
range_count_duration | 不支持 | Histogram | 耗时分布 | - | 0,1,5,10,50,100,200,300,400,500,600,700,800,900,1000,1500,2000,3000,4000,5000,7000,10000,15000 |
特有维度
云 API 维度名称 | Prometheus 标签名称 | 描述 |
span.kind | span_kind | Span 类型 |
service.component | service_component | 组件类型 |
peer.service | peer_service | 对端应用名 |
peer.operation | peer_operation | 对端接口名 |
peer.filled | peer_filled | APM 处理后的对端应用名 |
operation | operation | 接口名 |
peer.instance | peer_instance | 对端实例 |
status.message | status_message | 请求状态信息 |
status.code | status_code | 请求状态码 |
status_code_xx | status_code_xx | APM 处理后的状态码 |
error.object | error_object | 错误类型 |
namespace | namespace | 命名空间 |
service.view | service_view | 组件视图（枚举值："sql"、"mq"，如果没有则为空） |
k8s.deployment.name | k8s_deployment_name | Kubernetes 负载名 |
k8s.pod.name | k8s_pod_name | Kubernetes Pod 名 |
k8s.namespace.name | k8s_namespace_name | Kubernetes 命名空间 |
k8s.cluster.id | k8s_cluster_id | TKE 集群 ID |
k8s.region | k8s_region | TKE 集群地域 |
k8s.pod.ip | k8s_pod_ip | Kubernetes Pod IP |
k8s.node.ip | k8s_node_ip | Kubernetes 节点 IP |
cvm.region | cvm_region | CVM 地域 |
cvm.instance.id | cvm_instance_id | CVM 实例 ID |
custom_key_1 | custom_key_1 | 自定义维度1 |
custom_key_2 | custom_key_2 | 自定义维度2 |
custom_key_3 | custom_key_3 | 自定义维度3 |
error_metric 视图
指标
云 API 指标名称 | Prometheus 指标名称 | 类型 | 描述 | 单位 |
error_request_count | error_error_request_count | Gauge | 错误请求数 | - |
last_error_occur_time | error_last_error_occur_time | Gauge | 最后错误发生时间 | ms |
特有维度
云 API 维度名称 | Prometheus 标签名称 | 描述 |
service.component | service_component | 组件类型 |
span.kind | span_kind | Span 类型 |
operation | operation | 接口名 |
error.object | error_object | 错误类型 |
peer.service | peer_service | 对端应用名 |
custom_key_1 | custom_key_1 | 自定义维度1 |
custom_key_2 | custom_key_2 | 自定义维度2 |
custom_key_3 | custom_key_3 | 自定义维度3 |
sql_metric 视图
指标
云 API 指标名称 | Prometheus 指标名称 | 类型 | 描述 | 单位 |
duration_avg | sql_duration_avg | Gauge | 平均耗时 | - |
last_error_occur_time | sql_last_error_occur_time | Gauge | 最后错误发生时间 | ms |
error_request_count | sql_error_request_count | Gauge | 错误请求数量 | ms |
request_count | sql_request_count | Gauge | 请求数量 | ms |
slow_sql_count | sql_slow_sql_count | Gauge | 慢 SQL 数量(>2000ms) | - |
特有维度
云 API 维度名称 | Prometheus 标签名称 | 描述 |
service.component | service_component | 组件类型 |
span.kind | span_kind | Span 类型 |
db.statement | db_statement | 执行语句 |
db.instance | db_instance | 数据库的实例地址 |
db.ip | db_ip | IP 地址 |
db.operation | db_operation | 操作类型 |
error.object | error_object | 错误类型 |
db.system | db_system | 数据库类型 |
attack.subtype | attack_subtype | 注入类型 |
attack.symbol | attack_symbol | 注入标记：0 无注入，1 疑似注入 |
attack.level | attack_level | 注入等级：Critical、Important、Moderate、Low、info |
custom_key_1 | custom_key_1 | 自定义维度1 |
custom_key_2 | custom_key_2 | 自定义维度2 |
custom_key_3 | custom_key_3 | 自定义维度3 |
mq_metric 视图
指标
云 API 指标名称 | Prometheus 指标名称 | 类型 | 描述 | 单位 | 桶分布 |
duration_avg | mq_duration_avg | Gauge | 平均耗时 | ms | - |
error_request_count | mq_error_request_count | Gauge | 错误数量 | - | - |
request_count | mq_request_count | Gauge | 请求数 | - | - |
range_count_duration | 不支持 | Histogram | 耗时分布 | - | 0,1,5,10,50,100,200,300,400,500,600,700,800,900,1000,1500,2000,3000 |
特有维度
云 API 维度名称 | Prometheus 标签名称 | 描述 |
component | component | 组件类型 |
span.kind | span_kind | Span 类型 |
peer.service | peer_service | 对端应用名 |
mq.topic | mq_topic | 消息队列 Topic 名称 |
mq.broker | mq_broker | 消息队列的 Broker 地址 |
operation | operation | 接口名 |
status.code | status_code | 请求状态 |
status_code_xx | status_code_xx | APM 处理后的状态码 |
error.object | error_object | 错误类型 |