文档 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 回退主机名逻辑 文档。如果指标或跟踪已经具有主机名识别属性，则此选项不会更改应用于它们的主机名。

块

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

> 符号表示更深层次的嵌套。例如，metrics > summaries 指的是在 metrics 块内定义的 summaries 块。

api 块

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

支持以下参数

traces 块

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

支持以下参数

如果禁用 compute_stats_by_span_kind，则仅顶级 span 和已测量的 span 将计算统计信息。如果您正在发送 OTel 跟踪并希望获得非顶级 span 的统计信息，则必须将此标志设置为 true。如果您正在发送 OTel 跟踪并且不希望按 span 类型计算统计信息，则必须禁用此标志并禁用 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 分布（推荐）。
• "nobuckets"：不报告 bucket 指标。
• "counters"：每个直方图 bucket 报告一个指标。

sums 块

sums 块配置总和设置。

支持以下参数

cumulative_monotonic_mode 的有效值包括

• "to_delta"：在客户端计算总和的增量，并作为 Datadog 计数报告。
• "raw_value"：将原始值作为 Datadog 仪表报告。

initial_cumulative_monotonic_value 的有效值包括

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

summaries 块

summaries 块配置摘要设置。

支持以下参数

mode 的有效值包括

• "noquantiles"：不报告分位数指标。
• "gauges"：每个分位数报告一个仪表指标。

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 时，数据首先写入内存缓冲区，然后再发送到配置的服务器。发送到组件的 input 导出字段的批次会添加到缓冲区，只要未发送批次的数量不超过配置的 queue_size。

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

num_consumers 参数控制有多少读取器从缓冲区读取数据并并行发送数据。num_consumers 的值越大，数据发送速度越快，但会增加网络流量。

debug_metrics 块

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

支持以下参数

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

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

导出的字段

导出以下字段，并且可以被其他组件引用

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