Wie rufe ich Protokolldaten von CloudWatch Logs ab?

Lösung

Hinweis: Wenn du beim Ausführen von AWS Command Line Interface (AWS CLI)-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

Verwende die folgenden bewährten Methoden, um Protokolldaten aus CloudWatch Logs abzurufen.

Streamen von Protokolldaten mit Abonnementfiltern

Verwende Abonnementfilter, um Protokolldaten in Echtzeit aus CloudWatch Logs abzurufen. Abonnementfilter für Protokolldaten verhindern die Drosselung der CloudWatch-API. Weitere Informationen findest du unter Echtzeitverarbeitung von Protokolldaten mit Abonnements und Abonnementfilter auf Protokollgruppen-Ebene.

Hinweis: Amazon Kinesis Data Streams wiederholt automatisch gedrosselte Service-APIs.

Verwendung von CloudWatch-APIs

Verwende die CloudWatch-API-Vorgänge GetLogEvents oder FilterLogEvents, um deine Protokolldaten manuell zu finden. Du kannst diese API-Vorgänge aufgrund des Kontingents für Transaktionen pro Sekunde (TPS) nicht skalieren. Der GetLogEvents-API-Vorgang gibt möglicherweise leere Ergebnisse zurück, wenn über das Token mehr Protokollereignisse verfügbar sind. Aktuelle Kontingente findest du unter CloudWatch Logs-Kontingente. Wenn du eine API-Drosselung feststellst, verwende Abonnementfilter.

Ausführen einer CloudWatch-Logs-Insights-Abfrage

Führe eine Abfrage in CloudWatch Logs Insights aus, um Protokolldaten schnell zu durchsuchen und zu analysieren. Mithilfe von Abfragen kannst du auf Probleme reagieren und Ursachen für weitere Problembehebungen ermitteln. Weitere Informationen findest du unter Analyse von Protokolldaten mit CloudWatch Logs Insights.

Export von Protokolldaten nach Amazon S3

Du kannst CloudWatch-Logs-Daten in Batch-Anwendungsfällen nach Amazon S3 exportieren. Es kann bis zu 12 Stunden dauern, bis der Export von Protokolldaten in CloudWatch Logs verfügbar ist. Verwende Abonnementfilter für die Analyse und Verarbeitung in Echtzeit.

Hinweis: Ein AWS-Konto kann nur eine Exportaufgabe für Protokolldaten im Status PENDING, PENDING_CANCEL oder RUNNING haben.

Herunterladen von Protokollen in eine CSV-Datei

Du kannst die CloudWatch-Konsole, AWS CLI oder CloudWatch Logs Insights verwenden, um Protokolldaten abzurufen. Verwenden der CloudWatch-Konsole

Führe die folgenden Schritte aus:

1. Öffne die CloudWatch-Konsole.
2. Wähle deine Protokollgruppe aus.
3. Wähle den Protokollstream aus, der die Protokollereignisse enthält, die du herunterladen möchtest.
4. Wähle Aktionen und dann Suchergebnisse herunterladen aus.

AWS CLI verwenden

Um Protokollereignisse im CSV-Dateiformat abzurufen, führe den folgenden AWS-CLI-Befehl get-log-events aus:

aws logs get-log-events --log-group-name example-loggroup-name  --log-stream-name example-logstream-name  --start-time 1705147529 --end-time 1705233929 log_events.csv

Hinweis: Ersetze example-loggroup-name durch deinen Protokollgruppennamen, example-logstream-name durch deinen Protokollstream-Namen, 1705147529 durch deine Startzeit und 1705233929 durch deine Endzeit.

Die CSV-Datei wird in demselben Verzeichnis gespeichert, von dem aus der Befehl initiiert wurde. Außerdem verwendet die AWS CLI die standardmäßige AWS-Region und das AWS-Profil, die für die Workstation konfiguriert sind. Gib im vorherigen AWS-CLI-Befehl die Region für deine Workstation an.

CloudWatch Logs Insights verwenden, um Protokolldaten abzurufen

Führe eine Abfrage aus, um deine Protokolldaten abzurufen. Um Daten mit weniger als 10 000 Protokollen zu exportieren, wähle Ergebnisse exportieren. Oder, um Daten für mehr als 10 000 Protokolle zu exportieren, exportiere die Protokolle in einen S3-Bucket und lade die Daten dann in eine CSV-Datei herunter.