Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Prozessoren für die Metrikpipeline

Prozessoren für die Metrik-Pipeline transformieren OTel-Metrikdatenpunkte während der Erfassung. Eine Metrik-Pipeline kann aus bis zu 20 Prozessoren bestehen, die nacheinander in der Reihenfolge angewendet werden, in der sie definiert sind.

Prozessoren verwenden OTTL-Pfadausdrücke, um auf Attribute mit unterschiedlichen Gültigkeitsbereichen abzuzielen:

Prozessor add_attributes

Fügt Attribute an metrischen Datenpunkten hinzu oder überschreibt sie. Funktioniert mit allen Temporalitätstypen.

OTTL-Äquivalent: set(attributes["key"], "value")

Konfiguration

Konfigurieren Sie den add_attributes-Prozessor mit den folgenden Parametern:

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

Prozessor delete_attributes

Entfernt bestimmte Attribute aus metrischen Datenpunkten. Gilt nicht für kumulative Metriken oder verkaufte Metriken.

OTTL-Äquivalent: delete_key(attributes, "key")

Konfiguration

Konfigurieren Sie den Prozessor delete_attributes mit den folgenden Parametern:

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

Prozessor „rename_attributes“

Benennt Attributschlüssel für metrische Datenpunkte um. Gilt nicht für kumulative Metriken oder verkaufte Metriken.

OTTL-Äquivalent: set() + delete_key()

Konfiguration

Konfigurieren Sie den Prozessor rename_attributes mit den folgenden Parametern:

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

Prozessor rename_metrics

Benennt Metriknamen um. Gilt nicht für kumulative Metriken oder verkaufte Metriken.

OTTL-Äquivalent: set(name, "new.metric.name") where name == "old.metric.name"

Konfiguration

Konfigurieren Sie den rename_metrics-Prozessor mit den folgenden Parametern:

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

Prozessor „substitute_attribute_values“

Ordnet Attributwerte mithilfe einer Nachschlagetabelle zu. Gilt nicht für kumulative Metriken oder verkaufte Metriken.

OTTL-Äquivalent: replace_match()

Konfiguration

Konfigurieren Sie den Prozessor substitute_attribute_values mit den folgenden Parametern:

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

Vollständiges Beispiel

Im folgenden Beispiel werden alle fünf Prozessoren in einer einzigen Pipeline verwendet:

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

Prozessorkompatibilität und Einschränkungen