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

社区

otelcol.exporter.datadog

社区: 此组件由 Alloy 用户社区开发、维护和支持。Grafana 不为此组件提供商业支持。要启用和使用社区组件，您必须将 --feature.community-components.enabled 标记设置为 true。

otelcol.exporter.datadog 接受来自其他 otelcol 组件的指标和追踪遥测数据，并将其发送到 Datadog。

您可以通过为 otelcol.exporter.datadog 组件指定不同的标签来定义多个此类组件。

用法

alloy 复制

otelcol.exporter.datadog "LABEL" {
    api {
        api_key = "YOUR_API_KEY_HERE"
    }
}

参数

支持以下参数

如果未设置 hostname，则自动确定主机名。有关更多信息，请参阅 Datadog 回退主机名逻辑 文档。如果指标或追踪已具有主机名标识属性，此选项将不会更改应用到它们的 hostname。

块

otelcol.exporter.datadog 定义中支持以下块

> 符号表示更深的嵌套级别。例如，metrics > summaries 指的是 metrics 块中定义的 summaries 块。

api 块

api 块配置与 Datadog API 的认证。这是将遥测数据发送到 Datadog 所必需的。如果您不提供 api 块，则无法将遥测数据发送到 Datadog。

支持以下参数

traces 块

traces 块配置追踪导出器设置。

支持以下参数

如果 compute_stats_by_span_kind 被禁用，则只有顶层和被测量的 span 会计算统计数据。如果您正在发送 OTel 追踪并希望对非顶层 span 计算统计数据，则必须将此标志设置为 true。如果您正在发送 OTel 追踪且不希望按 span kind 计算统计数据，则必须禁用此标志并禁用 compute_top_level_by_span_kind。

如果未设置 endpoint，则其值通过api部分中的 site 参数获取。

logs 块

logs 块配置日志导出器设置。

支持以下参数

如果 use_compression 被禁用，则 compression_level 不生效。

如果未设置 endpoint，则其值通过api部分中的 site 参数获取。

metrics 块

metrics 块配置指标导出器特定设置。

支持以下参数

语义映射列表中的任何资源属性子集都会转换为 Datadog 约定并设置为指标标签，无论是否启用 resource_attributes_as_tags。

如果未设置 endpoint，则其值通过api部分中的 site 参数获取。

exporter 块

exporter 块配置指标导出器设置。

支持以下参数

histograms 块

histograms 块配置直方图设置。

支持以下参数

mode 的有效值包括

• "distributions" 将指标作为 Datadog distribution 报告（推荐）。
• "nobuckets" 不报告 bucket 指标。
• "counters" 为每个直方图 bucket 报告一个指标。

sums 块

sums 块配置求和设置。

支持以下参数

cumulative_monotonic_mode 的有效值包括

• "to_delta" 在客户端计算总和的增量并作为 Datadog count 报告。
• "raw_value" 将原始值作为 Datadog gauge 报告。

initial_cumulative_monotonic_value 的有效值包括

• "auto" 如果设置了初始值的开始时间戳，并且该时间戳发生在进程启动后，则报告初始值。
• "drop" 始终丢弃初始值。
• "keep" 始终报告初始值。

summaries 块

summaries 块配置摘要设置。

支持以下参数

mode 的有效值包括

• "noquantiles" 不报告分位数指标。
• "gauges" 为每个分位数报告一个 gauge 指标。

host_metadata 块

host_metadata 块配置主机元数据。主机元数据用于填充基础设施列表和主机地图，并在 Datadog 应用中提供主机标签功能。

支持以下参数

默认情况下，导出器仅发送单个主机的元数据，其名称根据 host_metadata::hostname_source 选择。

hostname_source 的有效值包括

• "first_resource" 从到达导出器的第一个 OTLP 载荷的资源属性中选择主机元数据主机名。如果第一个载荷缺乏类似主机名的属性，它将回退到 ‘config_or_system’ 行为。如果从多个主机接收数据，请勿使用此主机名来源。
• "config_or_system" 从 ‘hostname’ 设置中选择主机元数据主机名，如果未设置，则回退到系统和云提供商 API。

client 块

client 块配置组件使用的 HTTP 客户端。Datadog 导出器并非支持所有字段。

支持以下参数

retry_on_failure 块

retry_on_failure 块配置如何重试发送到 Datadog 的失败请求。

支持以下参数

