Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Prosesor pipa metrik

Prosesor pipa metrik mengubah titik data metrik OTel selama konsumsi. Pipa metrik dapat memiliki hingga 20 prosesor, diterapkan secara berurutan dalam urutan yang ditentukan.

Prosesor menggunakan ekspresi jalur OTTL untuk menargetkan atribut pada cakupan yang berbeda:

prosesor add_attributes

Menambahkan atau menimpa atribut pada titik data metrik. Bekerja dengan semua jenis temporalitas.

Setara dengan OTTL: set(attributes["key"], "value")

Konfigurasi

Konfigurasikan prosesor add_attributes dengan parameter berikut:

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

prosesor delete_attributes

Menghapus atribut tertentu dari titik data metrik. Tidak berlaku untuk metrik kumulatif atau metrik vended.

Setara dengan OTTL: delete_key(attributes, "key")

Konfigurasi

Konfigurasikan prosesor delete_attributes dengan parameter berikut:

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

prosesor rename_attributes

Mengganti nama kunci atribut pada titik data metrik. Tidak berlaku untuk metrik kumulatif atau metrik vended.

Setara dengan OTTL: set() + delete_key()

Konfigurasi

Konfigurasikan prosesor rename_attributes dengan parameter berikut:

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

prosesor rename_metrics

Mengganti nama nama metrik. Tidak berlaku untuk metrik kumulatif atau metrik vended.

Setara dengan OTTL: set(name, "new.metric.name") where name == "old.metric.name"

Konfigurasi

Konfigurasikan prosesor rename_metrics dengan parameter berikut:

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

prosesor substitute_attribute_values

Maps nilai atribut melalui tabel pencarian. Tidak berlaku untuk metrik kumulatif atau metrik vended.

Setara dengan OTTL: replace_match()

Konfigurasi

Konfigurasikan prosesor substitute_attribute_values dengan parameter berikut:

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

Contoh lengkap

Contoh berikut menggunakan kelima prosesor dalam satu pipeline:

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

Kompatibilitas dan pembatasan prosesor