菜单
文档breadcrumb arrow Grafana Alloybreadcrumb arrow 参考breadcrumb arrow 组件breadcrumb arrow otelcolbreadcrumb arrow 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 支持以下参数

名称类型描述默认值必需
endpointstring监听流量的 host:port 地址。"localhost:8086"
max_request_body_sizestring服务器允许的最大请求体大小。20MiB
include_metadataboolean将传入连接元数据传播到下游消费者。
compression_algorithmslist(string)服务器可以接受的压缩算法列表。["", "gzip", "zstd", "zlib", "snappy", "deflate", "lz4"]
authcapsule(otelcol.Handler)用于认证请求的 otelcol.auth 组件的处理程序。

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

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

层级描述必需
tlstls配置 HTTP 服务器的 TLS。
corscors配置 HTTP 服务器的 CORS。
debug_metricsdebug_metrics配置此组件生成的指标。
outputoutput配置接收到的指标发送到何处。

tls 块

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

支持以下参数

名称类型描述默认值必需
ca_filestringCA 文件的路径。
ca_pemstring用于验证服务器的 CA PEM 编码文本。
cert_filestringTLS 证书的路径。
cert_pemstring用于客户端身份验证的证书 PEM 编码文本。
include_system_ca_certs_poolboolean是否在证书颁发机构之外加载系统证书颁发机构池。false
key_filestringTLS 证书密钥的路径。
key_pemsecret用于客户端身份验证的密钥 PEM 编码文本。
max_versionstring连接允许的最大 TLS 版本。"TLS 1.3"
min_versionstring连接允许的最小 TLS 版本。"TLS 1.2"
cipher_suiteslist(string)TLS 传输层可以使用的 TLS 密码套件列表。[]
reload_intervalduration证书重新加载的间隔时长。"0s"
client_ca_filestring服务器用于验证客户端证书的 TLS 证书路径。
curve_preferenceslist(string)握手过程中使用的椭圆曲线集合。[]

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

以下参数对是互斥的,不能同时设置

  • ca_pemca_file
  • cert_pemcert_file
  • key_pemkey_file

如果 cipher_suites 留空,将使用安全的默认列表。请参阅 Go 密码套件文档以获取支持的密码套件列表。

client_ca_fileTLSConfig 中将 ClientCAClientAuth 设置为 RequireAndVerifyClientCert。有关更多信息,请参阅 Go TLS 文档。

curve_preferences 参数决定了在握手期间按优先顺序使用的椭圆曲线集合。如果未提供,则使用默认列表。可用的椭圆曲线集合包括 X25519P521P256P384

cors 块

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

支持以下参数

名称类型描述默认值必需
allowed_originslist(string)允许的 Origin 头部值。
allowed_headerslist(string)CORS 请求接受的头部。["X-Requested-With"]
max_agenumber配置 Access-Control-Max-Age

allowed_headers 参数指定了 CORS 请求中哪些头部是可接受的。以下头部总是隐式允许的

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

如果 allowed_headers 包含 "*",则允许所有头部。

debug_metrics 块

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

支持以下参数

名称类型描述默认值必需
disable_high_cardinality_metricsboolean是否禁用某些高基数指标。true

disable_high_cardinality_metrics 是 Grafana Alloy 中等同于 OpenTelemetry Collector 中 telemetry.disableHighCardinalityMetrics 功能开关的参数。它移除了可能导致高基数指标的属性。例如,HTTP 和 gRPC 连接指标中包含 IP 地址和端口号的属性会被移除。

注意

如果配置了 disable_high_cardinality_metrics,它仅适用于 otelcol.exporter.*otelcol.receiver.* 组件。

output 块

output 块配置一组组件来转发产生的遥测数据。

支持以下参数

名称类型描述默认值必需
logslist(otelcol.Consumer)发送日志的消费者列表。[]
metricslist(otelcol.Consumer)发送指标的消费者列表。[]
traceslist(otelcol.Consumer)发送跟踪的消费者列表。[]

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

导出的字段

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 组件。这对于限制谁可以将数据推送到服务器非常有用。

注意

并非所有 OpenTelemetry Collector 身份验证插件都支持接收器身份验证。请参阅每个 otelcol.auth.* 组件的文档以确定其兼容性。

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 的组件

注意

连接某些组件可能不合理,或者组件可能需要进一步配置才能使连接正常工作。有关更多详细信息,请参阅链接的文档。