文档中心

应用性能监控全链路版

使用指南

生产指标

应用性能监控支持基于生产指标规则，聚合指定应用集群范围内的原始数据，动态生成高价值指标，解决系统偶发错误难以捕捉量化、特定业务场景体验数据无法长期追踪的困扰。此外，还可将生成的指标数据快速接入自定义看板进行可视化监控，或配置告警规则实现异常情况秒级感知，快速从源头化解监控盲区。本文为您介绍如何通过原始数据生产指标。

前提条件

容器集群已经安装最新版本的 apmplus-opentelemetry-collector 组件，并能够正常采集数据。组件相关详细说明参见：安装组件、升级组件。

使用限制

生产指标功能仅针对 apmplus-opentelemetry-collector 组件采集的数据生效。

目前支持使用日志数据和链路数据生产指标。

操作步骤

使用日志数据生产指标

使用链路数据生产指标

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

搜索目标服务，单击服务名称，前往目标服务的管理页面。

在左侧导航栏选择生产指标，前往生产指标管理页面。

单击创建生产指标规则，参考以下说明配置信息，完成后单击确定。

基本信息：配置生产指标的基本信息和用于生产指标的原始数据来源，例如：使用 SDK 上报的日志数据生成指标。

配置项	说明
规则名称	自定义规则名称。
应用集群	用于生成指标的原始数据来源集群，默认所有集群。所有集群：勾选全选。当前及后续安装 apmplus-opentelemetry-collector 组件的所有集群，将应用生产指标规则。指定集群：勾选目标集群，支持多选。仅被选中的集群，应用生产指标规则。
数据来源	用于生成指标的原始数据来源，当前场景选择日志。
数据范围	用于生产指标的数据范围，目前支持 SDK 上报。例如：将安装 apmplus-opentelemetry-collector 组件的集群中，通过 SDK 上报的日志数据用于生产指标。
过滤条件	通过配置的 SDK 过滤规则，筛选用于生成指标的原始数据。例如：日志提供日志内容、服务名、日志级别筛选项。说明支持配置多条过滤规则，多条规则间按“与”逻辑生效，即保留满足所有过滤规则的数据。同一条过滤规则中的操作符支持“包含”、“不包含”。同一条过滤规则中支持配置多个值，多个值间按“或”逻辑生效。

数据加工：对满足基础信息配置的原始数据进行加工，以提取符合生产指标的字段。

配置项	说明
字段提取	单击添加字段，配置字段提取规则和字段相关信息。将原始数据加工成符合生产指标的字段。
提取规则	提取原始数据的规则，采用三元组形式。其中，N 表示左边界位置，L 表示左边界标识、R 表示右边界标识，左右边界中间的内容即为提取结果。说明不支持提取中文。 N 从 0 开始计数，即 0 表示第一个，1 表示第二个，以此类推。【参考示例】：假设原始日志内容为 INFO 2025-01-02 03:04:05 ETC station=X-station lsn=A00001 cost=10s 。当提取规则为 (0, "", " ") 时，表示提取从首位到下一个空格间的内容，提取结果为 INFO。当提取规则为 (0, " ", " ") 时，表示提取从第 1 个空格到下一个空格间的内容，提取结果为 2025-01-02。当提取规则为 (2, " ", " ") 时，表示提取第 2 个空格到下一个空格间的内容，提取结果为 ETC。当提取规则为 (0, "station=", " ") 时，表示提取第 1 个 station= 到下一个空格间的内容，提取结果为 X-station。当提取规则为 (0, "lsn=", " ") 时，表示提取第 1 个 lsn= 到下一个空格间的内容，提取结果为 A00001。当提取规则为 (0, "cost=", "") 时，表示提取第 1 个 cost= 到末尾的内容，提取结果为 10s。
字段预览	根据数据范围填充一条测试数据，将按照提取规则自动高亮提取字段，预览提取结果。单击重新获取样本，支持重新获取一条测试数据。单击编辑预览样例，支持自定义填充测试数据。说明不支持提取中文。推荐填充 5 条数据进行提取结果预览。仅当日志数据已经上报到应用性能监控时，才能获取预览样本，否则样本内容为空。
字段名称	自定义提取规则的名称。同一配置中，字段名称不允许重复。
白名单	配置白名单过滤提取字段，默认关闭。若启用，将根据配置的白名单过滤提取字段，当提取数据值范围过大时，保留白名单命中值，缩减数据处理范围。
值翻译	配置字段值的翻译规则，默认关闭。若开启，将根据配置的翻译规则，对提取的字段值进行翻译或映射，翻译后字段值类型为 String。若启用字段值翻译，需要自定义配置以下参数：值类型：根据实际场景，添加数值或字符串类型的翻译规则。允许添加多条翻译规则，允许不同类型的翻译规则并存。缺省值：未匹配到翻译规则时的默认填充规则。若缺省值为空，将不翻译未匹配到翻译规则的值；若缺省值不为空，将对未匹配到上述任意翻译规则的值，填充缺省值。注意开启字段值翻译后，该字段值将替换为翻译后的值。此时，若使用该字段进行数据过滤，过滤条件应该使用翻译后的值而不是原始上报的值。

