Überwachen

AWS Amplify sendet Metriken über Amazon aus CloudWatch und stellt Zugriffsprotokolle mit detaillierten Informationen zu Anfragen an Ihre App bereit. In den Themen in diesem Abschnitt erfahren Sie, wie Sie diese Metriken und Protokolle zur Überwachung Ihrer App verwenden können.

Überwachung mit CloudWatch

AWS Amplify ist in Amazon integriert CloudWatch, sodass Sie die Metriken für Ihre Amplify-Anwendungen nahezu in Echtzeit überwachen können. Sie können Alarme erstellen, die Benachrichtigungen senden, wenn eine Metrik einen von Ihnen festgelegten Schwellenwert überschreitet. Weitere Informationen zur Funktionsweise des CloudWatch Service finden Sie im CloudWatch Amazon-Benutzerhandbuch.

Metriken

Amplify unterstützt sechs CloudWatch Metriken im AWS/AmplifyHosting Namespace zur Überwachung von Verkehr, Fehlern, Datenübertragung und Latenz für Ihre Apps. Diese Metriken werden in Intervallen von einer Minute aggregiert. CloudWatch Die Monitoring-Metriken sind kostenlos und werden nicht auf die CloudWatch Servicequoten angerechnet.

Nicht alle verfügbaren Statistiken gelten für jede Metrik. In der folgenden Tabelle sind die relevantesten Statistiken in der Beschreibung der einzelnen Metriken aufgeführt.

Metriken	Beschreibung
Anforderungen	Die Gesamtzahl der Zuschaueranfragen, die Ihre App erhalten hat. Die relevanteste Statistik istSum. Verwenden Sie die Sum Statistik, um die Gesamtzahl der Anfragen zu ermitteln.
BytesDownloaded	Die Gesamtmenge der Daten, die von Zuschauern für, und OPTIONS Anfragen aus Ihrer App übertragen (heruntergeladen) wurden GETHEAD, in Byte. Die relevanteste Statistik istSum.
BytesUploaded	Die Gesamtmenge der Daten, die mithilfe von POST und PUT Anfragen in Ihre App übertragen (hochgeladen) wurden, in Byte. Die relevanteste Statistik istSum.
4xxErrors	Die Anzahl der Anfragen, bei denen ein Fehler im Bereich des HTTP-Statuscodes 400-499 zurückgegeben wurde. Die relevanteste Statistik ist. Sum Verwenden Sie die Sum Statistik, um die Gesamthäufigkeit dieser Fehler zu ermitteln.
5xxErrors	Die Anzahl der Anfragen, bei denen ein Fehler im Bereich des HTTP-Statuscodes 500-599 zurückgegeben wurde. Die relevanteste Statistik ist. Sum Verwenden Sie die Sum Statistik, um die Gesamthäufigkeit dieser Fehler zu ermitteln.
Latency	Die Zeit bis zum ersten Byte in Sekunden. Dies ist die Gesamtzeit zwischen dem Empfang einer Anfrage durch Amplify Hosting und der Rückgabe einer Antwort an das Netzwerk. Dies beinhaltet nicht die Netzwerklatenz, die auftritt, wenn eine Antwort das Gerät des Betrachters erreicht. Die relevantesten Statistiken sind AverageMaximum,Minimum,p10,p50,p90,p95, undp100. Verwenden Sie die Average Statistik, um die erwarteten Latenzen zu bewerten.

Amplify bietet die folgenden CloudWatch metrischen Abmessungen.

Dimension	Beschreibung
App	Metrische Daten werden per App bereitgestellt.
AWS-Konto	Metrische Daten werden für alle Apps in der bereitgestellt AWS-Konto.

Sie können auf CloudWatch Metriken AWS Management Console unter https://console.aws.amazon.com/cloudwatch/ zugreifen. Alternativ können Sie mit dem folgenden Verfahren auf Metriken in der Amplify-Konsole zugreifen.

So greifen Sie in der Amplify-Konsole auf Metriken zu

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amplify-Konsole.

2. Wählen Sie die App aus, für die Sie Metriken anzeigen möchten.

3. Wählen Sie im Navigationsbereich App-Einstellungen, Überwachung aus.

4. Wählen Sie auf der Seite Überwachung die Option Metriken aus.

Alarme

Sie können in der Amplify-Konsole CloudWatch Alarme erstellen, die Benachrichtigungen senden, wenn bestimmte Kriterien erfüllt sind. Ein Alarm überwacht eine einzelne CloudWatch Metrik und sendet eine Amazon Simple Notification Service-Benachrichtigung, wenn die Metrik den Schwellenwert für eine bestimmte Anzahl von Bewertungszeiträumen überschreitet.

