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.

Metrics Pipeline-Prozessoren

Prozessoren für die Metrik-Pipeline transformieren metrische Otel-Datenpunkte während der Aufnahme. Eine Metrik-Pipeline kann bis zu 20 Prozessoren haben, die nacheinander in der Reihenfolge angewendet werden, in der sie definiert sind.

Prozessoren verwenden OTTL-Pfadausdrücke, um auf Attribute in unterschiedlichen Bereichen 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 Prozessor add_attributes 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

delete_attributes-Prozessor

Entfernt bestimmte Attribute aus metrischen Datenpunkten. Gilt nicht für kumulative 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 an metrischen Datenpunkten um. Gilt nicht für kumulative 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 die Namen der Metriken um. Gilt nicht für kumulative 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 über eine Nachschlagetabelle zu. Gilt nicht für kumulative 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