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

otelcol.exporter.otlphttpOTLP HTTP导出器

otelcol.exporter.otlphttp 接受来自其他 otelcol 组件的遥测数据，并使用 OTLP HTTP 协议通过网络写入。

您可以通过指定不同的标签来指定多个 otelcol.exporter.otlphttp 组件。

使用方法

alloy 复制

otelcol.exporter.otlphttp "LABEL" {
  client {
    endpoint = "HOST:PORT"
  }
}

参数

otelcol.exporter.otlphttp 支持以下参数

默认值取决于在必需的 client 块中设置的 endpoint 字段。如果设置，这些参数将覆盖对应信号的目标端的 client.endpoint 字段。

块

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

> 符号表示嵌套的更深层。例如，client > tls 指的是在 client 块中定义的 tls 块。

client 块

client 块配置组件使用的 HTTP 客户端。

以下参数受到支持

设置 headers 时，请注意

• 某些头部，如 Content-Length 和 Connection，在需要时自动写入，并且在 headers 中的值可能会被忽略。
• 从 endpoint 值自动推导出 Host 头部。然而，可以通过在 headers 中显式设置 Host 头部来覆盖此自动分配。

将 disable_keep_alives 设置为 true 将会导致为每个请求建立新的HTTP或HTTPS连接产生重大的开销。在启用此选项之前，请考虑是否更改空闲连接设置可以达到您的目标。

如果未设置 http2_ping_timeout 或设置为 0s，则默认为 15s。

如果未设置 http2_read_idle_timeout 或设置为 0s，则不执行任何健康检查。

默认情况下，请求使用Gzip进行压缩。 compression 参数控制使用哪个压缩机制。支持的字符串是

• "gzip"
• "zlib"
• "deflate"
• "snappy"
• "zstd"

如果将 compression 设置为 "none" 或空字符串 ""，则请求不会被压缩。

cookies块

该 cookies 块允许HTTP客户端从服务器响应中存储cookie并在后续请求中重用它们。

这可以在例如负载均衡器依赖于cookie进行粘性会话并强制最大会话年龄的情况下很有用。

以下参数受到支持

tls块

该 tls 块配置用于连接HTTP服务器的TLS设置。

以下参数受到支持

如果服务器不支持TLS，您必须将insecure参数设置为true。

要将服务器连接中的tls禁用，请将insecure参数设置为true。

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

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

• ca_pem 和 ca_file
• cert_pem 和 cert_file
• key_pem 和 key_file

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

sending_queue 块

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

以下参数受到支持

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

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

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

retry_on_failure 块

retry_on_failure块配置了如何重试HTTP服务器失败请求。

以下参数受到支持

当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"，则失败请求会无限期地重试，直到它们成功。

debug_metrics 块

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

以下参数受到支持

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

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

导出字段

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

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

组件健康状态

otelcol.exporter.otlphttp仅在提供无效配置时报告为不健康。

调试信息

otelcol.exporter.otlphttp不公开任何特定组件的调试信息。

示例

此示例创建了一个导出器，用于向本地运行的、不使用TLS的Grafana Tempo发送数据

alloy 复制

otelcol.exporter.otlphttp "tempo" {
    client {
        endpoint = "http://tempo:4317"
        tls {
            insecure             = true
            insecure_skip_verify = true
        }
    }
}

兼容组件

otelcol.exporter.otlphttp的导出可以由以下组件消费

• 消费OpenTelemetry otelcol.Consumer的组件