Sie können erweiterte Alarme erstellen, die metrische mathematische Ausdrücke in der CloudWatch Konsole oder mithilfe der CloudWatch APIs verwenden. Sie können beispielsweise einen Alarm erstellen, der Sie benachrichtigt, wenn der Prozentsatz in drei aufeinanderfolgenden Perioden 15% 4XXErrors überschreitet. Weitere Informationen finden Sie unter Erstellen eines CloudWatch Alarms auf der Grundlage eines metrischen mathematischen Ausdrucks im CloudWatch Amazon-Benutzerhandbuch.

Für Alarme gelten die CloudWatch Standardpreise. Weitere Informationen finden Sie unter CloudWatchAmazon-Preise.

Gehen Sie wie folgt vor, um einen Alarm in der Amplify-Konsole zu erstellen.

Um einen CloudWatch Alarm für eine Amplify-Metrik zu erstellen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amplify-Konsole.

2. Wählen Sie die App aus, für die Sie einen Alarm einrichten möchten.

3. Wählen Sie im Navigationsbereich App-Einstellungen, Überwachung aus.

4. Wählen Sie auf der Seite Überwachung die Option Alarme aus.

5. Wählen Sie Alarm erstellen aus.

6. Konfigurieren Sie Ihren Alarm im Fenster Alarm erstellen wie folgt:

   1. Wählen Sie unter Metrik den Namen der zu überwachenden Metrik aus der Liste aus.

   2. Geben Sie unter Name des Alarms einen aussagekräftigen Namen für den Alarm ein. Wenn Sie beispielsweise Anfragen überwachen, könnten Sie dem Alarm einen Namen gebenHighTraffic. Der Name darf nur ASCII-Zeichen enthalten.

   3. Gehen Sie für Benachrichtigungen einrichten wie folgt vor:

      • 1. Wählen Sie Neu, um ein neues Amazon SNS SNS-Thema einzurichten.

        2. Geben Sie unter E-Mail-Adresse die E-Mail-Adresse des Empfängers der Benachrichtigungen ein.

        3. Wählen Sie Neue E-Mail-Adresse hinzufügen, um weitere Empfänger hinzuzufügen.

      • 1. Wählen Sie Existing, um ein Amazon SNS SNS-Thema wiederzuverwenden.

        2. Wählen Sie unter SNS-Thema den Namen eines vorhandenen Amazon SNS SNS-Themas aus der Liste aus.

   4. Stellen Sie für Whenever the Statistic of Metric die Bedingungen für Ihren Alarm wie folgt ein:

      1. Geben Sie an, ob die Metrik größer, kleiner oder gleich dem Schwellenwert sein muss.

      2. Geben Sie den Schwellenwert an.

      3. Geben Sie die Anzahl der aufeinanderfolgenden Evaluierungsperioden an, die sich im Alarmstatus befinden müssen, um den Alarm auszulösen.

      4. Geben Sie die Dauer des Evaluierungszeitraums an.

   5. Wählen Sie Alarm erstellen aus.

Anmerkung

Jeder Amazon SNS SNS-Empfänger, den Sie angeben, erhält eine Bestätigungs-E-Mail von AWS Notifications. Die E-Mail enthält einen Link, dem der Empfänger folgen muss, um sein Abonnement zu bestätigen und Benachrichtigungen zu erhalten.

Amazon CloudWatch Logs für SSR-Apps

Amplify sendet Informationen über Ihre Laufzeit von Next.js an Amazon CloudWatch Logs in Ihrem AWS-Konto. Wenn Sie eine SSR-App bereitstellen, benötigt die App eine IAM-Dienstrolle, die Amplify übernimmt, wenn es andere Dienste in Ihrem Namen aufruft. Sie können entweder Amplify Hosting Compute erlauben, automatisch eine Servicerolle für Sie zu erstellen, oder Sie können eine Rolle angeben, die Sie erstellt haben.

Wenn Sie Amplify erlauben, eine IAM-Rolle für Sie zu erstellen, verfügt die Rolle bereits über die Berechtigungen zum Erstellen CloudWatch von Protokollen. Wenn Sie Ihre eigene IAM-Rolle erstellen, müssen Sie Ihrer Richtlinie die folgenden Berechtigungen hinzufügen, damit Amplify auf Amazon CloudWatch Logs zugreifen kann.

