Spring Boot自定义Metrics无法通过OTEL推送到Datadog问题排查

1. 检查OTEL Collector的指标过滤配置 #

OTEL Collector的processor环节常存在默认过滤规则，可能误拦截了自定义指标：

• 查看Collector配置文件（如otel-collector-config.yaml），确认是否有filter处理器设置了仅保留spring.*开头的指标
• 检查metricstransform处理器是否修改或丢弃了自定义指标名称
• 确认exporters.datadog配置中未开启send_metrics: false这类禁用开关

2. 验证自定义指标格式是否符合Datadog规范 #

Datadog对指标命名和标签有明确要求，不符合会被静默丢弃：

• 指标名称避免使用空格、特殊符号（你的storage.download.artifacts格式合规，可临时改为下划线分隔的storage_download_artifacts测试是否是命名兼容问题）
• 标签不能使用Datadog保留关键字，比如host、service等
• 确认自定义指标类型为Datadog支持的计数器（counter）、 gauge、直方图（histogram）

3. 检查Micrometer到OTLP的指标映射完整性 #

Spring Boot的Micrometer OTLP注册表可能存在映射遗漏：

• 确认自定义指标通过MeterRegistry正确注册，比如使用meterRegistry.counter("storage.download.artifacts").increment()而非手动构造实例
• 检查application.yml/application.properties中是否设置了management.metrics.export.otlp相关过滤参数，是否误过滤了自定义指标
• 开启OTLP调试日志，确认自定义指标是否被发送到Collector：

  logging:
    level:
      io.micrometer.otlp: DEBUG
  

4. 排查Datadog侧的接收限制 #

• 检查Datadog指标配额：若自定义指标数量超出当前套餐配额，会被丢弃，可在「组织设置-指标配额」中查看
• 确认service标签配置正确：自定义指标若未关联正确服务，可能被归类到未识别服务，需在指标探索器切换服务查看
• 检查Datadog指标过滤规则：在「指标-管理指标」中确认是否设置了排除自定义指标的规则

5. 绕过OTEL Collector直接推送测试 #

临时改用Micrometer的Datadog注册表直接推送，定位问题环节：

<!-- pom.xml 添加依赖 -->
<dependency>
  <groupId>io.micrometer</groupId>
  <artifactId>micrometer-registry-datadog</artifactId>
</dependency>

# application.yml 配置
management:
  metrics:
    export:
      datadog:
        api-key: YOUR_DATADOG_API_KEY
        enabled: true
        step: 1m

若直接推送能显示，问题出在OTEL Collector到Datadog的环节；若仍不显示，则是自定义指标注册或格式本身的问题。

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