View a markdown version of this page

Pipelines erstellen - Amazon CloudWatch
Eine Log-Pipeline erstellenEine Metrik-Pipeline erstellen

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.

Pipelines erstellen

CloudWatch Pipelines unterstützt die Erstellung von Pipelines sowohl für Protokoll- als auch für Metrikdaten. In den folgenden Abschnitten wird beschrieben, wie die einzelnen Pipeline-Typen erstellt werden.

Eine Log-Pipeline erstellen

Der Assistent zur Pipeline-Konfiguration führt Sie durch die Erstellung Ihrer Protokolldatenpipeline.

  1. Geben Sie unter Allgemeine Einstellungen die Datenquellendetails einschließlich Quellname und -typ an. Sie können auch Pipeline-Tags und den Namen Ihrer Pipeline angeben.

  2. Geben Sie unter Ziel die Zieldetails an. Für Protokoll-Pipelines ist CloudWatch Logs das einzige unterstützte Ziel. Für Metrik-Pipelines ist CloudWatch Metrics das einzige unterstützte Ziel.

  3. Fügen Sie unter Prozessor die gewünschten Prozessoren und Parser hinzu. Ein Parser ist für bestimmte Datentypen ein erforderlicher erster Schritt. Sie können benutzerdefiniertes Parsen mit Prozessoren wie Grok oder CSV durchführen. Sie können den Suchprozessor verwenden, um Protokollereignisse mit Daten aus einer Amazon CloudWatch Logs-Lookup-Tabelle anzureichern. Prozessoren, die vom Datentyp nicht unterstützt werden, sind deaktiviert.

    Um Prozessoren mit natürlicher Sprache zu konfigurieren, aktivieren AI-assistedSie den Schalter. Geben Sie eine Beschreibung der benötigten Protokolltransformationen ein, und CloudWatch Pipelines generiert die Prozessorkonfiguration automatisch. Bei AWS versendeten Protokollen wird außerdem ein Musterprotokollereignis generiert, sodass Sie die Ausgabe vor der Bereitstellung überprüfen können. Sie können die generierte Konfiguration überprüfen und bearbeiten, bevor Sie die Pipeline erstellen.

    Wichtig

    Um die AI-assisted Prozessorkonfiguration verwenden zu können, benötigen Sie die logs:GeneratePipeline IAM-Berechtigung. Weitere Informationen finden Sie unter AI-assisted Berechtigungen für die Prozessorkonfiguration.

    Mithilfe des when Parameters können Sie unterstützten Prozessoren auch Regeln für die bedingte Verarbeitung hinzufügen. Mit der bedingten Verarbeitung können Sie steuern, auf welche Protokolleinträge ein Prozessor reagiert. Informationen zur Ausdruckssyntax und zu den unterstützten Prozessoren finden Sie unterAusdruckssyntax für bedingte Verarbeitung.

    Um unveränderte Kopien Ihrer Protokolldaten für Prüf- oder Compliance-Zwecke aufzubewahren, aktivieren Sie die Option Originalprotokoll behalten. Wenn diese Option aktiviert ist, speichert CloudWatch Pipelines automatisch eine Kopie jedes Rohprotokollereignisses, bevor eine Transformation im @original_message Systemfeld des Ereignisses stattfindet. Dadurch wird sichergestellt, dass Originaldaten immer für Audits oder Untersuchungen verfügbar sind, auch nachdem Prozessoren die Protokollereignisse geändert haben. Die Option Originalprotokoll beibehalten ist nur für Pipelines verfügbar, für die eine Protokollquelle zur Verfügung CloudWatch steht.

  4. Überprüfen Sie unter Überprüfen und erstellen die Pipeline-Konfiguration. Wenn Sie mit der Konfiguration zufrieden sind, wählen Sie Create Pipeline aus, um mit der Bereitstellung und Erstellung von Pipeline-Ressourcen zu beginnen. Der Abschluss der Pipeline-Erstellung dauert je nach Quelltyp bis zu 5 Minuten. Nach Abschluss werden Sie in der Ingestion Console zur Registerkarte Pipelines weitergeleitet.

Wichtig

Pipeline-Prozessorkonfigurationen werden zu Prüf- und AWS CloudTrail Compliance-Zwecken in Ereignissen protokolliert. Um vertrauliche Informationen zu schützen, sollten Sie keine Passwörter, API-Schlüssel oder andere vertrauliche Informationen in Prozessorkonfigurationen aufnehmen.

Eine Metrik-Pipeline erstellen

Sie können eine Metrik-Pipeline mithilfe der CloudWatch Konsole oder der AWS CLI erstellen. Mit einer Metrik-Pipeline können Sie CloudWatch Metrikdaten verarbeiten, Transformationen anwenden und die verarbeiteten Metriken an CloudWatch weiterleiten.

So erstellen Sie eine Metrik-Pipeline (Konsole)

Gehen Sie wie folgt vor, um eine Metrik-Pipeline in der CloudWatch Konsole zu erstellen.

  1. Öffnen Sie die CloudWatch Konsole und wählen Sie im Navigationsbereich Ingestion, Pipelines aus.

  2. Wählen Sie Create pipeline (Pipeline erstellen) aus.

  3. Wählen Sie als Quelltyp CloudWatch Metrics (oTel) aus.

  4. Konfigurieren Sie die Auswahlkriterien, um anzugeben, welche Metriken die Pipeline verarbeitet. Die Auswahlkriterien verwenden oTEL-Attributpfade wie resource.attributesmetric.name, unddatapoint.attributes. Alle Kriterien verwenden die UND-Semantik (alle müssen übereinstimmen).

  5. Fügen Sie unter Prozessor bis zu 20 Prozessoren hinzu, um Ihre Metrikdaten zu transformieren.

  6. Überprüfen Sie unter Überprüfen und erstellen die Pipeline-Konfiguration und wählen Sie Pipeline erstellen aus.

Um eine Metrik-Pipeline zu erstellen (AWS CLI)

Verwenden Sie den create-telemetry-pipeline Befehl, um eine Metrik-Pipeline über die AWS CLI zu erstellen.

aws observabilityadmin create-telemetry-pipeline \
    --pipeline-configuration-body file://config.yaml

Das folgende Beispiel zeigt eine YAML-Konfigurationsdatei, die eine Metrik-Pipeline mit einer Quelle, einem Prozessor und einer Senke definiert.

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "payment-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}

Wenn die Pipeline erstellt wird, gibt sie einen ARN im folgenden Format zurück:

arn:aws:observabilityadmin:region:accountId:telemetry-pipeline/pipelineID
Anmerkung

CloudWatch Metrics ist das einzige unterstützte Ziel für Metrik-Pipelines.

Unterstützte -API-Operationen

In der folgenden Tabelle sind die API-Operationen aufgeführt, mit denen Sie Metrik-Pipelines verwalten können.

Operation Description
CreateTelemetryPipeline Erstellt eine neue Metrik-Pipeline.
GetTelemetryPipeline Ruft Details zu einer bestimmten Metrik-Pipeline ab.
ListTelemetryPipelines Listet alle Metrik-Pipelines in Ihrem Konto auf.
DeleteTelemetryPipeline Löscht eine Metrik-Pipeline.
ValidateTelemetryPipelineConfiguration Validiert eine Pipeline-Konfiguration vor der Erstellung.
UpdateTelemetryPipeline Aktualisiert eine bestehende Metrik-Pipeline-Konfiguration.