otel_metrics

otel_metrics 处理器将从 OTel 指标源发送的 ExportMetricsServiceRequest 记录集合序列化为字符串记录集合。

用法

要开始使用，请将以下处理器添加到您的 pipeline.yaml 配置文件中

processor:
    - otel_metrics:

配置

您可以使用以下可选参数来配置直方图桶及其默认值。直方图通过将数据分组到桶中来显示数值数据。您可以使用直方图桶来查看按总事件计数和所有事件聚合总和组织的事件集。有关更详细的信息，请参阅 OpenTelemetry 直方图。

calculate_histogram_buckets

如果 calculate_histogram_buckets 未设置为 false，则以下 JSON 文件将被添加到每个直方图 JSON 中。如果 flatten_attributes 设置为 false，则指标的 JSON 字符串格式不会改变 attributes 字段。如果 flatten_attributes 设置为 true，则 attributes 字段中的值将放置在父 JSON 对象中。默认值为 true。请参阅以下 JSON 示例

 "buckets": [
    {
      "min": 0.0,
      "max": 5.0,
      "count": 2
    },
    {
      "min": 5.0,
      "max": 10.0,
      "count": 5
    }
  ]

您可以创建直方图桶及其边界的详细表示。您可以通过在 pipeline.yaml 文件中使用以下参数来控制此功能

  processor:
    - otel_metrics_raw_processor:
        calculate_histogram_buckets: true
        calculate_exponential_histogram_buckets: true
        exponential_histogram_max_allowed_scale: 10
        flatten_attributes: false

每个数组元素描述一个桶。每个桶包含下边界、上边界及其值计数。这是更详细的 OpenTelemetry 表示的一种特定形式，是 otel_metrics 处理器生成的 JSON 输出的一部分。请参阅以下 JSON 文件，该文件由 otel_metrics 处理器添加到每个 JSON 直方图。

 "explicitBounds": [
    5.0,
    10.0
  ],
   "bucketCountsList": [
    2,
    5
  ]

calculate_exponential_histogram_buckets

如果 calculate_exponential_histogram_buckets 设置为 true（默认设置），以下 JSON 值将添加到每个 JSON 直方图。

    "negativeBuckets": [
        {
        "min": 0.0,
        "max": 5.0,
        "count": 2
        },
        {
        "min": 5.0,
        "max": 10.0,
        "count": 5
        }
    ],
...
    "positiveBuckets": [
        {
        "min": 0.0,
        "max": 5.0,
        "count": 2
        },
        {
        "min": 5.0,
        "max": 10.0,
        "count": 5
        }
    ],

以下 JSON 文件是 OpenTelemetry 表示的一种更详细的形式，它由负桶和正桶、一个刻度参数、一个偏移量以及一个桶计数列表组成

    "negative": [
        1,
        2,
        3
    ],
    "positive": [
        1,
        2,
        3
    ],
    "scale" : -3,
    "negativeOffset" : 0,
    "positiveOffset" : 1

exponential_histogram_max_allowed_scale

exponential_histogram_max_allowed_scale 参数定义了指数直方图允许的最大刻度。如果增加此参数，将增加潜在的内存消耗。有关指数直方图及其计算复杂性的更多信息，请参阅 OpenTelemetry 规范。

所有刻度高于配置参数（默认值为 10）的指数直方图都将被丢弃并记录错误级别日志。您可以检查 OpenSearch Data Prepper 创建的日志以查看 ERROR 日志消息。

绝对刻度值用于比较，因此被视为与 11 相等的 -11 刻度值会超出配置值 10，并可能被丢弃。

指标

下表描述了所有处理器通用的指标。