文档

Grafana Alloy

参考

组件

otelcol

otelcol.receiver.datadog

开源

实验性

otelcol接收器.datadog

实验性：这是一个实验性组件。实验性组件可能会经历频繁的破坏性更改，并且可能会在没有等效替代品的情况下被删除。要使用该组件，必须将 stability.level 标志设置为 experimental。

otelcol.receiver.datadog 接收通过网络发送的 Datadog 指标和跟踪，并将其转发到其他 otelcol.* 组件。

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

使用方法

otelcol.receiver.datadog "LABEL" {
  output {
    metrics = [...]
    traces  = [...]
  }
}

参数

otelcol.receiver.datadog 支持以下参数

名称	类型	描述	默认值	必需
`endpoint`	`字符串`	监听流量的 `host:port`	`"localhost:8126"`	否
`max_request_body_size`	`字符串`	服务器将允许的最大请求体大小。	`20MiB`	否
`include_metadata`	`布尔值`	将传入连接元数据传播到下游消费者。	`false`	否
`read_timeout`	`持续时间`	HTTP服务器的请求超时读取。	`"60s"`	否
`compression_algorithms`	`list(string)`	服务器可以接受的压缩算法列表。	`["", "gzip", "zstd", "zlib", "snappy", "deflate", "lz4"]`	否

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

块

以下块在otelcol.receiver.datadog的定义内部受支持

层次结构	块	描述	必需
tls	tls	配置HTTP服务器的TLS。	否
cors	cors	配置HTTP服务器的CORS。	否
debug_metrics	debug_metrics	配置此组件生成的指标以监控其状态。	否
output	output	配置将接收到的跟踪发送到何处。	yes

tls块

tls块配置服务器使用的TLS设置。如果没有提供tls块，则不会使用TLS连接到服务器。

以下参数受支持

名称	类型	描述	默认值	必需
`ca_file`	`字符串`	CA文件路径。		否
`ca_pem`	`字符串`	用于验证服务器的CA PEM编码文本。		否
`cert_file`	`字符串`	TLS证书路径。		否
`cert_pem`	`字符串`	客户端身份验证的证书PEM编码文本。		否
`include_system_ca_certs_pool`	`布尔值`	是否加载证书颁发机构及其证书颁发机构池。	`false`	否
`key_file`	`字符串`	TLS证书密钥路径。		否
`key_pem`	`secret`	客户端身份验证的密钥PEM编码文本。		否
`max_version`	`字符串`	连接可接受的TLS最大版本。	`"TLS 1.3"`	否
`min_version`	`字符串`	连接可接受的TLS最小版本。	`"TLS 1.2"`	否
`cipher_suites`	`list(string)`	TLS传输可以使用的一组TLS加密套件列表。	`[]`	否
`reload_interval`	`持续时间`	证书重新加载的时间间隔。	`"0s"`	否
`client_ca_file`	`字符串`	服务器用于验证客户端证书的TLS证书路径。		否

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

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

ca_pem 和 ca_file
cert_pem 和 cert_file
key_pem 和 key_file

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

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

cors块

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

以下参数受支持

名称	类型	描述	默认值	必需
`allowed_origins`	`list(string)`	`Origin`头的允许值。	`[]`	否
`allowed_headers`	`list(string)`	CORS请求接受的头部。	`["X-Requested-With"]`	否
`max_age`	`number`	配置响应头`Access-Control-Max-Age`。	`0`	否

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

Accept
Accept-Language
Content-Type
Content-Language

如果allowed_headers包括"*"，则允许所有头部。

debug_metrics块

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

以下参数受支持

名称	类型	描述	默认值	必需
`disable_high_cardinality_metrics`	`布尔值`	是否禁用某些高基数指标。	`true`	否
`level`	`字符串`	控制包装收集器发出的指标详细程度。	`"detailed"`	否

《disable_high_cardinality_metrics》是Grafana Alloy中与OpenTelemetry Collector的telemetry.disableHighCardinalityMetrics功能门对应的。它移除了可能导致高基数指标的属性。例如，移除了关于HTTP和gRPC连接的指标中的IP地址和端口号属性。

注意
如果已配置，则disable_high_cardinality_metrics仅适用于otelcol.exporter.*和otelcol.receiver.*组件。

level是Alloy中与OpenTelemetry Collector的telemetry.metrics.level功能门对应的。可能的值有"none"、"basic"、"normal"和"detailed"。

output块

《output》块配置了一组组件，用于将结果遥测数据转发到。

以下参数受支持

名称	类型	描述	默认值	必需
`logs`	`list(otelcol.Consumer)`	要发送日志的消费者列表。	`[]`	否
`metrics`	`list(otelcol.Consumer)`	要发送指标到的消费者列表。	`[]`	否
`traces`	`list(otelcol.Consumer)`	要发送跟踪到的消费者列表。	`[]`	否

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

导出字段

《otelcol.receiver.datadog》不导出任何字段。

组件健康

《otelcol.receiver.datadog》只有在给定无效配置时才报告为不健康。

调试信息

《otelcol.receiver.datadog》不公开任何特定于组件的调试信息。

示例

此示例在最终将遥测数据发送到OTLP兼容端点之前，通过批量处理器转发接收到的遥测数据。

otelcol.receiver.datadog "default" {
  output {
    metrics = [otelcol.processor.batch.default.input]
    traces  = [otelcol.processor.batch.default.input]
  }
}

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

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