otelcol.receiver.zipkin
otelcol.receiver.zipkin
接受网络上传来的Zipkin格式跟踪信息并将其转发到其他 otelcol.*
组件。
注意:
otelcol.receiver.zipkin
是 OpenTelemetry Collectorzipkin
接收器的包装。如有必要,bug 报告或功能请求将被重定向到上游仓库。
可以通过给它们不同的标签来指定多个 otelcol.receiver.zipkin
组件。
用法
otelcol.receiver.zipkin "LABEL" {
output {
traces = [...]
}
}
参数
otelcol.receiver.zipkin
支持以下参数
名称 | 类型 | 描述 | 默认值 | 必需 |
---|---|---|---|---|
parse_string_tags | 布尔值 | 解析字符串标记和二进制注释为非字符串类型。 | false | 否 |
endpoint | 字符串 | 要监听流量的 host:port | "0.0.0.0:9411" | 否 |
max_request_body_size | 字符串 | 服务器允许的最大请求体大小。 | 20MiB | 否 |
include_metadata | 布尔值 | 将传入连接的元数据传播到下游消费者。 | 否 | |
compression_algorithms | 字符串列表 | 服务器可以接受的压缩算法列表。 | ["", "gzip", "zstd", "zlib", "snappy", "deflate"] | 否 |
如果 parse_string_tags
为 true
,则如果可能,将字符串标记和二进制注释转换为 int
、bool
和 float
。无法转换的字符串标记和二进制注释保持不变。
块
支持以下块在 otelcol.receiver.zipkin
定义内部
层级 | 块 | 描述 | 必需 |
---|---|---|---|
tls | tls | 配置 HTTP 服务器的 TLS。 | 否 |
cors | cors | 配置 HTTP 服务器的 CORS。 | 否 |
debug_metrics | debug_metrics | 配置此组件生成的指标以监视其状态。 | 否 |
output | output | 配置将接收到的跟踪信息发送到何处。 | yes |
符号 >
表示更深的嵌套层级。例如,grpc > tls
指的是在 grpc
块内定义的 tls
块。
tls 块
此 tls
块配置用于服务器的 TLS 设置。如果未提供 tls
块,则服务器连接不会使用 TLS。
以下参数受支持
名称 | 类型 | 描述 | 默认值 | 必需 |
---|---|---|---|---|
ca_file | 字符串 | CA 文件的路径。 | 否 | |
ca_pem | 字符串 | 用于验证服务器的 CA PEM 编码文本。 | 否 | |
cert_file | 字符串 | TLS 证书的路径。 | 否 | |
cert_pem | 字符串 | 用于客户端身份验证的证书 PEM 编码文本。 | 否 | |
include_system_ca_certs_pool | 布尔值 | 是否与证书 authority 一起加载系统证书权威池。 | false | 否 |
key_file | 字符串 | TLS 证书私钥的路径。 | 否 | |
key_pem | secret | 用于客户端身份验证的密钥 PEM 编码文本。 | 否 | |
max_version | 字符串 | 连接可接受的TLS最大版本。 | "TLS 1.3" | 否 |
min_version | 字符串 | 连接可接受的最低TLS版本。 | "TLS 1.2" | 否 |
cipher_suites | 字符串列表 | 一个可以由TLS传输使用的TLS加密套件的列表。 | [] | 否 |
reload_interval | duration | 在证书重新加载后的持续时间。 | "0s" | 否 |
client_ca_file | 字符串 | 服务器使用的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 block
该cors
块配置HTTP服务器的CORS设置。
以下参数受支持
名称 | 类型 | 描述 | 默认值 | 必需 |
---|---|---|---|---|
allowed_origins | 字符串列表 | Origin 头部的允许值。 | 否 | |
allowed_headers | 字符串列表 | CORS请求接受的头部。 | ["X-Requested-With"] | 否 |
max_age | number | 配置Access-Control-Max-Age 响应头部。 | 否 |
allowed_headers
参数指定CORS请求可以接受的哪些头部。以下头部始终隐式允许。
Accept
Accept-Language
Content-Type
Content-Language
如果allowed_headers
包含"*"
,则允许所有头部。
debug_metrics block
该debug_metrics
块配置组件生成以监控其状态的指标。
以下参数受支持
名称 | 类型 | 描述 | 默认值 | 必需 |
---|---|---|---|---|
disable_high_cardinality_metrics | 布尔值 | 是否禁用某些高基数指标。 | true | 否 |
level | 字符串 | 控制封装收集器发出的指标的详细程度。 | "detailed" | 否 |
disable_high_cardinality_metrics
是Grafana Alloy对应于OpenTelemetry Collector中telemetry.disableHighCardinalityMetrics
功能端的等效。它删除可能导致高基数指标的属性。例如,从HTTP和gRPC连接的指标中删除具有IP地址和端口号的属性。
注意
如果已配置,则disable_high_cardinality_metrics
仅适用于otelcol.exporter.*
和otelcol.receiver.*
组件。
level
是Alloy对应于OpenTelemetry Collector中telemetry.metrics.level
功能端的等效。可能的值是"none"
、"basic"
、"normal"
和"detailed"
。
output block
output
块配置一组组件,以将结果遥测数据转发到。
以下参数受支持
名称 | 类型 | 描述 | 默认值 | 必需 |
---|---|---|---|---|
logs | list(otelcol.Consumer) | 要发送日志的消费者列表。 | [] | 否 |
metrics | list(otelcol.Consumer) | 要发送指标的消费者列表。 | [] | 否 |
traces | list(otelcol.Consumer) | 要将跟踪发送到的消费者列表。 | [] | 否 |
必须指定output
块,但所有参数都是可选的。默认情况下,遥测数据将被丢弃。根据需要配置metrics
、logs
和traces
参数,以将遥测数据发送到其他组件。
导出字段
otelcol.receiver.zipkin
不导出任何字段。
组件健康
如果提供无效配置,则otelcol.receiver.zipkin
仅报告为不健康。
调试信息
otelcol.receiver.zipkin
不公开任何特定于组件的调试信息。
示例
此示例通过批处理器将接收到的跟踪转发表后,最终将其发送到具有OTLP功能的端点。
otelcol.receiver.zipkin "default" {
output {
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.zipkin
可以接受来自以下组件的参数
注意
连接某些组件可能不合理,或者组件可能需要进一步配置才能正确连接。请参阅链接的文档以获取更多信息。