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

实验性

otelcol.receiver.datadog

实验性：这是一个 实验性 组件。实验性组件可能会频繁进行重大更改，并且可能会被移除，而不会有等效的替代品。必须将 stability.level 标志设置为 experimental 才能使用此组件。

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

您可以指定多个 otelcol.receiver.datadog 组件，只需为它们提供不同的标签即可。

用法

alloy 复制

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

参数

otelcol.receiver.datadog 支持以下参数

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

块

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

tls 块

tls 块配置用于服务器的 TLS 设置。如果未提供 tls 块，则不会对服务器的连接使用 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_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.datadog 不导出任何字段。

组件健康状况

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

调试信息

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

示例

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

alloy 复制

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")
  }
}

启用身份验证

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

alloy 复制

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

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

兼容组件

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

• 导出 OpenTelemetry otelcol.Consumer 的组件