OTEL Collector中PostgreSQL接收器无效问题及解决咨询

报错信息 #

Error: failed to get config: cannot unmarshal the configuration: 1 error(s) decoding:

• error decoding 'receivers': unknown type: "postgresql" for id: "postgresql" (valid values: [jaeger kafka opencensus prometheus zipkin otlp hostmetrics])
  2024/03/13 08:50:44 collector server run finished with error: failed to get config: cannot unmarshal the configuration: 1 error(s) decoding:
• error decoding 'receivers': unknown type: "postgresql" for id: "postgresql" (valid values: [jaeger kafka opencensus prometheus zipkin otlp hostmetrics])

疑问点 #

为什么PostgreSQL在OTEL Collector里不是有效的接收器类型？官方文档示例配置明明用了"postgresql"作为接收器名称。

官方示例配置 #

receivers:
  postgresql:
    endpoint: localhost:5432
    transport: tcp
    username: otel
    password: ${env:POSTGRESQL_PASSWORD}
    databases:
      - otel
    collection_interval: 10s
    tls:
      insecure: false
      insecure_skip_verify: false
      ca_file: /home/otel/authorities.crt
      cert_file: /home/otel/mypostgrescert.crt
      key_file: /home/otel/mypostgreskey.key

用户当前配置 #

已满足前置条件（拥有具备SELECT on pg_stat_database权限的用户），接收器配置如下：

postgresql:
  username: otel
  password: otel
  collection_interval: 5s
  tls:
    insecure: true

修复方案 #

核心原因 #

PostgreSQL接收器属于OTEL Collector扩展版（Contrib）的组件，你当前使用的是OTEL Collector核心版，核心版默认仅包含报错信息里列出的基础接收器类型，不包含PostgreSQL这类扩展组件。

具体解决步骤 #

1. 切换至Contrib版本Collector

   • 下载并使用opentelemetry-collector-contrib版本（而非核心版otelcol），该版本内置所有扩展接收器。
   • 容器部署时，替换镜像为otel/opentelemetry-collector-contrib:latest（或指定对应版本）。

2. 补全配置结构
   你的配置缺少顶层receivers键，正确结构如下：

   receivers:
     postgresql:
       username: otel
       password: otel
       collection_interval: 5s
       tls:
         insecure: true
       # 补充必填的endpoint参数，避免后续连接失败
       endpoint: "localhost:5432"
   

3. 将接收器加入服务管道
   需在service模块中把postgresql接收器加入指标采集管道：

   service:
     pipelines:
       metrics:
         receivers: [postgresql]
         # 补充对应输出器（如prometheus、otlp等）配置
   

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