数据过滤：对数据加工后的数据进行过滤，进一步筛选满足生成指标条件的数据，目前提供白名单和黑名单筛选。

说明

同一名单内的过滤规则按“或”逻辑生效。

不同名单间按“与”逻辑生效。

配置项	说明
白名单	被允许的数据列表，保留符合条件的数据。支持按 Key-Values 过滤、按关键字过滤配置白名单规则。
黑名单	不被允许的数据列表，丢弃符合黑名单条件的数据。支持按 Key-Values 过滤、按关键字过滤配置黑名单规则。

指标定义：通过指标类型、基础信息、标签维度、聚合周期定义指标的生成规则，实现对源数据的标准化聚合统计和维度拆分。

配置项	说明
指标类型	生成指标的类型，目前支持简单指标。
指标定义	指标基本信息和指标附加信息，例如：指标名称、单位、来源、聚合方式等。指标名称：自定义指标名称，其中，由日志生成的指标默认以 log_metric_ 开头。聚合方式：指标数据的聚合方式，根据实际情况选择，目前支持：COUNT、AVG、SUM、MIN、MAX、PCT50、PCT75、PCT90 等。过滤条件：根据指标名称进行指标过滤，支持配置多条过滤规则，多条规则间按“与”逻辑生效。来源字段：COUNT 之外的聚合方式需要标注指标来源字段，以记录指标来源。单位：根据实际情况选择指标单位。
标签字段	指标统计聚合维度，慎重使用可以改变的标签字段。注意配置标签字段时需要注意以下情况：禁止配置重复的 TagKey，否则无法保证数据准确性。尽量精简 Tags，推荐只配置业务关注的信息。 TagKey 必须是可枚举的，否则 Tags 上报时会导致序列数爆炸。例如：类似 ID 这类会不断增长的属性，不推荐配置为标签字段。不建议使用 UUID、带参数的 URL。不建议使用 Timestamp，Metrics 等，否则，系统会为序列记录时间戳。 Metrics 具有维度限制，当 TagKV 组合数过多时会导致维度爆炸，多余数据将被丢弃。
聚合周期	根据实际情况，选择指标聚合周期。

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

搜索目标服务，单击服务名称，前往目标服务的管理页面。

在左侧导航栏选择生产指标，前往生产指标管理页面。

单击创建生产指标规则，参考以下说明配置信息，完成后单击确定。

基本信息：配置生产指标的基本信息和用于生产指标的原始数据来源，例如：使用链路 Span 数据生成指标。

配置项	说明
规则名称	自定义规则名称。
应用集群	用于生成指标的原始数据来源集群，默认所有集群。所有集群：勾选全选。当前及后续安装 apmplus-opentelemetry-collector 组件的所有集群，将应用生产指标规则。指定集群：勾选目标集群，支持多选。仅被选中的集群，应用生产指标规则。
数据来源	用于生成指标的原始数据来源，当前场景选择链路。
数据范围	用于生产指标的数据范围，目前支持链路 Span 数据。
过滤条件	通过配置的 Span 过滤规则，筛选用于生成指标的原始数据。例如：Span 类型、服务名、接口名、Span 操作名、状态码、下游服务名、下游服务类型、下游接口名、是否属于 AI 应用。说明支持配置多条过滤规则，多条规则间按“与”逻辑生效，即保留满足所有过滤规则的数据。同一条过滤规则中的操作符支持“包含”、“不包含”。同一条过滤规则中支持配置多个值，多个值间按“或”逻辑生效。

数据加工：对满足基础信息配置的原始数据进行加工，以提取符合生产指标的字段。

