GCP Cloud Logging结构化日志Trace相关字段被移除：原因排查求助

你遇到的logging.googleapis.com/trace、logging.googleapis.com/spanId、logging.googleapis.com/labels字段被移除、无法关联Trace ID的问题，可能由以下几个原因导致：

• 字段放置位置错误：google.cloud.logging库对Trace相关的特殊字段有特定处理逻辑，这些字段不能放在jsonPayload的顶层结构里。如果直接把它们塞进自定义的logging_payload字典中作为普通JSON字段发送，Logging Agent会将其视为无效的自定义字段并过滤。正确的做法是在调用日志记录方法（如log_struct）时，将这些字段作为独立参数传入（比如trace=、span_id=、labels=），由库自动处理到正确的位置。

• Trace ID格式不符合要求：GCP要求Trace ID必须是projects/[你的项目ID]/traces/[Trace ID字符串]的完整格式。如果只填写了Trace ID本身而缺少项目前缀，Logging Agent无法识别这个字段的合法性，会直接丢弃。

• Logging Agent配置过滤：如果使用了Ops Agent或Fluentd作为Logging Agent，检查其配置文件是否存在自定义过滤规则，误将这些logging.googleapis.com/前缀的字段移除。比如某些过滤插件可能会过滤掉带有特定前缀的字段，或者配置了字段白名单导致这些字段未被保留。

• 客户端库版本过旧：旧版本的google-cloud-logging库对Trace关联字段的处理逻辑不完善，可能会在发送时自动过滤掉这些字段。尝试升级到最新稳定版的库，再测试是否能正常保留字段。

内容的提问来源于stack exchange，提问作者David Radianu