当 enabled 为 true 时，失败的批次会在给定的间隔后重试。initial_interval 参数指定第一次重试尝试前等待的时间。如果请求持续失败，重试前的等待时间会按 multiplier 参数指定的因子增加，该因子必须大于 1.0。max_interval 参数指定重试之间等待时间的上限。

randomization_factor 参数有助于在重试的 Alloy 实例之间增加抖动。如果 randomization_factor 大于 0，则重试前的等待时间将乘以一个随机因子，范围在 [ I - randomization_factor * I, I + randomization_factor * I] 之间，其中 I 是当前间隔。

如果一个批次未成功发送，它将在 max_elapsed_time 指定的时间过去后被丢弃。如果 max_elapsed_time 设置为 "0s"，失败的请求将永远重试，直到成功。

queue 块

queue 块配置在数据发送到 HTTP 服务器之前，批次的内存缓冲区。

支持以下参数

当 enabled 为 true 时，数据首先写入内存缓冲区，然后发送到配置的服务器。只要未发送批次的数量不超过配置的 queue_size，发送到组件的 input 导出字段的批次就会被添加到缓冲区。

queue_size 决定了对端点中断的容忍时间。假设每秒 100 个请求，默认队列大小 1000 大约提供 10 秒的中断容忍时间。要计算 queue_size 的正确值，请将每秒平均传出请求数乘以中断可容忍的时间（秒）。非常高的值可能会导致内存不足 (OOM) 终止。

num_consumers 参数控制从缓冲区读取数据并并行发送的读取器数量。较大的 num_consumers 值允许更快地发送数据，但会增加网络流量。

debug_metrics 块

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

支持以下参数

disable_high_cardinality_metrics 等效于 OpenTelemetry Collector 中的 telemetry.disableHighCardinalityMetrics 功能门。它会移除可能导致高基数指标的属性。例如，关于 HTTP 和 gRPC 连接的指标中带有 IP 地址和端口号的属性会被移除。

导出字段

导出以下字段，可供其他组件引用

input 接受用于任何遥测信号（指标、日志或追踪）的 otelcol.Consumer 数据。

组件健康状况

只有在给定无效配置时，otelcol.exporter.datadog 才会被报告为不健康。

调试信息

otelcol.exporter.datadog 不暴露任何组件特定的调试信息。

示例

转发 Prometheus 指标

此示例将来自 Alloy 的 Prometheus 指标通过接收器转发，先转换为 Open Telemetry 格式，最后发送到 Datadog。如果您使用美国 Datadog API，则需要 api 字段导出器才能正常工作。

alloy 复制

prometheus.exporter.self "default" {
}

prometheus.scrape "metamonitoring" {
  targets    = prometheus.exporter.self.default.targets
  forward_to = [otelcol.receiver.prometheus.default.receiver]
}

otelcol.receiver.prometheus "default" {
  output {
    metrics = [otelcol.exporter.datadog.default.input]
  }
}


otelcol.exporter.datadog "default" {
    api {
        api_key = "API_KEY"
    }

     metrics {
        endpoint = "https://api.ap1.datadoghq.com"
        resource_attributes_as_tags = true
    }
}

完整的 OTel 流水线

此示例将以 Datadog 格式接收的指标和追踪转发到 Alloy，将它们转换为 OTel 格式，然后导出到 Datadog。

alloy 复制

otelcol.receiver.datadog "default" {
	output {
		metrics = [otelcol.exporter.otlp.default.input, otelcol.exporter.datadog.default input]
		traces  = [otelcol.exporter.otlp.default.input, otelcol.exporter.datadog.default.input]
	}
}

otelcol.exporter.otlp "default" {
	client {
		endpoint = "database:4317"
	}
}

otelcol.exporter.datadog "default" {
	client {
		timeout = "10s"
	}

	api {
		api_key             = "abc"
		fail_on_invalid_key = true
	}

	traces {
		endpoint             = "https://trace.agent.datadoghq.com"
		ignore_resources     = ["(GET|POST) /healthcheck"]
		span_name_remappings = {
			"instrumentation:express.server" = "express",
		}
	}

	metrics {
		delta_ttl = 1200
		endpoint  = "https://api.datadoghq.com"

		exporter {
			resource_attributes_as_tags = true
		}

		histograms {
			mode = "counters"
		}

		sums {
			initial_cumulative_monotonic_value = "keep"
		}

		summaries {
			mode = "noquantiles"
		}
	}
}

兼容的组件

otelcol.exporter.datadog 具有可供以下组件消费的导出项

• 消费 OpenTelemetry otelcol.Consumer 的组件