4. Receiver 配置基础：OTLP Receiver、Prometheus Receiver、Host Metrics Receiver 的配置与适用场景

Receiver 是 OpenTelemetry Collector 数据管道的入口，负责接收来自各类数据源的遥测信号。不同的 Receiver 决定了数据采集的协议、格式和适用场景，直接影响 SLI 口径数据的覆盖范围与采集质量。本章聚焦三种最核心的 Receiver：OTLP Receiver、Prometheus Receiver 和 Host Metrics Receiver，从配置语法、参数含义到适用场景进行系统讲解。

4.1 OTLP Receiver：统一协议入口

OTLP Receiver 是 OpenTelemetry 的原生协议接收器，支持 gRPC 和 HTTP 两种传输方式，能够接收来自任何 OTLP 兼容客户端（如 SDK、其他 Collector、Instrumentation Library）的 traces、metrics 和 logs。它是构建统一可观测性数据面的核心组件。

4.1.1 配置示例与参数解析

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
        max_recv_msg_size_mib: 4
        max_concurrent_streams: 100
        tls:
          cert_file: /etc/ssl/certs/collector.crt
          key_file: /etc/ssl/private/collector.key
      http:
        endpoint: 0.0.0.0:4318
        cors:
          allowed_origins:
            - "https://app.example.com"
          allowed_headers:
            - "content-type"
        max_recv_msg_size_mib: 2

4.1.2 适用场景

• 多语言应用接入：Java、Go、Python、Node.js 等 SDK 原生支持 OTLP，适合异构微服务架构的统一数据采集。
• Collector 级联部署：作为上游 Collector 的出口协议，将数据转发至中心 Collector 或后端。
• 高精度 SLI 数据：OTLP 支持 Delta 时间戳和 Explicit Histogram，适合需要精确延迟分布和计数器的 SLI 场景。

4.2 Prometheus Receiver：拉模式指标采集

Prometheus Receiver 采用经典的拉（Pull）模式，定期从配置的目标端点抓取 Prometheus 格式的指标数据。它兼容 Prometheus 生态的 Exporter 和直接暴露 /metrics 端点的应用，是采集基础设施和中间件指标的首选方式。

4.2.1 配置示例与参数解析

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'kubernetes-pods'
          scrape_interval: 30s
          scrape_timeout: 10s
          metrics_path: /metrics
          kubernetes_sd_configs:
            - role: pod
          relabel_configs:
            - source_labels: [__meta_kubernetes_pod_label_app]
              regex: my-service
              action: keep
        - job_name: 'node-exporter'
          scrape_interval: 15s
          static_configs:
            - targets: ['localhost:9100']
              labels:
                env: production

4.2.2 适用场景

• 基础设施监控：Node Exporter、Kubelet、cAdvisor 等系统级指标采集。
• 中间件与数据库：Redis Exporter、MySQL Exporter、Nginx Exporter 等。
• Kubernetes 环境：利用服务发现自动抓取 Pod 和 Service 的指标，适合容器化 SLI 数据采集。
• 已有 Prometheus 生态：无需改造应用，直接复用现有 Exporter 和告警规则。

4.3 Host Metrics Receiver：主机级零配置采集

Host Metrics Receiver 是 Collector 内置的主机指标采集器，无需外部依赖即可从操作系统获取 CPU、内存、磁盘、网络等基础指标。它适用于快速搭建主机级 SLI 监控，特别适合边缘节点和轻量级部署场景。

4.3.1 配置示例与参数解析

receivers:
  hostmetrics:
    collection_interval: 60s
    scrapers:
      cpu:
        metrics:
          system.cpu.utilization:
            enabled: true
      memory:
        metrics:
          system.memory.usage:
            enabled: true
      disk:
        metrics:
          system.disk.io:
            enabled: true
      network:
        metrics:
          system.network.io:
            enabled: true
      load:
        metrics:
          system.cpu.load_average.1m:
            enabled: true
      filesystem:
        metrics:
          system.filesystem.usage:
            enabled: true
      paging:
        enabled: false
      processes:
        enabled: false

4.3.2 适用场景

• 裸机/VM 主机监控：快速获取操作系统基础指标，无需安装 Agent 或 Exporter。
• 边缘节点：资源受限环境下的轻量级采集方案。
• 故障排查辅助：作为 SLI 数据降噪的上下文指标，帮助定位根因。
• 快速原型验证：在 Collector 部署初期快速建立主机级可观测性基线。

4.4 三种 Receiver 对比与选型建议