otel_logs_source
成为「otel_logs_source」源是一个 OpenTelemetry 源,遵循 OpenTelemetry 协议规范 ,并以「ExportLogsServiceRequest」记录的形式从 OTel Collector 接收日志。
此源支持「OTLP/gRPC」协议。
配置
您可以使用以下选项配置「otel_logs_source」源。
选项 | 类型 | 描述 |
---|---|---|
端口 | 整数 | 表示「otel_logs_source」源运行所在的端口。默认值为「21892」。 |
路径 | 字符串 | 表示用于发送非帧 HTTP 请求的路径。您可以使用此选项通过符合 HTTP 习惯的路径支持将非帧 gRPC 请求发送到可配置的路径。路径应以「/」开头,其长度应至少为 1。如果配置了路径,则「/opentelemetry.proto.collector.logs.v1.LogsService/Export」端点对 gRPC 和 HTTP 请求都会被禁用。路径可以包含一个「${pipelineName}」占位符,该占位符将被替换为管道名称。如果该值为空且「unframed_requests」为「true」,则源将提供路径「/opentelemetry.proto.collector.logs.v1.LogsService/Export」。 |
最大请求长度 | 字符串 | 单个 gRPC 或 HTTP 请求的有效负载中允许的最大字节数。默认值为 10mb 。 |
请求超时 | 整数 | 表示请求超时持续时间(毫秒)。默认值为「10000」。 |
健康检查服务 | 布尔型 | 在「grpc.health.v1/Health/Check」下启用 gRPC 健康检查服务。默认值为「false」。 |
proto_reflection_service | 布尔型 | 为 Protobuf 服务启用反射服务(详见 ProtoReflectionService 和 gRPC reflection)。默认值为「false」。 |
unframed_requests | 布尔型 | 启用未使用 gRPC 线程协议进行帧处理的请求。默认值为「false」。 |
线程数 | 整数 | 「ScheduledThreadPool」中保持的线程数。默认值为「500」。 |
最大连接数 | 整数 | 允许的最大开放连接数。默认值为「500」。 |
压缩 | 字符串 | 应用于客户端请求负载的压缩类型。有效值为「none」或「gzip」。使用「gzip」对入局请求应用 GZip 解压。默认值为「none」(无压缩)。 |
输出格式 | 字符串 | 指定生成事件的输出格式。有效值为「otel」或「opensearch」。默认值为「opensearch」。 |
SSL
您可以使用以下选项在「otel_logs_source」源中配置 SSL。
选项 | 类型 | 描述 |
---|---|---|
SSL | 布尔型 | 启用 TLS/SSL。默认值为「true」。 |
sslKeyCertChainFile | 字符串 | 表示 SSL 证书链文件路径或 Amazon 简单存储服务 (Amazon S3) 路径。例如,请参见 Amazon S3 路径「s3://<bucketName>/<path>」。如果「ssl」设置为「true」,则为必需项。 |
sslKeyFile | 字符串 | 表示 SSL 密钥文件路径或 Amazon S3 路径。例如,请参见 Amazon S3 路径「s3://<bucketName>/<path>」。如果「ssl」设置为「true」,则为必需项。 |
useAcmCertForSSL | 布尔型 | 使用 AWS Certificate Manager (ACM) 中的证书和私钥启用 TLS/SSL。默认值为「false」。 |
acmCertificateArn | 字符串 | 表示 ACM 证书 Amazon 资源名称 (ARN)。 ACM 证书优先于 Amazon S3 或本地文件系统证书。如果「useAcmCertForSSL」设置为「true」,则为必需项。 |
awsRegion | 字符串 | 表示 ACM 或 Amazon S3 使用的 AWS 区域。如果「useAcmCertForSSL」设置为「true」,或「sslKeyCertChainFile」或「sslKeyFile」是 Amazon S3 路径,则为必需项。 |
用法
首先,创建一个「pipeline.yaml」文件并将「otel_logs_source」添加为源
source:
- otel_logs_source:
要以 OpenTelemetry 格式生成数据,请将「output_format」设置为「otel」,如以下示例所示
source:
- otel_logs_source:
output_format: otel
指标
您可以将以下指标与「otel_logs_source」源一起使用。
选项 | 类型 | 描述 |
---|---|---|
requestTimeouts | 计数器 | 衡量超时请求的总数。 |
requestsReceived | 计数器 | 衡量「otel_logs_source」源接收的请求总数。 |
badRequests | 计数器 | 衡量无法解析的请求总数。 |
requestsTooLarge | 计数器 | 衡量超过最大允许大小的请求总数。表示写入缓冲区的数据大小超出了缓冲区的最大容量。 |
internalServerError | 计数器 | 衡量因「requestTimeouts」或「requestsTooLarge」以外的错误导致出错的请求总数。 |
successRequests | 计数器 | 衡量成功写入缓冲区的请求总数。 |
payloadSize | 分布摘要 | 衡量所有入局负载大小的分布。 |
requestProcessDuration | 计时器 | 衡量请求处理的持续时间。 |