Link Search Menu Expand Document Documentation Menu

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 服务启用反射服务(详见 ProtoReflectionServicegRPC 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 计时器 衡量请求处理的持续时间。
剩余 350 字符

有问题?

想贡献?