文档中心

应用性能监控全链路版

平台管理配置

参数管理

应用性能监控提供错误阈值、采样率、数据加密等多种工作区维度的参数配置，可根据实际场景配置合适的参数，本文为您详细介绍参数配置方式和适用范围。

注意

部分参数存在自定义配置，此时，工作区维度参数配置的优先级低于自定义配置。例如：参数管理和服务均配置采样规则时，实际以服务自定义配置的采样规则为准。

操作步骤

登录应用性能监控控制台。

在左侧导航栏选择平台管理配置 -> 工作区管理，前往工作区管理页面。

单击目标工作区右侧操作列中的参数管理，根据实际场景配置合适的参数，包括系统配置、探针配置、存储配置、性能剖析相关多项参数配置。

系统配置

目前支持错误阈值配置，单击修改设置，根据实际需求拖动比例条，自定义满意、一般、较差的错误阈值区间，完成后单击保存。

该参数主要影响服务拓扑中的数据统计。

探针配置

数据库慢查询配置

定义慢查询的时间，推荐阈值为 500ms，可单击修改设置，根据实际情况配置，完成后单击保存。

该参数主要影响慢查询的数据统计，例如：中间件监控中的慢查询占比。

采样配置

自定义采样规则的参数配置，单击修改设置，可根据实际情况选择固定采样、错慢采样等，完成后单击保存。要求至少配置一种采样方式，具体生效逻辑如下：

若仅配置固定采样，APMPlus 探针和 apmplus-opentelemetry-collector 探针均生效。

若仅配置错慢采样，APMPlus 探针不生效，apmplus-opentelemetry-collector 探针生效。

若同时配置了固定采样和错慢采样，APMPlus 探针仅生效固定采样相关配置，apmplus-opentelemetry-collector 探针针对两种采样方式均生效，且按顺序依次执行采样策略。

采样方式	说明
固定采样	根据自定义配置的采样率进行 Trace 数据采样。其中，0% 表示丢弃所有 Trace 数据，不进行上报；100% 表示上报所有 Trace 数据，不进行采样。
错慢采样	根据自定义配置的 Trace 耗时阈值下限和错误采样规则进行数据上报，匹配到错慢采样规则的所有 Trace 数据将被上报。说明错慢采样的耗时依据为 Trace 总耗时，并非 Span 耗时。数值配置时，需要针对一个完整调用链路耗时的区间值进行配置。若开启错慢采样，Trace 耗时阈值下限和错误采样至少启用一项。若开启错慢采样且同时配置 Trace 耗时阈值下限和错误采样，满足任一规则的 Trace 数据均被上报。

该参数主要影响采样数据，例如：Trace 分析中的采样数据来源。

接口配置

接口相关配置，单击修改设置，可根据实际情况配置 Path 收敛、RPC 服务接口列表、无效接口调用过滤、HTTP 状态码白名单，完成后单击保存。

注意

变更 Path 收敛或 RPC 服务接口列表配置后，历史数据将无法通过新的 Resource 值做筛选查询，请谨慎操作。

Path 收敛

启用后，HTTP 服务的接口名称将根据实际 URL 的默认 URL 收敛规则生成。收敛原理是保留有意义路径信息的同时，将路径中的数字 ID 替换为通配符“？”，实现相对路径的聚合。

注意

仅对作为 Server 调用的 HTTP 服务生效。

最大长度默认为 24 字符，支持按账号进行修改。若需要修改最大长度，请联系官方技术支持获取帮助。

默认 URL 收敛规则和示例如下：

若 URL 中不存在数字，将保留原字符串。例如：/api/health-check 经过 Path 收敛后依然为 /api/health-check。

若 URL 中存在数字且字段长度为 2~3 字符，以 v 或 V 开头的版本号保留原字符串；包含数字但非版本号的部分，将全部替换为通配符“？”。例如：/v1/items/123 经过 Path 收敛后显示为 /v1/items/?。

若 URL 中存在数字且字段长度为 4~最大长度，将包含数字的部分替换为通配符“？”。例如：/api/users/name-456/details 经过 Path 收敛后显示为 /api/users/?/details。

