本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

指標管道處理器

指標管道處理器會在擷取期間轉換 OTel 指標資料點。指標管道最多可有 20 個處理器，依定義順序依序套用。

處理器使用 OTTL 路徑表達式來鎖定不同範圍內的屬性：

add_attributes 處理器

新增或覆寫指標資料點上的屬性。適用於所有時間類型。

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"

完整範例

下列範例使用單一管道中的所有五個處理器：

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: {}

處理器相容性和限制