envoyproxy/envoy

stats: Allow overriding default tag extractors in stats_tags without disabling defaults

Open

#44,373 创建于 2026年4月10日

在 GitHub 查看
 (7 评论) (0 反应) (0 负责人)C++ (5,373 fork)batch import
area/adminarea/statsenhancementhelp wanted

仓库指标

Star
 (27,997 star)
PR 合并指标
 (平均合并 8天) (30 天内合并 303 个 PR)

描述

Title: stats: Allow overriding default tag extractors in stats_tags without disabling defaults

Description: Our Envoy cluster names have evolved significantly over time; however, for metric backwards compatibility, our alt_stat_name (which populates the envoy.cluster_name tag) has remained static. This prevents us from adopting richer metric sets because any change to alt_stat_name immediately changes the resulting envoy.cluster_name tag, breaking downstream dashboards.

Current State: To override a default tag like envoy.cluster_name while keeping other defaults, users must currently set use_all_default_tags: false and manually redefine the entire list of built-in extractors under stats_tags. This is error-prone and creates "configuration drift" as users must manually track and maintain Envoy’s internal default regexes indefinitely.

Proposed Change: I propose allowing entries in stats_tags to take precedence over built-in extractors with the same tag name. This would allow users to provide a single override for envoy.cluster_name while still benefiting from the rest of the default tag suite provided by Envoy.

To maintain backwards compatibility, this behavior could be enabled via a new boolean field in StatsConfig (e.g., allow_default_tag_overrides) or by defining a specific merge strategy for the stats_tags list.

Contribution: I am willing to implement this feature if the maintainers agree with the direction.

[optional Relevant Links:] https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto

贡献者指南