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

otelcol.receiver.otlp

otelcol.receiver.otlp通过网络接收OTLP格式的数据，并将其转发到其他otelcol.*组件。

注意： otelcol.receiver.otlp是上游OpenTelemetry Collector otlp接收器的封装。如果必需，错误报告或功能请求将被转至上游存储库。

可以通过提供不同的标签来指定多个otelcol.receiver.otlp组件。

用法

alloy 复制

otelcol.receiver.otlp "LABEL" {
  grpc { ... }
  http { ... }

  output {
    metrics = [...]
    logs    = [...]
    traces  = [...]
  }
}

参数

otelcol.receiver.otlp不支持任何参数，完全通过内部块进行配置。

块

以下块在定义otelcol.receiver.otlp时受支持

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

grpc块

如果提供了“grpc”块，“grpc”块则配置组件使用的gRPC服务器。如果未提供“grpc”块，则不会启动gRPC服务器。

以下参数受支持

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 文档。

keepalive块

keepalive 块配置到 gRPC 服务器的连接的保活设置。

keepalive 不支持任何参数，并且完全通过内嵌块进行配置。

server_parameters块

server_parameters 块控制 gRPC 服务器的保活和最大年龄设置。

以下参数受支持

enforcement_policy块

enforcement_policy 块配置 gRPC 服务器的保活执行策略。服务器将关闭违反配置策略的客户端连接。

以下参数受支持

http块

http 块配置组件使用的 HTTP 服务器。如果有提供 http 块，则不会启动 HTTP 服务器。

以下参数受支持

要使用HTTP/JSON向otelcol.receiver.otlp发送遥测信号，请POST到

• [endpoint][traces_url_path]以发送跟踪信息。
• [endpoint][metrics_url_path]以发送度量信息。
• [endpoint][logs_url_path]以发送日志信息。

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在OpenTelemetry Collector中对应于telemetry.disableHighCardinalityMetrics功能门的等价物。它移除了可能导致高基数指标的属性。例如，从HTTP和gRPC连接的度量信息中移除包含IP地址和端口号的属性。

level是OpenTelemetry Collector中telemetry.metrics.level功能门的Grafana Alloy等价物。可能的值有"none"、"basic"、"normal"和"detailed"。

output块

output块配置了一组组件以将结果遥测数据转发到。

以下参数受支持

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

导出的字段

otelcol.receiver.otlp不导出任何字段。

组件健康

仅当提供无效配置时，otelcol.receiver.otlp才会报告为不健康。

调试信息

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

调试指标

• receiver_accepted_spans_ratio_total（计数器）：成功推送到管道的_spans的数量。
• receiver_refused_spans_ratio_total（计数器）：不能推送到管道的_spans的数量。
• rpc_server_duration_milliseconds（直方图）：从gRPC服务器发出的RPC请求持续时间。
• rpc_server_request_size_bytes（直方图）：测量RPC请求消息的大小（未压缩）。
• rpc_server_requests_per_rpc（直方图）：测量每个RPC收到的消息数。对于所有非流式RPC，应等于1。
• rpc_server_response_size_bytes（直方图）：测量RPC响应消息的大小（未压缩）。
• rpc_server_responses_per_rpc（直方图）：测量每个RPC收到的消息数。对于所有非流式RPC，应等于1。

示例

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

alloy 复制

otelcol.receiver.otlp "default" {
  http {}
  grpc {}

  output {
    metrics = [otelcol.processor.batch.default.input]
    logs    = [otelcol.processor.batch.default.input]
    traces  = [otelcol.processor.batch.default.input]
  }
}

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

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

技术细节

otelcol.receiver.otlp支持gzip压缩。

兼容组件

otelcol.receiver.otlp可以接受以下组件的参数

• 导出OpenTelemetry otelcol.Consumer的组件