otel_trace_source
otel_trace_source
是 OpenTelemetry Collector 的一个来源。下表描述了可用于配置 otel_trace_source
来源的选项。
选项 | 必需 | 类型 | 描述 |
---|---|---|---|
端口 | 否 | 整数 | otel_trace_source 来源运行的端口。默认值为 21890 。 |
请求超时 | 否 | 整数 | 请求超时时间,单位为毫秒。默认值为 10000 。 |
健康检查服务 | 否 | 布尔型 | 在 grpc.health.v1/Health/Check 下启用 gRPC 健康检查服务。默认值为 false 。 |
unauthenticated_health_check | 否 | 布尔型 | 确定健康检查端点是否需要身份验证。如果未定义身份验证,OpenSearch Data Prepper 将忽略此选项。默认值为 false 。 |
proto_reflection_service | 否 | 布尔型 | 为 Protobuf 服务启用反射服务(请参阅 gRPC reflection 和 gRPC Server Reflection Tutorial 文档)。默认值为 false 。 |
unframed_requests | 否 | 布尔型 | 启用不使用 gRPC 有线协议进行帧处理的请求。 |
线程数 | 否 | 整数 | ScheduledThreadPool 中要保留的线程数。默认值为 200 。 |
最大连接数 | 否 | 整数 | 允许的最大开放连接数。默认值为 500 。 |
输出格式 | 字符串 | 指定生成事件的输出格式。有效值为 otel 或 opensearch 。默认值为 opensearch 。 | |
最大请求长度 | 否 | 字节数 | 单个 gRPC 或 HTTP 请求的有效负载中允许的最大字节数。默认值为 10mb 。 |
SSL | 否 | 布尔型 | 启用与 OTel 源端口的 TLS/SSL 连接。默认为 true 。 |
sslKeyCertChainFile | 有条件地 | 字符串 | 安全证书的文件系统路径或 Amazon 简单存储服务 (Amazon S3) 路径(例如,"config/demo-data-prepper.crt" 或 "s3://my-secrets-bucket/demo-data-prepper.crt" )。如果 ssl 设置为 true ,则此项为必填项。 |
sslKeyFile | 有条件地 | 字符串 | 安全密钥的文件系统路径或 Amazon S3 路径(例如,"config/demo-data-prepper.key" 或 "s3://my-secrets-bucket/demo-data-prepper.key" )。如果 ssl 设置为 true ,则此项为必填项。 |
useAcmCertForSSL | 否 | 布尔型 | 是否使用 AWS Certificate Manager (ACM) 的证书和私钥启用 TLS/SSL。默认值为 false 。 |
acmCertificateArn | 有条件地 | 字符串 | 表示 ACM 证书 ARN。ACM 证书优先于 S3 或本地文件系统证书。如果 useAcmCertForSSL 设置为 true ,则此项为必填项。 |
awsRegion | 有条件地 | 字符串 | 表示 ACM 或 Amazon S3 使用的 AWS 区域。如果 useAcmCertForSSL 设置为 true ,或者 sslKeyCertChainFile 和 sslKeyFile 是 Amazon S3 路径,则此项为必填项。 |
身份验证 | 否 | 对象 | 一个身份验证配置。默认情况下,为管道创建一个未经身份验证的服务器。此参数使用可插拔的 HTTPS 身份验证。要使用基本身份验证,请定义带有 username 和 password 的 http_basic 插件。要提供自定义身份验证,请使用或创建一个实现 GrpcAuthenticationProvider 的插件。 |
用法
要使用 otel-metrics
来源,请创建以下 pipeline.yaml
文件,并将 otel_metrics_source
作为来源
source:
- otel_trace_source:
如果希望输出使用 OpenTelemetry 格式,请将 output_format
设置为 otel
,如以下示例所示
source:
- otel_trace_source:
output_format: otel
指标
otel_trace_source
来源包含以下指标。
计数器
requestTimeouts
:衡量超时请求的总数。requestsReceived
:衡量otel_trace
来源接收到的请求总数。successRequests
:衡量otel_trace
来源插件成功处理的请求总数。badRequests
:衡量otel_trace
来源插件处理的格式无效的请求总数。requestsTooLarge
:衡量跨度数量超出缓冲区容量的请求总数。internalServerError
:衡量otel_trace
来源处理的具有自定义异常类型的请求总数。
计时器
requestProcessDuration
:衡量otel_trace
来源插件处理请求的延迟(以秒为单位)。
分布汇总
payloadSize
:衡量传入请求有效负载大小分布(以字节为单位)。