配置项	说明
字段提取	单击添加字段，配置字段提取规则和字段相关信息。将原始数据加工成符合生产指标的字段。
样本预览	根据数据范围填充一条测试数据，将按照提取规则自动高亮提取字段，预览提取结果。单击查看链路，支持跳转到 Trace 分析页面，查看原始链路数据。单击重新获取样本，支持重新获取一条测试数据。单击编辑样本，支持自定义填充测试数据。说明仅当链路数据已经上报到应用性能监控时，才能获取预览样本，否则样本内容为空。
提取规则	提取原始数据的规则，支持全部提取和部分提取。其中，部分提取采用正则形式，支持两种配置方式：注意部分提取时，仅支持通过正则规则从原字段值中提取 1 个值，目前不支持同时提取多个值。自定义输入正则规则。在样本预览区域框选需要提取的部分，自动生成正则规则。
字段名称	自定义提取规则的名称。同一配置中，字段名称不允许重复。
白名单	配置白名单过滤提取字段，默认关闭。若启用，将根据配置的白名单过滤提取字段，当提取数据值范围过大时，保留白名单命中值，缩减数据处理范围。
值翻译	配置字段值的翻译规则，默认关闭。若启用，将根据配置的翻译规则，对提取的字段值进行翻译或映射，翻译后字段值类型为 String。若启用字段值翻译，需要自定义配置以下参数：值类型：根据实际场景，添加数值或字符串类型的翻译规则。允许添加多条翻译规则，允许不同类型的翻译规则并存。缺省值：未匹配到翻译规则时的默认填充规则。若缺省值为空，将不翻译未匹配到翻译规则的值；若缺省值不为空，将对未匹配到上述任意翻译规则的值，填充缺省值。注意开启字段值翻译后，该字段值将替换为翻译后的值。此时，若使用该字段进行数据过滤，过滤条件应该使用翻译后的值而不是原始上报的值。

数据过滤：对数据加工后的数据进行过滤，进一步筛选满足生成指标条件的数据，目前提供白名单和黑名单筛选。

说明

同一名单内的过滤规则按“或”逻辑生效。

不同名单间按“与”逻辑生效。

配置项	说明
白名单	被允许的数据列表，保留符合条件的数据。支持按 Key-Values 过滤配置白名单规则。
黑名单	不被允许的数据列表，丢弃符合黑名单条件的数据。支持按 Key-Values 过滤配置黑名单规则。

指标定义：通过指标类型、基础信息、标签维度、聚合周期定义指标的生成规则，实现对源数据的标准化聚合统计和维度拆分。

配置项	说明
指标类型	生成指标的类型，目前支持简单指标。
指标定义	指标基本信息和指标附加信息，例如：指标名称、单位、来源、聚合方式等。指标名称：自定义指标名称，其中，由链路生成的指标默认以 trace_metric_ 开头。聚合方式：指标数据的聚合方式，根据实际情况选择，目前支持：COUNT、AVG、SUM、MIN、MAX、PCT50、PCT75、PCT90 等。过滤条件：根据指标名称进行指标过滤，支持配置多条过滤规则，多条规则间按“与”逻辑生效。来源字段：COUNT 之外的聚合方式需要标注指标来源字段，以记录指标来源。单位：根据实际情况选择指标单位。
标签字段	指标统计聚合维度，慎重使用可以改变的标签字段。注意配置标签字段时需要注意以下情况：禁止配置重复的 TagKey，否则无法保证数据准确性。尽量精简 Tags，推荐只配置业务关注的信息。 TagKey 必须是可枚举的，否则 Tags 上报时会导致序列数爆炸。例如：类似 ID 这类会不断增长的属性，不推荐配置为标签字段。不建议使用 UUID、带参数的 URL。不建议使用 Timestamp，Metrics 等，否则，系统会为序列记录时间戳。 Metrics 具有维度限制，当 TagKV 组合数过多时会导致维度爆炸，多余数据将被丢弃。
聚合周期	根据实际情况，选择指标聚合周期。

后续操作

查看指标趋势

生产指标规则下发成功，并正常生产指标后，可前往生产指标规则详情页的指标趋势页签，预览已经生成指标的趋势信息。

若使用日志数据生成指标，单击日志分析，可跳转到日志查询页面，查看更多详细信息。

若使用链路数据生成指标，单击链路分析，可跳转到 Trace 分析页面，查看更多详细信息。

配置自定义看板

前往自定义看板，可使用生成的指标制作可观测看板。自定义看板相关详细说明参见：快速使用自定义看板。

配置告警

前往告警任务，可使用生成的指标配置监控告警。告警任务相关详细说明参见：创建告警任务。

指标规则管理

针对已经创建的生产指标规则，提供以下管理操作。

操作项	说明
下发指标规则	创建生产指标规则或编辑已有生产指标规则后，将自动触发指标规则下发流程，下发成功即可正常生产指标。说明指标规则的下发状态遵循异步更新逻辑，最长 5 分钟更新一次。
启用/禁用	启用或禁用生产指标规则。启用后开始根据规则生产指标，禁用将停止生产指标。
编辑	编辑目标生产指标规则，完成后重新下发，下发成功后将根据新规则生产指标。
复制	复制目标生产指标规则，快速创建新的规则。
删除	删除不再需要的生产指标规则，删除后不再生产指标，历史生产的指标不受影响。

最近更新时间：2026.03.19 15:40:05

这个页面对您有帮助吗？

有用

无用