metadata_cardinality_limit
是 attributes
processor 的一个可选参数,用于限制特定属性的唯一值数量。如果属性中的唯一值超过指定的阈值,则该处理器将截断该属性并添加 _truncated
后缀。
例如,以下配置将设置 trace_id
和 span_id
属性的唯一值数量上限为 1000:
processors:
attributes:
actions:
- key: trace_id
action: HASH
value_hash_config:
hash_seed: 22
algorithm: MURMUR_HASH_2
metadata:
metadata_cardinality_limit: 1000
- key: span_id
action: HASH
value_hash_config:
hash_seed: 22
algorithm: MURMUR_HASH_2
metadata:
metadata_cardinality_limit: 1000
当某个属性中包含超过 1000 个不同的值时,处理器会在原始属性名称后面添加 _truncated
后缀,并保存少量示例。这有助于避免数据爆炸和性能问题,并保持合理的资源利用率。
需要注意的是,这种截断机制可能会对数据分析造成影响。因此,在使用该功能时应仔细考虑所需的精度和可靠性。