View a markdown version of this page

Debuggen mit Protokollen von veröffentlichten Apps in Amazon Logs CloudWatch - AWS App Studio
Verwenden von CloudWatch Logs Insights-Abfragen zum Filtern und Sortieren von Protokollen

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.

Debuggen mit Protokollen von veröffentlichten Apps in Amazon Logs CloudWatch

Amazon CloudWatch Logs überwacht Ihre AWS Ressourcen und die Anwendungen, auf denen Sie laufen, AWS in Echtzeit. Sie können CloudWatch Logs verwenden, um Kennzahlen zu sammeln und zu verfolgen. Dabei handelt es sich um Variablen, die Sie für Ihre Ressourcen und Anwendungen messen können.

Für das Debuggen von App Studio-Apps sind CloudWatch Logs nützlich, um Fehler zu verfolgen, die während der Ausführung einer App auftreten, Informationen zu überprüfen und den Kontext zu Benutzeraktionen und proprietären Interaktionen bereitzustellen. Die Protokolle enthalten historische Daten, anhand derer Sie die Anwendungsnutzung und die Zugriffsmuster überprüfen sowie Fehler überprüfen können, auf die Benutzer gestoßen sind.

Anmerkung

CloudWatch Logs liefert keine Echtzeit-Traces von Parameterwerten, die über die Benutzeroberfläche einer Anwendung übergeben wurden.

Gehen Sie wie folgt vor, um in Ihren App Studio-Apps in CloudWatch Logs auf Protokolle zuzugreifen.

  1. Suchen Sie im App Studio Application Studio für Ihre App nach Ihrer App-ID und notieren Sie sie anhand der URL. Die App-ID könnte ungefähr so aussehen:802a3bd6-ed4d-424c-9f6b-405aa42a62c5.

  2. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  3. Wählen Sie im Navigationsbereich Protokollgruppen aus.

  4. Hier finden Sie fünf Protokollgruppen pro Anwendung. Wählen Sie je nach Art der Informationen, an denen Sie interessiert sind, eine Gruppe aus und schreiben Sie eine Abfrage für die Daten, die Sie ermitteln möchten.

    Die folgende Liste enthält die Protokollgruppen und Informationen darüber, wann sie verwendet werden sollten:

    1. /aws/appstudio/teamId/appId/TEST/app: Wird zum Debuggen von Automatisierungsantworten, Komponentenfehlern oder JavaScript Code verwendet, der sich auf die Version Ihrer App bezieht, die derzeit in der Testumgebung veröffentlicht ist.

    2. /aws/appstudio/teamId/appId/TEST/audit: Wird verwendet, um JavaScript Codefehler wie bedingte Sichtbarkeit oder Transformation, Abfragefehler und Benutzerfehler bei Anmeldung oder Berechtigungen im Zusammenhang mit der Version Ihrer App zu debuggen, die derzeit in der Testumgebung veröffentlicht ist.

    3. /aws/appstudio/teamId/setup: Wird verwendet, um Builder- oder Admin-Aktionen zu überwachen.

    4. /aws/appstudio/teamId/appId/PRODUCTION/app: Wird zum Debuggen von Automatisierungsantworten, Abfragefehlern, Komponentenfehlern oder JavaScript Code im Zusammenhang mit der Version Ihrer App verwendet, die derzeit in der Produktionsumgebung veröffentlicht ist.

    5. /aws/appstudio/teamId/appId/PRODUCTION/audit: Wird zum Debuggen von JavaScript Codefehlern wie bedingter Sichtbarkeit oder Transformation sowie Anmelde- oder Zugriffsbenutzerfehlern im Zusammenhang mit der Version Ihrer App verwendet, die derzeit in der Produktionsumgebung veröffentlicht ist.

    Anmerkung

    Die meisten Protokolle, die für das Debuggen verwendet werden sollen, sind dem DebugLogClient Namespace zugeordnet.

  5. Sobald Sie sich in einer Protokollgruppe befinden, können Sie entweder die neuesten Protokollstreams oder einen mit der Uhrzeit des letzten Ereignisses auswählen, die dem gewünschten Zeitpunkt am nächsten kommt, oder Sie können wählen, dass alle Protokollstreams durchsucht werden, um alle Ereignisse in dieser Protokollgruppe zu durchsuchen. Weitere Informationen zum Anzeigen von Protokolldaten in CloudWatch Logs finden Sie unter An Logs gesendete CloudWatch Logdaten anzeigen.

Verwenden von CloudWatch Logs Insights-Abfragen zum Filtern und Sortieren von Protokollen

Sie können CloudWatch Logs Insights verwenden, um mehrere Protokollgruppen gleichzeitig abzufragen. Sobald Sie eine Liste von Protokollgruppen identifiziert haben, die Sitzungsinformationen enthalten, navigieren Sie zu CloudWatch Logs Insights und wählen Sie die Protokollgruppen aus. Schränken Sie dann die Zielprotokolleinträge weiter ein, indem Sie die Abfrage anpassen. Hier sind einige Beispielabfragen:

Liste der Protokolle, die das Schlüsselwort enthalten: error 

fields @timestamp, @message
| filter @message like 'error'
| sort @timestamp desc

Debug-Protokolle aus der Testumgebung: 

fields @timestamp, @message
| filter namespace = "DebugLogClient"
| sort @timestamp desc

Gesamtzahl der 504/404 /500-Fehler in Intervallen von 5 Minuten: 

filter @message like '/api/automation' and (@message like ': 404' or @message like ': 500' or @message like ': 504') 
| fields @timestamp, method, path, statusCode  
| stats count(*) as errorCount by bin(5m)

Weitere Informationen zu CloudWatch Logs Insights finden Sie unter Analysieren von Protokolldaten mit CloudWatch Logs Insights im Amazon CloudWatch Logs-Benutzerhandbuch.