logs:CreateLogStream
logs:CreateLogGroup
logs:DescribeLogGroups
logs:PutLogEvents

Weitere Informationen zu Servicerollen finden Sie unter Eine Servicerolle hinzufügen. Weitere Informationen zur Bereitstellung serverseitig gerenderter Apps finden Sie unter. Bereitstellung serverseitig gerenderter Apps mit Amplify Hosting

Zugriffsprotokolle

Amplify speichert Zugriffsprotokolle für alle Apps, die Sie in Amplify hosten. Zugriffsprotokolle enthalten Informationen über Anfragen, die an Ihre gehosteten Apps gestellt werden. Amplify speichert alle Zugriffsprotokolle für eine App, bis Sie die App löschen. Alle Zugriffsprotokolle für eine App sind in der Amplify-Konsole verfügbar. Jede einzelne Anfrage nach Zugriffsprotokollen ist jedoch auf einen von Ihnen angegebenen Zeitraum von zwei Wochen begrenzt.

Amplify verwendet niemals CloudFront Distributionen zwischen Kunden wieder. Amplify erstellt CloudFront Distributionen im Voraus, sodass Sie bei der Bereitstellung einer neuen App nicht darauf warten müssen, dass eine CloudFront Distribution erstellt wird. Bevor diese Distributionen einer Amplify-App zugewiesen werden, erhalten sie möglicherweise Traffic von Bots. Sie sind jedoch so konfiguriert, dass sie immer als Nicht gefunden antworten, bevor sie zugewiesen werden. Wenn die Zugriffsprotokolle Ihrer App Einträge für einen Zeitraum enthalten, bevor Sie Ihre App erstellt haben, beziehen sich diese Einträge auf diese Aktivität.

Wichtig

Wir empfehlen, dass Sie die Protokolle verwenden, um die Art der Anfragen für Ihre Inhalte zu verstehen, nicht als eine vollständige Buchführung aller Anfragen. Amplify liefert Zugriffsprotokolle nach bestem Wissen. Der Protokolleintrag für eine bestimmte Anfrage wird möglicherweise viel später übermittelt, als die Anfrage tatsächlich verarbeitet wurde; in seltenen Fällen kann es auch sein, dass ein Protokolleintrag gar nicht übermittelt wird. Wenn ein Protokolleintrag in den Zugriffsprotokollen weggelassen wird, entspricht die Anzahl der Einträge in den Zugriffsprotokollen nicht der Nutzung, die in den AWS Abrechnungs- und Nutzungsberichten angegeben ist.

Gehen Sie wie folgt vor, um Zugriffsprotokolle für eine App abzurufen.

Um Zugriffsprotokolle anzuzeigen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amplify-Konsole.

2. Wählen Sie die App aus, für die Sie Zugriffsprotokolle anzeigen möchten.

3. Wählen Sie im Navigationsbereich Hosting und anschließend Überwachung aus.

4. Wählen Sie auf der Seite Überwachung die Option Zugriffsprotokolle aus.

5. Wählen Sie Zeitraum bearbeiten aus.

6. Gehen Sie im Fenster Zeitraum bearbeiten wie folgt vor.

   1. Geben Sie als Startdatum den ersten Tag des zweiwöchigen Intervalls an, für das Protokolle abgerufen werden sollen.

   2. Wählen Sie unter Startzeit die Uhrzeit am ersten Tag aus, an dem der Protokollabruf gestartet werden soll.

   3. Wählen Sie Bestätigen aus.

7. Die Amplify-Konsole zeigt die Protokolle für den angegebenen Zeitraum im Abschnitt Zugriffsprotokolle an. Wählen Sie Herunterladen, um die Protokolle im CSV-Format zu speichern.

Analyse von Zugriffsprotokollen

Um Zugriffsprotokolle zu analysieren, können Sie die CSV-Dateien in einem Amazon S3 S3-Bucket speichern. Eine Möglichkeit, Ihre Zugriffsprotokolle zu analysieren, ist die Verwendung von Athena. Athena ist ein interaktiver Abfragedienst, mit dem Sie Daten für AWS Dienste analysieren können. Sie können den step-by-step Anweisungen hier folgen, um eine Tabelle zu erstellen. Sobald Ihre Tabelle erstellt wurde, können Sie Daten wie folgt abfragen.

SELECT SUM(bytes) AS total_bytes
FROM logs
WHERE "date" BETWEEN DATE '2018-06-09' AND DATE '2018-06-11'
LIMIT 100;