Link Search Menu Expand Document Documentation Menu
文档

otel_trace_group

otel_trace_group 处理器通过查找 OpenSearch 后端来补全 span 记录集合中缺失的与跟踪组相关的字段。 otel_trace_group 处理器通过查找 OpenSearch 中存储的根 span 中的相关字段来识别 spanId 缺失的跟踪组信息。

OpenSearch

当您使用用户名和密码连接到 OpenSearch 集群时，请使用以下 pipeline.yaml 文件示例来配置 otel_trace_group 处理器。

pipeline:
  ...
  processor:
    - otel_trace_group:
        hosts: ["https://:9200"]
        cert: path/to/cert
        username: YOUR_USERNAME_HERE
        password: YOUR_PASSWORD_HERE

有关需要哪些 OpenSearch 凭证和权限以及如何为 OTel 跟踪组处理器配置这些凭证的更详细说明，请参阅 OpenSearch 安全。

Amazon OpenSearch 服务

当您使用 Amazon OpenSearch 服务时，请使用以下 pipeline.yaml 文件示例来配置 otel_trace_group 处理器。

pipeline:
  ...
  processor:
    - otel_trace_group:
        hosts: ["https://your-amazon-opensearch-service-endpoint"]
        aws_sigv4: true
        cert: path/to/cert
        insecure: false

配置

您可以为 otel_trace_group 处理器配置以下选项。

名称 描述 默认值
hosts OpenSearch 节点的 IP 地址列表。必需。 无默认值。
cert PEM 编码的证书颁发机构 (CA) 证书。接受 .pem 或 .crt 格式。这使得客户端能够信任签署 OpenSearch 所用证书的 CA。 null
aws_sigv4 用于使用 AWS 凭证签署 HTTP 请求的布尔标志。仅适用于 Amazon OpenSearch 服务。有关详细信息，请参阅 OpenSearch 安全。 false.
aws_region 表示 Amazon OpenSearch 服务域的 AWS 区域的字符串，例如 us-west-2。仅适用于 Amazon OpenSearch 服务。 us-east-1
aws_sts_role_arn 汇流器插件承担的 AWS Identity and Access Management (IAM) 角色，用于签署对 Amazon OpenSearch 服务的请求。如果未提供，插件将使用默认凭证。 null
aws_sts_header_overrides IAM 角色为汇流器插件承担的头覆盖映射。 null
insecure 用于关闭 SSL 证书验证的布尔标志。如果设置为 true，则关闭 CA 证书验证并发送不安全的 HTTP 请求。 false
username 包含用户名的字符串，用于 OpenSearch 集群的内部用户 YAML 配置文件。 null
password 包含密码的字符串，用于 OpenSearch 集群的内部用户 YAML 配置文件。 null

配置选项示例

您可以在 aws_sts_header_overrides 选项中定义配置选项值。请参阅以下示例：

aws_sts_header_overrides:
  x-my-custom-header-1: my-custom-value-1
  x-my-custom-header-2: my-custom-value-2

指标

下表描述了 otel_trace_group 处理器特有的自定义指标。

指标名称 类型 描述
recordsInMissingTraceGroup 计数器 缺失跟踪组字段的入站记录数。
recordsOutFixedTraceGroup 计数器 跟踪组字段成功补全的出站记录数。
recordsOutMissingTraceGroup 计数器 缺失跟踪组字段的出站记录数。
剩余 350 字符

有问题？。

想贡献？或。