メトリクスパイプラインプロセッサ

メトリクスパイプラインプロセッサは、取り込み中に OTel メトリクスデータポイントを変換します。メトリクスパイプラインには最大 20 個のプロセッサを含めることができます。プロセッサは、定義した順に適用されます。

プロセッサは OTTL パス式を使用して、さまざまなスコープで属性をターゲットにします。

add_entries プロセッサ

メトリクスデータポイントに対して属性を追加または上書きします。あらゆるタイプの時間性で動作します。

OTTL と同等: set(attributes["key"], "value")

設定

次のパラメータを使用して add_attributes プロセッサを設定します。

processor:
  - add_attributes:
      attributes:
        - key: resource.attributes["team"]
          value: "payments"
        - key: attributes["environment"]
          value: "production"
        - key: instrumentation_scope.attributes["version"]
          value: "1.0"
          overwrite_if_key_exists: true

delete_attributes プロセッサ

メトリクスデータポイントから特定の属性を削除します。累積メトリクスまたは提供されたメトリクスには適用されません。

OTTL と同等: delete_key(attributes, "key")

設定

次のパラメータを使用して delete_attributes プロセッサを設定します。

processor:
  - delete_attributes:
      with_keys:
        - resource.attributes["obsolete"]
        - attributes["temp"]
        - datapoint.attributes["debug"]

rename_attributes プロセッサ

メトリクスデータポイントの属性キーの名前を変更します。累積メトリクスまたは提供されたメトリクスには適用されません。

OTTL と同等: set() + delete_key()

設定

次のパラメータを使用して rename_attributes プロセッサを設定します。

processor:
  - rename_attributes:
      attributes:
        - from_key: resource.attributes["old_key"]
          to_key: resource.attributes["new_key"]
          overwrite_if_to_key_exists: true

rename_metrics プロセッサ

メトリクス名を変更します。累積メトリクスまたは提供されたメトリクスには適用されません。

OTTL と同等: set(name, "new.metric.name") where name == "old.metric.name"

設定

次のパラメータを使用して rename_metrics プロセッサを設定します。

processor:
  - rename_metrics:
      metrics:
        - from: "old.metric.name"
          to: "new.metric.name"

substitute_attribute_values プロセッサ

ルックアップテーブルを介して属性値をマッピングします。累積メトリクスまたは提供されたメトリクスには適用されません。

OTTL と同等: replace_match()

設定

次のパラメータを使用して substitute_attribute_values プロセッサを設定します。

processor:
  - substitute_attribute_values:
      attributes:
        - key: resource.attributes["region"]
          from: "us-east-1a"
          to: "us-east-1"

完全な例

次の例では、1 つのパイプラインで 5 つのプロセッサすべてを使用しています。

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "CPUUtilization"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["env"]
            value: "prod"
            overwrite_if_key_exists: true
    - delete_attributes:
        with_keys:
          - resource.attributes["internal.trace"]
    - rename_attributes:
        attributes:
          - from_key: resource.attributes["old_key"]
            to_key: resource.attributes["new_key"]
    - rename_metrics:
        metrics:
          - from: "CPUUtilization"
            to: "system.cpu.utilization"
    - substitute_attribute_values:
        attributes:
          - key: resource.attributes["environment"]
            from: "dev"
            to: "development"
  sink:
    - cloudwatch_metrics: {}

プロセッサの互換性と制限事項