文档 Grafana Alloy 参考 组件 otelcol otelcol.receiver.influxdb

otelcol.receiver.influxdb

otelcol.receiver.influxdb 接收 InfluxDB 指标，将其转换为 OpenTelemetry (OTEL) 格式，并通过网络将其转发到其他 otelcol.* 组件。

您可以通过为多个 otelcol.receiver.influxdb 组件赋予不同的标签来指定它们。

用法

alloy 复制

otelcol.receiver.influxdb "influxdb_metrics" {
  endpoint = "localhost:8086"  // InfluxDB metrics ingestion endpoint

  output {
    metrics = [...]
  }
}

参数

otelcol.receiver.influxdb 支持以下参数

默认情况下，otelcol.receiver.influxdb 监听 localhost 上的 HTTP 连接。要将 HTTP 服务器暴露给网络上的其他机器，请使用要监听的 IP 地址配置 endpoint，或使用 0.0.0.0:8086 监听所有网络接口。

块

otelcol.receiver.influxdb 的定义中支持以下块

tls 块

tls 块配置用于服务器的 TLS 设置。如果未提供 tls 块，则不会对服务器的连接使用 TLS。

支持以下参数

如果 reload_interval 设置为 "0s"，则证书永远不会重新加载。

以下参数对互斥，不能同时设置

• ca_pem 和 ca_file
• cert_pem 和 cert_file
• key_pem 和 key_file

如果 cipher_suites 留空，则使用安全的默认列表。有关支持的密码套件列表，请参阅 Go Cipher Suites 文档。

client_ca_file 将 TLSConfig 中的 ClientCA 和 ClientAuth 设置为 RequireAndVerifyClientCert。有关更多信息，请参阅 Go TLS 文档。

cors 块

cors 块配置 HTTP 服务器的 CORS 设置。

支持以下参数

allowed_headers 参数指定从 CORS 请求中可以接受哪些标头。以下标头始终是隐式允许的

• Accept
• Accept-Language
• Content-Type
• Content-Language

如果 allowed_headers 包含 "*"，则允许所有标头。

debug_metrics 块

debug_metrics 块配置此组件生成的用于监控其状态的指标。

支持以下参数

disable_high_cardinality_metrics 是 Grafana Alloy 中 telemetry.disableHighCardinalityMetrics 功能门禁的等效项。它会删除可能导致高基数指标的属性。例如，删除了有关 HTTP 和 gRPC 连接的指标中包含 IP 地址和端口号的属性。

level 是 Alloy 中 telemetry.metrics.level 功能门禁的等效项。可能的值为 "none"、"basic"、"normal" 和 "detailed"。

output 块

output 块配置一组组件，用于将生成的遥测数据转发到这些组件。

支持以下参数

您必须指定 output 块，但其所有参数都是可选的。默认情况下，遥测数据将被丢弃。请相应地配置 metrics、logs 和 traces 参数，以便将遥测数据发送到其他组件。

导出的字段

otelcol.receiver.influxdb 不导出任何字段。

组件健康状况

仅当 otelcol.receiver.influxdb 配置无效时，才会被报告为不健康。

调试信息

otelcol.receiver.influxdb 不公开任何组件特定的调试信息。

示例

此示例将接收到的遥测数据通过批处理器转发，然后最终将其发送到支持 OTLP 的端点

alloy 复制

otelcol.receiver.influxdb "influxdb_metrics" {
  output {
    metrics = [otelcol.processor.batch.default.input]
  }
}

otelcol.processor.batch "default" {
  output {
    metrics = [otelcol.exporter.otlp.default.input]
  }
}

otelcol.exporter.otlp "default" {
  client {
    endpoint = sys.env("OTLP_ENDPOINT")
  }
}

此示例将接收到的遥测数据转发到 Prometheus Remote Write (Mimir)

alloy 复制

otelcol.receiver.influxdb "influxdb_metrics" {
  output {
    metrics = [otelcol.exporter.prometheus.influx_output.input]  // Forward metrics to Prometheus exporter
  }
}

otelcol.exporter.prometheus "influx_output" {
  forward_to = [prometheus.remote_write.mimir.receiver]  // Forward metrics to Prometheus remote write (Mimir)
}

prometheus.remote_write "mimir" {
  endpoint {
    url = "https://prometheus-xxx.grafana.net/api/prom/push"

    basic_auth {
      username = "xxxxx"
      password = "xxxx=="
    }
  }
}

启用身份验证

您可以创建一个 otelcol.receiver.influxdb 组件，该组件需要对请求进行身份验证。这对于限制谁可以将数据推送到服务器非常有用。

alloy 复制

otelcol.receiver.influxdb "influxdb_metrics" {
  output {
    metrics = [...]
  }
  auth = otelcol.auth.basic.creds.handler
}

otelcol.auth.basic "creds" {
    username = sys.env("USERNAME")
    password = sys.env("PASSWORD")
}

兼容组件

otelcol.receiver.influxdb 可以接受来自以下组件的参数

• 导出 OpenTelemetry otelcol.Consumer 的组件