若 URL 中存在数字且字段长度超过最大长度，将包含数字的部分替换为通配符“？”。例如：/api/very-long-resource-name-1234567890 经过 Path 收敛后显示为 /api/?。

RPC 服务接口列表

RPC 服务相关接口名称的赋值来源，根据实际情况选择方法级别或服务方法级别，默认为方法级别。

方法级别：Resource 字段由 rpc.method 赋值。

服务方法级别：Resource 字段由 rpc.service + rpc.method 赋值。

该参数主要影响 RPC 服务在接口监控中的接口名称。

无效接口调用过滤

针对无需记录观测数据的接口，可将其设置为无效接口。配置生效后，无效接口将不再上报 Trace 数据，对应指标统计也会忽略该接口数据，包括 Span 以及指标统计。

影响数据：接口对应的所有指标、Span 均被忽略。

影响功能：服务总览、接口监控、上游调用、下游调用等页面对应接口的所有指标，Trace 分析页面的 Span 数量及相关指标告警。

HTTP 状态码白名单

默认情况下，HTTP 状态码大于等于 400 则被归类为错误调用。若不希望某类状态码被归类为错误，可根据实际需求配置 HTTP 状态码白名单，配置生效后，白名单 HTTP 状态码将在 RED 指标和错误统计中定义为正确。

影响数据：HTTP 服务端/客户端的错误数指标、Span 状态。

影响功能：服务总览、Trace 分析、Span 状态等。

数据上报

数据上报相关配置，包括：指标数据上报、日志数据上报、链路数据上报。默认开启，可根据实际需求开启或关闭。

日志配置管理

日志服务的全局开关，默认开启，可根据实际需求开启或关闭。

警告

关闭日志服务，将同时删除历史写入的日志数据和日志主题，删除后不可恢复，请谨慎操作。

存储配置

目前支持数据加密配置，单击修改设置，根据实际需求选择合适的加密方式，完成后单击保存。

该参数主要影响 APMPlus 服务端存储在日志服务中的 Trace 数据，提供服务密钥（SSE-TLS）、用户密钥（SSE-KMS）两种加密方式，详细说明如下：

警告

根据实际场景选择其中一种加密方式进行数据加密配置，加密方式选定后不支持修改，仅支持启用或禁用，请谨慎选择。更多使用限制和配置说明参见：数据加密。

若主密钥被删除或禁用，用户密钥亦会随之失效，将导致 APMPlus 服务端存储在日志服务中的 Trace 数据读写失败。因此，务必确保密钥可用且处于启用状态。

加密方式	说明
服务密钥（SSE-TLS）	日志服务自带的默认加密方式，无需额外配置，加密使用环节可实现无感知体验。适用于快速部署数据加密、无需自管密钥（由服务商管理），且需密钥长期有效稳定的场景。说明此加密方式免费使用，不产生计费。
用户密钥（SSE-KMS）	通过密钥管理服务（KMS）生成的密钥，提供安全的密钥存储、密钥生成、加密操作以及密钥轮换功能。具备全生命周期控制性和主动化管理属性，适用于需自主管理密钥，满足安全合规要求的场景，以及需定期审计权限，降低密钥泄露风险的场景。说明 KMS 服务免费开通，但使用 KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，由 KMS 收取。详情请参考 KMS 计费说明。若使用此加密方式，需提前创建用户主密钥并获取密钥 ID，详情请参见：密钥管理快速入门、自带密钥。

性能剖析

开启常态化 CPU 剖析开关后，支持对指定服务和 Pod 采集 CPU 性能指标数据并在基础监控中创建性能剖析任务，相关操作请参见性能剖析。

注意

开启该开关前，请确保待采集服务所在的 VKE 集群的 apmplus-opentelemetry-collector 组件升级至 V3.2.0，并已开启 DaemonSet 部署，具体操作请参考升级组件和 apmplus-opentelemetry-collector。

常态化 CPU 剖析会产生额外资源开销，请按需开启。

关闭后，系统将停止采集 CPU 剖析数据，无法创建新的性能剖析任务。

最近更新时间：2026.07.10 16:08:31

这个页面对您有帮助吗？

有用

无用