AWS App Runner wird ab dem 30. April 2026 nicht mehr für Neukunden geöffnet sein. Wenn Sie App Runner verwenden möchten, melden Sie sich vor diesem Datum an. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der AWS App Runner Verfügbarkeit](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html). 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. # Observability für Ihren App Runner-Dienst AWS App Runner lässt sich in mehrere AWS Dienste integrieren, um Ihnen eine umfangreiche Suite von Observability-Tools für Ihren App Runner-Service zur Verfügung zu stellen. In den Themen dieses Kapitels werden diese Funktionen beschrieben. **Topics** + [Verfolgen der App Runner-Dienstaktivitäten](monitor-activity.md) + [App Runner-Protokolle anzeigen, die in Logs gestreamt wurden CloudWatch](monitor-cwl.md) + [App Runner-Servicemetriken anzeigen, an die gemeldet wurden CloudWatch](monitor-cw.md) + [Umgang mit App Runner-Ereignissen in EventBridge](monitor-ev.md) + [App Runner API-Aufrufe protokollieren mit AWS CloudTrail](monitor-ct.md) + [Tracing für Ihre App Runner-Anwendung mit X-Ray](monitor-xray.md) # Verfolgen der App Runner-Dienstaktivitäten AWS App Runner verwendet eine Liste von Vorgängen, um die Aktivitäten in Ihrem App Runner-Dienst zu verfolgen. Eine Operation stellt einen asynchronen Aufruf einer API-Aktion dar, z. B. das Erstellen eines Dienstes, das Aktualisieren einer Konfiguration und das Bereitstellen eines Dienstes. In den folgenden Abschnitten erfahren Sie, wie Sie Aktivitäten in der App Runner-Konsole und mithilfe der API verfolgen. ## Verfolgen Sie die Aktivität des App Runner-Dienstes Verfolgen Sie Ihre App Runner-Dienstaktivitäten mit einer der folgenden Methoden: ------ #### [ App Runner console ] Die App Runner-Konsole zeigt Ihre App Runner-Dienstaktivitäten an und bietet weitere Möglichkeiten, Abläufe zu erkunden. **Um die Aktivität Ihres Dienstes zu sehen** 1. Öffnen Sie die [App Runner-Konsole](https://console.aws.amazon.com/apprunner) und wählen Sie in der Liste der **Regionen** Ihre aus AWS-Region. 1. Wählen Sie im Navigationsbereich **Dienste** und dann Ihren App Runner-Dienst aus. In der Konsole wird das Service-Dashboard mit einer **Serviceübersicht** angezeigt. ![\[App Runner Service-Dashboard-Seite mit einer Aktivitätsliste\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/console-dashboard.png) 1. Wählen Sie auf der Service-Dashboard-Seite den Tab **Aktivität** aus, falls er nicht bereits ausgewählt ist. Die Konsole zeigt eine Liste von Vorgängen an. 1. Um nach bestimmten Vorgängen zu suchen, suchen Sie in der Liste nach einem Suchbegriff. Sie können nach jedem Wert suchen, der in der Tabelle erscheint. 1. Wählen Sie eine der aufgeführten Operationen aus, um das zugehörige Protokoll anzuzeigen oder herunterzuladen. ------ #### [ App Runner API or AWS CLI ] Die [ListOperations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListOperations.html)Aktion gibt unter Angabe des Amazon-Ressourcennamens (ARN) eines App Runner-Dienstes eine Liste von Vorgängen zurück, die in diesem Service aufgetreten sind. Jedes Listenelement enthält eine Vorgangs-ID und einige Tracking-Details. ------ # App Runner-Protokolle anzeigen, die in Logs gestreamt wurden CloudWatch Sie können Amazon CloudWatch Logs verwenden, um Protokolldateien zu überwachen, zu speichern und darauf zuzugreifen, die Ihre Ressourcen in verschiedenen AWS Diensten generieren. Weitere Informationen finden Sie im [Amazon CloudWatch Logs-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). AWS App Runner sammelt die Ergebnisse Ihrer Anwendungsbereitstellungen und Ihres aktiven Dienstes und streamt sie in CloudWatch Logs. In den folgenden Abschnitten werden App Runner-Protokollstreams aufgeführt und es wird gezeigt, wie Sie sie in der App Runner-Konsole anzeigen können. ## App Runner protokolliert Gruppen und Streams CloudWatch Logs speichert Protokolldaten in Protokollströmen, die es weiter in Protokollgruppen organisiert. Ein *Protokollstream* ist eine Abfolge von Protokollereignissen aus einer bestimmten Quelle. Eine *Protokollgruppe* ist eine Gruppe von Protokollstreams, die dieselben Einstellungen für die Aufbewahrung, Überwachung und Zugriffskontrolle besitzen. App Runner definiert zwei CloudWatch Logs-Protokollgruppen mit jeweils mehreren Protokollstreams für jeden App Runner-Dienst in Ihrem AWS-Konto. ### Dienstprotokolle Die Dienstprotokollgruppe enthält Protokollausgaben, die von App Runner generiert werden, während App Runner Ihren App Runner-Dienst verwaltet und darauf reagiert. | **Name der Protokollgruppe** | **Beispiel** | | --- | --- | | `/aws/apprunner/service-name/service-id/service` | `/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/service` | Innerhalb der Dienstprotokollgruppe erstellt App Runner einen Ereignisprotokollstream, um Aktivitäten im Lebenszyklus Ihres App Runner-Dienstes zu erfassen. Dies könnte beispielsweise bedeuten, dass Ihre Anwendung gestartet oder angehalten wird. Darüber hinaus erstellt App Runner einen Protokollstream für jeden lang andauernden asynchronen Vorgang, der sich auf Ihren Dienst bezieht. Der Name des Protokollstreams spiegelt den Vorgangstyp und die spezifische Vorgangs-ID wider. Eine *Bereitstellung* ist eine Art von Operation. Bereitstellungsprotokolle enthalten die Protokollausgabe der Build- und Bereitstellungsschritte, die App Runner ausführt, wenn Sie einen Dienst erstellen oder eine neue Version Ihrer Anwendung bereitstellen. Die Namen der Bereitstellungsprotokolldatenströme beginnen mit `deployment/` und enden mit der ID des Vorgangs, der die Bereitstellung durchführt. Bei diesem Vorgang handelt es sich entweder um einen [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)Aufruf für die erste Anwendungsbereitstellung oder um einen [StartDeployment](https://docs.aws.amazon.com/apprunner/latest/api/API_StartDeployment.html)Aufruf für jede weitere Bereitstellung. Innerhalb eines Bereitstellungsprotokolls beginnt jede Protokollnachricht mit einem Präfix: + `[AppRunner]`— Ausgabe, die App Runner während der Bereitstellung generiert. + `[Build]`— Ausgabe Ihrer eigenen Build-Skripte. | **Name des Log-Streams** | **Beispiel** | | --- | --- | | `events` | *N/A (fester Name)* | | `operation-type/operation-id` | `deployment/c2c8eeedea164f459cf78f12a8953390` | ### Anwendungsprotokolle Die Anwendungsprotokollgruppe enthält die Ausgabe Ihres laufenden Anwendungscodes. | **Name der Protokollgruppe** | **Beispiel** | | --- | --- | | `/aws/apprunner/service-name/service-id/application` | `/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/application` | Innerhalb der Anwendungsprotokollgruppe erstellt App Runner einen Protokollstream für jede Instanz (Skalierungseinheit), auf der Ihre Anwendung ausgeführt wird. | **Name des Protokollstreams** | **Beispiel** | | --- | --- | | `instance/instance-id` | `instance/1a80bc9134a84699b7b3432ebeebb591` | ## App Runner-Protokolle in der Konsole anzeigen Die App Runner-Konsole zeigt eine Zusammenfassung aller Protokolle für Ihren Dienst an und ermöglicht es Ihnen, sie anzusehen, zu durchsuchen und herunterzuladen. **Um Protokolle für Ihren Service anzuzeigen** 1. Öffnen Sie die [App Runner-Konsole](https://console.aws.amazon.com/apprunner) und wählen Sie in der Liste der **Regionen** Ihre aus AWS-Region. 1. Wählen Sie im Navigationsbereich **Dienste** und dann Ihren App Runner-Dienst aus. In der Konsole wird das Service-Dashboard mit einer **Serviceübersicht** angezeigt. ![\[App Runner Service-Dashboard-Seite mit Aktivitätsliste\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/console-dashboard.png) 1. Wählen Sie auf der Service-Dashboard-Seite den Tab **Logs** aus. Die Konsole zeigt einige Arten von Protokollen in verschiedenen Abschnitten an: + **Ereignisprotokoll** — Aktivität im Lebenszyklus Ihres App Runner-Dienstes. Die Konsole zeigt die neuesten Ereignisse an. + **Bereitstellungsprotokolle** — Quell-Repository-Bereitstellungen für Ihren App Runner-Dienst. Die Konsole zeigt für jede Bereitstellung einen separaten Protokollstream an. + **Anwendungsprotokolle** — Die Ausgabe der Webanwendung, die für Ihren App Runner-Dienst bereitgestellt wurde. Die Konsole kombiniert die Ausgabe aller laufenden Instanzen in einem einzigen Protokollstream. ![\[Der Tab Logs auf der App Runner Service-Dashboard-Seite\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/service-dashboad-logs.png) 1. Um nach bestimmten Bereitstellungen zu suchen, suchen Sie in der Liste der Bereitstellungsprotokolle nach unten, indem Sie einen Suchbegriff eingeben. Sie können nach jedem Wert suchen, der in der Tabelle erscheint. 1. Um den Inhalt eines Protokolls anzuzeigen, wählen Sie **Vollständiges Protokoll anzeigen (Ereignisprotokoll**) oder den Namen des Protokolldatenstroms (Bereitstellungs- und Anwendungsprotokolle). 1. Wählen Sie **Herunterladen**, um ein Protokoll herunterzuladen. Wählen Sie für einen Bereitstellungsprotokollstream zunächst einen Protokollstream aus. 1. Wählen Sie **Anzeigen in CloudWatch**, um die CloudWatch Konsole zu öffnen und alle Funktionen zu nutzen, um Ihre App Runner-Serviceprotokolle zu durchsuchen. Wählen Sie für einen Deployment-Log-Stream zunächst einen Log-Stream aus. **Anmerkung** Die CloudWatch Konsole ist besonders nützlich, wenn Sie anstelle des kombinierten Anwendungsprotokolls Anwendungsprotokolle bestimmter Instanzen anzeigen möchten. # App Runner-Servicemetriken anzeigen, an die gemeldet wurden CloudWatch Amazon CloudWatch überwacht Ihre Amazon Web Services (AWS) -Ressourcen und die Anwendungen, auf denen Sie laufen, AWS in Echtzeit. Sie können CloudWatch damit Metriken sammeln und verfolgen. Dabei handelt es sich um Variablen, die Sie für Ihre Ressourcen und Anwendungen messen können. Sie können es auch verwenden, um Alarme zu erstellen, die Metriken überwachen. Wenn ein bestimmter Schwellenwert erreicht ist, werden Benachrichtigungen CloudWatch gesendet oder automatisch Änderungen an den überwachten Ressourcen vorgenommen. Weitere Informationen finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). AWS App Runner sammelt eine Vielzahl von Metriken, die Ihnen einen besseren Einblick in die Nutzung, Leistung und Verfügbarkeit Ihrer App Runner-Dienste bieten. Einige Metriken verfolgen einzelne Instanzen, auf denen Ihr Webservice ausgeführt wird, während andere sich auf die allgemeine Service-Ebene beziehen. In den folgenden Abschnitten werden App Runner-Metriken aufgeführt und Sie erfahren, wie Sie sie in der App Runner-Konsole anzeigen können. ## App Runner-Metriken App Runner sammelt die folgenden Metriken zu Ihrem Service und veröffentlicht sie CloudWatch im `AWS/AppRunner` Namespace. **Anmerkung** Vor dem 23. August 2023 basierten die Metriken zur **CPU-Auslastung** und zur **Speicherauslastung** auf den genutzten vCPU-Einheiten und Megabyte an Arbeitsspeicher und nicht auf der *prozentualen Auslastung*, wie heute berechnet. Wenn Ihre Anwendung vor diesem Datum auf App Runner ausgeführt wurde und Sie die Metriken für dieses Datum entweder im App Runner oder auf der CloudWatch Konsole erneut anzeigen möchten, werden die Messwerte in beiden Einheiten angezeigt, was auch zu Unregelmäßigkeiten führt. **Wichtig** Sie müssen alle CloudWatch Alarme, die auf den Metrikwerten *CPU-Auslastung* und *Speicherauslastung* basieren, vor dem 23. August 2023 aktualisieren. Aktualisieren Sie die Alarme so, dass sie auf der Grundlage der prozentualen Auslastung und nicht auf der Grundlage von vCPU oder Megabyte ausgelöst werden. Weitere Informationen finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). **Metriken auf Instance-Ebene** werden für jede Instance (Skalierungseinheit) einzeln erfasst. | **Was wird gemessen?** | **Metrik** | **Beschreibung** | | --- | --- | --- | | CPU utilization | `CPUUtilization` | Der prozentuale Anteil der durchschnittlichen CPU-Auslastung über Zeiträume von einer Minute an der gesamten CPU-Auslastung, die für die Dienstkonfiguration reserviert ist. | | Memory utilization | `MemoryUtilization` | Der prozentuale Anteil der durchschnittlichen Speicherauslastung über Zeiträume von einer Minute am gesamten durch die Servicekonfiguration reservierten Speicher. | **Service-Level-Metriken** werden für den gesamten Service erfasst. | **Was wird gemessen?** | **Metrik** | **Beschreibung** | | --- | --- | --- | | CPU utilization | `CPUUtilization` | Der prozentuale Anteil der aggregierten CPU-Auslastung aller Instances während eines Zeitraums von einer Minute an der gesamten CPU-Auslastung, die durch die Dienstkonfiguration reserviert ist. | | Memory utilization | `MemoryUtilization` | Der prozentuale Anteil der aggregierten Speicherauslastung aller Instances während eines Zeitraums von einer Minute am gesamten durch die Dienstkonfiguration reservierten Speicher. | | Concurrency | `Concurrency` | Die ungefähre Anzahl gleichzeitiger Anfragen, die vom Dienst bearbeitet werden. | | HTTP request count | `Requests` | Die Anzahl der HTTP-Anfragen, die der Dienst erhalten hat. | | HTTP status counts | `2xxStatusResponses` `4xxStatusResponses` `5xxStatusResponses` | Die Anzahl der HTTP-Anfragen, die jeden Antwortstatus zurückgegeben haben, gruppiert nach Kategorien (2XX, 4XX, 5XX). | | HTTP request latency | `RequestLatency` | Die Zeit in Millisekunden, die Ihr Webservice für die Verarbeitung von HTTP-Anfragen benötigt hat. | | Instance counts | `ActiveInstances` | Die Anzahl der Instanzen, die HTTP-Anfragen für Ihren Service verarbeiten. Wenn die `ActiveInstances` Metrik Null anzeigt, bedeutet dies, dass keine Anfragen für den Service vorliegen. Dies bedeutet nicht, dass die Anzahl der Instanzen für Ihren Service Null ist. | ## App Runner-Metriken in der Konsole anzeigen Die App Runner-Konsole zeigt die Metriken, die App Runner für Ihren Service erfasst, grafisch an und bietet weitere Möglichkeiten, sie zu untersuchen. **Anmerkung** Derzeit zeigt die Konsole nur Servicemetriken an. Verwenden Sie die CloudWatch Konsole, um Instanzmetriken anzuzeigen. **Um Logs für Ihren Service einzusehen** 1. Öffnen Sie die [App Runner-Konsole](https://console.aws.amazon.com/apprunner) und wählen Sie in der Liste der **Regionen** Ihre aus AWS-Region. 1. Wählen Sie im Navigationsbereich **Dienste** und dann Ihren App Runner-Dienst aus. In der Konsole wird das Service-Dashboard mit einer **Serviceübersicht** angezeigt. ![\[App Runner Service-Dashboard-Seite mit Aktivitätsliste\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/console-dashboard.png) 1. Wählen Sie auf der Service-Dashboard-Seite den Tab **Metriken** aus. Die Konsole zeigt eine Reihe von Metrikdiagrammen an. ![\[Der Tab Metriken auf der App Runner Service-Dashboard-Seite\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/service-dashboad-metrics.png) 1. Wählen Sie eine Dauer (z. B. **12 Stunden**), um die Metrikdiagramme auf den letzten Zeitraum dieser Dauer einzubeziehen. 1. Wählen Sie oben in einem der Diagrammbereiche die Option Zum **Dashboard hinzufügen** aus oder verwenden Sie das Menü eines beliebigen Diagramms, um die relevanten Metriken zur weiteren Untersuchung zu einem Dashboard in der CloudWatch Konsole hinzuzufügen. # Umgang mit App Runner-Ereignissen in EventBridge Mit Amazon EventBridge können Sie ereignisgesteuerte Regeln einrichten, die einen Stream von Echtzeitdaten aus Ihrem AWS App Runner Service auf bestimmte Muster hin überwachen. Wenn ein Muster für eine Regel übereinstimmt, wird eine Aktion in einem Ziel wie AWS Lambda Amazon ECS und Amazon AWS Batch SNS EventBridge initiiert. Sie können beispielsweise eine Regel für das Versenden von E-Mail-Benachrichtigungen festlegen, indem Sie ein Amazon SNS SNS-Thema signalisieren, wenn eine Bereitstellung für Ihren Service fehlschlägt. Oder du kannst eine Lambda-Funktion einrichten, um einen Slack-Channel zu benachrichtigen, wenn ein Service-Update fehlschlägt. Weitere Informationen zu EventBridge finden Sie im [ EventBridge Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/). App Runner sendet die folgenden Ereignistypen an EventBridge + *Änderung des Dienststatus* — Eine Änderung des Status eines App Runner-Dienstes. Zum Beispiel wurde ein Dienststatus in geändert`DELETE_FAILED`. + *Änderung des Status des Dienstvorgangs* — Eine Änderung des Status eines langen, asynchronen Vorgangs in einem App Runner-Dienst. Zum Beispiel, wenn mit der Erstellung eines Dienstes begonnen wurde, ein Dienstupdate erfolgreich abgeschlossen wurde oder eine Dienstbereitstellung mit Fehlern abgeschlossen wurde. ## Eine EventBridge Regel erstellen, die auf App Runner-Ereignisse reagiert Ein EventBridge *Ereignis* ist ein Objekt, das einige EventBridge Standardfelder wie den AWS Quelldienst und den Detailtyp (Ereignis) sowie einen ereignisspezifischen Satz von Feldern mit den Ereignisdetails definiert. Um eine EventBridge Regel zu erstellen, verwenden Sie die EventBridge Konsole, um ein *Ereignismuster* zu definieren (welche Ereignisse verfolgt werden sollen) und eine *Zielaktion* (was bei einem Spiel geschehen soll) festzulegen. Ein Ereignismuster ähnelt den Ereignissen, denen es entspricht. Sie geben eine Teilmenge von Feldern an, die abgeglichen werden sollen, und für jedes Feld geben Sie eine Liste möglicher Werte an. Dieses Thema enthält Beispiele für App Runner-Ereignisse und -Ereignismuster. Weitere Informationen zum Erstellen von EventBridge Regeln finden Sie unter [Regel für einen AWS Service erstellen](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) im * EventBridge Amazon-Benutzerhandbuch*. **Anmerkung** Einige Dienste unterstützen *vordefinierte Muster* in EventBridge. Dies vereinfacht die Erstellung eines Ereignismusters. Sie wählen Feldwerte in einem Formular aus und EventBridge generieren das Muster für Sie. Derzeit unterstützt App Runner keine vordefinierten Muster. Sie müssen das Muster als JSON-Objekt eingeben. Sie können die Beispiele in diesem Thema als Ausgangspunkt verwenden. ## Beispiele für App Runner-Ereignisse Dies sind einige Beispiele für Ereignisse, an die App Runner sendet EventBridge. + Ein Ereignis zur Änderung des Dienststatus. Insbesondere ein Dienst, der vom in `OPERATION_IN_PROGRESS` den `RUNNING` Status geändert wurde. ``` { "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "AppRunner Service Status Change", "source": "aws.apprunner", "account": "111122223333", "time": "2021-04-29T11:54:23Z", "region": "us-east-2", "resources": [ "arn:aws:apprunner:us-east-2:123456789012:service/my-app/8fe1e10304f84fd2b0df550fe98a71fa" ], "detail": { "previousServiceStatus": "OPERATION_IN_PROGRESS", "currentServiceStatus": "RUNNING", "serviceName": "my-app", "serviceId": "8fe1e10304f84fd2b0df550fe98a71fa", "message": "Service status is set to RUNNING.", "severity": "INFO" } } ``` + Ein Ereignis zur Änderung des Betriebsstatus. Insbesondere ein `UpdateService` Vorgang, der erfolgreich abgeschlossen wurde. ``` { "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "AppRunner Service Operation Status Change", "source": "aws.apprunner", "account": "111122223333", "time": "2021-04-29T18:43:48Z", "region": "us-east-2", "resources": [ "arn:aws:apprunner:us-east-2:123456789012:service/my-app/8fe1e10304f84fd2b0df550fe98a71fa" ], "detail": { "operationStatus": "UpdateServiceCompletedSuccessfully", "serviceName": "my-app", "serviceId": "8fe1e10304f84fd2b0df550fe98a71fa", "message": "Service update completed successfully. New application and configuration is deployed.", "severity": "INFO" } } ``` ## Beispiele für App Runner-Ereignismuster Die folgenden Beispiele zeigen Ereignismuster, die Sie in EventBridge Regeln verwenden können, um einem oder mehreren App Runner-Ereignissen zuzuordnen. Ein Ereignismuster ähnelt einem Ereignis. Schließen Sie nur die Felder ein, die Sie zuordnen möchten, und stellen Sie für jedes Feld eine Liste statt eines Skalars bereit. + Ordnet alle Ereignisse zur Änderung des Dienststatus für Dienste eines bestimmten Kontos zu, bei dem sich der Dienst nicht mehr im `RUNNING` Status befindet. ``` { "detail-type": [ "AppRunner Service Status Change" ], "source": [ "aws.apprunner" ], "account": [ "111122223333" ], "detail": { "previousServiceStatus": [ "RUNNING" ] } } ``` + Ordnet alle Ereignisse zur Änderung des Vorgangsstatus für Dienste eines bestimmten Kontos zu, bei dem der Vorgang fehlgeschlagen ist. ``` { "detail-type": [ "AppRunner Service Operation Status Change" ], "source": [ "aws.apprunner" ], "account": [ "111122223333" ], "detail": { "operationStatus": [ "CreateServiceFailed", "DeleteServiceFailed", "UpdateServiceFailed", "DeploymentFailed", "PauseServiceFailed", "ResumeServiceFailed" ] } } ``` ## Referenz zum App Runner-Ereignis ### Änderung des Dienststatus Ein Ereignis zur Änderung des Servicestatus wurde auf `detail-type` gesetzt`AppRunner Service Status Change`. Es hat die folgenden Detailfelder und Werte: ``` "serviceId": "your service ID", "serviceName": "your service name", "message": "Service status is set to CurrentStatus.", "previousServiceStatus": "any valid service status", "currentServiceStatus": "any valid service status", "severity": "varies" ``` ### Änderung des Betriebsstatus Ein Ereignis zur Änderung des Betriebsstatus wurde auf `detail-type` gesetzt`AppRunner Service Operation Status Change`. Es hat die folgenden Detailfelder und Werte: ``` "operationStatus": "see following table", "serviceName": "your service name", "serviceId": "your service ID", "message": "see following table", "severity": "varies" ``` In der folgenden Tabelle sind alle möglichen Statuscodes und zugehörigen Meldungen aufgeführt. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/monitor-ev.html) # App Runner API-Aufrufe protokollieren mit AWS CloudTrail App Runner ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Dienst in App Runner ausgeführt wurden. CloudTrailerfasst alle API-Aufrufe für App Runner als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der App Runner-Konsole und Codeaufrufen für die App Runner-API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für App Runner. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von gesammelten Informationen können Sie die Anfrage CloudTrail, die an App Runner gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln. Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Informationen zu App Runner finden Sie unter CloudTrail CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn in App Runner Aktivitäten auftreten, wird diese Aktivität zusammen mit anderen CloudTrail AWS Dienstereignissen im **Ereignisverlauf in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem anzeigen, suchen und herunterladen AWS-Konto. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto, einschließlich der Ereignisse für App Runner, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier: + [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Alle App Runner-Aktionen werden von der AWS App Runner API-Referenz protokolliert CloudTrail und sind in dieser dokumentiert. Aufrufe der `StartDeployment` Aktionen `CreateService``DeleteConnection`, und generieren beispielsweise Einträge in den CloudTrail Protokolldateien. Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte: + Gibt an, ob die Anforderung mit Root- oder IAM-Benutzer-Anmeldeinformationen ausgeführt wurde. + Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde. + Ob die Anfrage von einem anderen AWS Dienst gestellt wurde. Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Grundlegendes zu App Runner-Protokolldateieinträgen Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion sowie Anforderungsparameter. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden. Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `CreateService` Aktion demonstriert. **Anmerkung** Aus Sicherheitsgründen werden einige Eigenschaftswerte in den Protokollen geschwärzt und durch den Text `HIDDEN_DUE_TO_SECURITY_REASONS` ersetzt. Dies verhindert die unbeabsichtigte Offenlegung geheimer Informationen. Sie können jedoch immer noch sehen, dass diese Eigenschaften in der Anfrage übergeben oder in der Antwort zurückgegeben wurden. ### Beispiel für einen CloudTrail Protokolleintrag für die `CreateService` App Runner-Aktion ``` { "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::123456789012:user/aws-user", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "aws-user" }, "eventTime": "2020-10-02T23:25:33Z", "eventSource": "apprunner.amazonaws.com", "eventName": "CreateService", "awsRegion": "us-east-2", "sourceIPAddress": "192.0.2.0", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.75 Safari/537.36", "requestParameters": { "serviceName": "python-test", "sourceConfiguration": { "codeRepository": { "repositoryUrl": "https://github.com/github-user/python-hello", "sourceCodeVersion": { "type": "BRANCH", "value": "main" }, "codeConfiguration": { "configurationSource": "API", "codeConfigurationValues": { "runtime": "python3", "buildCommand": "HIDDEN_DUE_TO_SECURITY_REASONS", "startCommand": "HIDDEN_DUE_TO_SECURITY_REASONS", "port": "8080", "runtimeEnvironmentVariables": "HIDDEN_DUE_TO_SECURITY_REASONS" } } }, "autoDeploymentsEnabled": true, "authenticationConfiguration": { "connectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/your-connection/e7656250f67242d7819feade6800f59e" } }, "healthCheckConfiguration": { "protocol": "HTTP" }, "instanceConfiguration": { "cpu": "256", "memory": "1024" } }, "responseElements": { "service": { "serviceName": "python-test", "serviceId": "dfa2b7cc7bcb4b6fa6c1f0f4efff988a", "serviceArn": "arn:aws:apprunner:us-east-2:123456789012:service/python-test/dfa2b7cc7bcb4b6fa6c1f0f4efff988a", "serviceUrl": "generated domain", "createdAt": "2020-10-02T23:25:32.650Z", "updatedAt": "2020-10-02T23:25:32.650Z", "status": "OPERATION_IN_PROGRESS", "sourceConfiguration": { "codeRepository": { "repositoryUrl": "https://github.com/github-user/python-hello", "sourceCodeVersion": { "type": "Branch", "value": "main" }, "sourceDirectory": "/", "codeConfiguration": { "codeConfigurationValues": { "configurationSource": "API", "runtime": "python3", "buildCommand": "HIDDEN_DUE_TO_SECURITY_REASONS", "startCommand": "HIDDEN_DUE_TO_SECURITY_REASONS", "port": "8080", "runtimeEnvironmentVariables": "HIDDEN_DUE_TO_SECURITY_REASONS" } } }, "autoDeploymentsEnabled": true, "authenticationConfiguration": { "connectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/your-connection/e7656250f67242d7819feade6800f59e" } }, "healthCheckConfiguration": { "protocol": "HTTP", "path": "/", "interval": 5, "timeout": 2, "healthyThreshold": 3, "unhealthyThreshold": 5 }, "instanceConfiguration": { "cpu": "256", "memory": "1024" }, "autoScalingConfigurationSummary": { "autoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001", "autoScalingConfigurationName": "DefaultConfiguration", "autoScalingConfigurationRevision": 1 } } }, "requestID": "1a60af60-ecf5-4280-aa8f-64538319ba0a", "eventID": "e1a3f623-4d24-4390-a70b-bf08a0e24669", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ``` # Tracing für Ihre App Runner-Anwendung mit X-Ray AWS X-Ray ist ein Dienst, der Daten über Anfragen sammelt, die Ihre Anwendung bearbeitet, und Tools bereitstellt, mit denen Sie diese Daten anzeigen, filtern und Einblicke in sie gewinnen können, um Probleme und Optimierungsmöglichkeiten zu identifizieren. Zu jeder verfolgten Anfrage an Ihre Anwendung können Sie detaillierte Informationen nicht nur über die Anfrage und Antwort abrufen, sondern auch über Aufrufe, die Ihre Anwendung an nachgelagerte AWS Ressourcen, Microservices, Datenbanken und das HTTP-Web sendet. APIs X-Ray verwendet Trace-Daten aus den AWS Ressourcen, die Ihre Cloud-Anwendungen unterstützen, um ein detailliertes Service-Diagramm zu erstellen. Das Servicediagramm zeigt den Client, Ihren Frontend-Service und die Backend-Services, die Ihr Frontend-Services für die Verarbeitung von Anforderungen und Persistenzdaten aufruft. Sie können das Servicediagramms zur Ermittlung von Engpässen, Latenzspitzen und anderen Problemen verwenden, die Sie zur Verbesserung der Leistung Ihrer Anwendungen beheben können. Weitere Informationen zu X-Ray finden Sie im [Entwicklerhandbuch für AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/). ![\[Ein Beispiel für eine X-Ray-Servicekarte für einen App Runner-Dienst\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/xray-example.png) ## Instrumentieren Sie Ihre Anwendung für die Rückverfolgung Instrumentieren Sie Ihre App Runner-Dienstanwendung für die Ablaufverfolgung mithilfe [OpenTelemetry](https://github.com/open-telemetry)einer portablen Telemetriespezifikation. Derzeit unterstützt App Runner [AWS Distro for OpenTelemetry](https://aws-otel.github.io/docs/introduction) (ADOT), eine OpenTelemetry Implementierung, die Telemetriedaten mithilfe von Diensten sammelt und präsentiert. AWS X-Ray implementiert die Tracing-Komponente. *Abhängig vom spezifischen ADOT-SDK, das Sie in Ihrer Anwendung verwenden, unterstützt ADOT bis zu zwei Instrumentierungsansätze: *automatisch* und manuell.* Weitere Informationen zur Instrumentierung mit Ihrem SDK finden Sie in der [ADOT-Dokumentation](https://aws-otel.github.io/docs/introduction). Wählen Sie im Navigationsbereich Ihr SDK aus. ### Runtime-Setup Im Folgenden finden Sie allgemeine Anweisungen zur Runtime-Setup, mit denen Sie Ihre App Runner-Dienstanwendung für die Ablaufverfolgung instrumentieren können. **So richten Sie die Ablaufverfolgung für Ihre Laufzeit ein** 1. Folgen Sie den Anweisungen für Ihre Laufzeit in [AWS Distro for OpenTelemetry](https://aws-otel.github.io/docs/introduction) (ADOT), um Ihre Anwendung zu instrumentieren. 1. Installieren Sie die erforderlichen `OTEL` Abhängigkeiten im `build` Abschnitt der `apprunner.yaml` Datei, wenn Sie das Quellcode-Repository verwenden, oder im Dockerfile, wenn Sie ein Container-Image verwenden. 1. Richten Sie Ihre Umgebungsvariablen in der `apprunner.yaml` Datei ein, wenn Sie das Quellcode-Repository verwenden, oder im Dockerfile, wenn Sie ein Container-Image verwenden. **Example Umgebungsvariablen** **Anmerkung** Das folgende Beispiel listet die wichtigen Umgebungsvariablen auf, die der `apprunner.yaml` Datei hinzugefügt werden sollen. Fügen Sie diese Umgebungsvariablen zu Ihrem Dockerfile hinzu, wenn Sie ein Container-Image verwenden. Jede Laufzeit kann jedoch ihre eigenen Eigenheiten haben, und Sie müssen der folgenden Liste möglicherweise weitere Umgebungsvariablen hinzufügen. *Weitere Informationen zu Ihren runtime-spezifischen Anweisungen und Beispiele zur Einrichtung Ihrer Anwendung für Ihre Runtime finden Sie unter [AWS Distribution for OpenTelemetry](https://aws-otel.github.io/docs/introduction) und Go to your runtime unter Getting Started.* ``` env: - name: OTEL_PROPAGATORS value: xray - name: OTEL_METRICS_EXPORTER value: none - name: OTEL_EXPORTER_OTLP_ENDPOINT value: http://localhost:4317 - name: OTEL_RESOURCE_ATTRIBUTES value: 'service.name=example_app' ``` **Anmerkung** `OTEL_METRICS_EXPORTER=none`ist eine wichtige Umgebungsvariable für App Runner, da der App Runner Otel Collector keine Metrikprotokollierung akzeptiert. Er akzeptiert nur die Nachverfolgung von Metriken. ### Beispiel für die Einrichtung einer Laufzeit Das folgende Beispiel zeigt die automatische Instrumentierung Ihrer Anwendung mit dem [ADOT Python SDK](https://aws-otel.github.io/docs/getting-started/python-sdk). Das SDK erzeugt automatisch Spans mit Telemetriedaten, die die Werte beschreiben, die von den Python-Frameworks in Ihrer Anwendung verwendet werden, ohne eine einzige Zeile Python-Code hinzuzufügen. Sie müssen nur ein paar Zeilen in zwei Quelldateien hinzufügen oder ändern. Fügen Sie zunächst einige Abhängigkeiten hinzu, wie im folgenden Beispiel gezeigt. **Example requirements.txt** ``` opentelemetry-distro[otlp]>=0.24b0 opentelemetry-sdk-extension-aws~=2.0 opentelemetry-propagator-aws-xray~=1.0 ``` Instrumentieren Sie dann Ihre Anwendung. Die Art und Weise, wie Sie dies tun, hängt von Ihrer Service-Quelle ab — Quellbild oder Quellcode. ------ #### [ Source image ] Wenn es sich bei Ihrer Servicequelle um ein Image handelt, können Sie das Dockerfile, das die Erstellung Ihres Container-Images und die Ausführung der Anwendung im Image steuert, direkt instrumentieren. Das folgende Beispiel zeigt ein instrumentiertes Dockerfile für eine Python-Anwendung. Hinzufügungen zur Instrumentierung sind fett hervorgehoben. **Example Dockerfile** ``` FROM public.ecr.aws/amazonlinux/amazonlinux:latest RUN yum install python3.7 -y && curl -O https://bootstrap.pypa.io/get-pip.py && python3 get-pip.py && yum update -y COPY . /app WORKDIR /app RUN pip3 install -r requirements.txt RUN opentelemetry-bootstrap --action=install ENV OTEL_PYTHON_DISABLED_INSTRUMENTATIONS=urllib3 ENV OTEL_METRICS_EXPORTER=none ENV OTEL_RESOURCE_ATTRIBUTES='service.name=example_app' CMD OTEL_PROPAGATORS=xray OTEL_PYTHON_ID_GENERATOR=xray opentelemetry-instrument python3 app.py EXPOSE 8080 ``` ------ #### [ Source code repository ] Wenn Ihre Dienstquelle ein Repository ist, das Ihre Anwendungsquelle enthält, instrumentieren Sie Ihr Image indirekt mithilfe der Einstellungen der App Runner-Konfigurationsdatei. Diese Einstellungen steuern das Dockerfile, das App Runner generiert und verwendet, um das Image für Ihre Anwendung zu erstellen. Das folgende Beispiel zeigt eine instrumentierte App Runner-Konfigurationsdatei für eine Python-Anwendung. Hinzufügungen zur Instrumentierung sind fett hervorgehoben. **Example apprunner.yaml** ``` version: 1.0 runtime: python3 build: commands: build: - pip install -r requirements.txt - opentelemetry-bootstrap --action=install run: command: opentelemetry-instrument python app.py network: port: 8080 env: - name: OTEL_PROPAGATORS value: xray - name: OTEL_METRICS_EXPORTER value: none - name: OTEL_PYTHON_ID_GENERATOR value: xray - name: OTEL_PYTHON_DISABLED_INSTRUMENTATIONS value: urllib3 - name: OTEL_RESOURCE_ATTRIBUTES value: 'service.name=example_app' ``` ------ ## X-Ray-Berechtigungen zu Ihrer App Runner-Dienstinstanzrolle hinzufügen Um X-Ray Tracing mit Ihrem App Runner-Dienst verwenden zu können, müssen Sie den Instanzen des Dienstes Berechtigungen für die Interaktion mit dem X-Ray-Dienst erteilen. Dazu ordnen Sie Ihrem Service eine Instanzrolle zu und fügen eine verwaltete Richtlinie mit X-Ray-Berechtigungen hinzu. Weitere Informationen zu einer App Runner-Instanzrolle finden Sie unter[Instance-Rolle](security_iam_service-with-iam.md#security_iam_service-with-iam-roles-service.instance). Fügen Sie die `AWSXRayDaemonWriteAccess` verwaltete Richtlinie zu Ihrer Instanzrolle hinzu und weisen Sie sie bei der Erstellung Ihrem Service zu. ## X-Ray-Tracing für Ihren App Runner-Dienst aktivieren Wenn Sie [einen Dienst erstellen](manage-create.md), deaktiviert App Runner die Ablaufverfolgung standardmäßig. Sie können X-Ray Tracing für Ihren Service als Teil der Konfiguration von Observability aktivieren. Weitere Informationen finden Sie unter [Beobachtbarkeit verwalten](manage-configure-observability.md#manage-configure-observability.manage). Wenn Sie die App Runner-API oder die verwenden AWS CLI, enthält das [TraceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_TraceConfiguration.html)Objekt innerhalb des [ObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_ObservabilityConfiguration.html)Ressourcenobjekts Tracing-Einstellungen. Um die Ablaufverfolgung weiterhin zu deaktivieren, geben Sie kein `TraceConfiguration` Objekt an. Stellen Sie sowohl bei der Konsole als auch bei der API sicher, dass Sie Ihre im vorherigen Abschnitt beschriebene Instanzrolle Ihrem App Runner-Dienst zuordnen. ## Sehen Sie sich die X-Ray-Tracing-Daten für Ihren App Runner-Dienst an Wählen Sie auf der Registerkarte **Observability** der [Service-Dashboard-Seite](console.md#console.dashboard) in der App Runner-Konsole die Option **Service Map anzeigen** aus, um zur CloudWatch Amazon-Konsole zu navigieren. ![\[App Runner-Service-Dashboard-Seite mit dem Tab „Observability“\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/service-dashboad-observability.png) Verwenden Sie die CloudWatch Amazon-Konsole, um Service-Maps und Traces für Anfragen anzuzeigen, die Ihre Anwendung bearbeitet. Service Maps zeigen Informationen wie die Latenz von Anfragen und Interaktionen mit anderen Anwendungen und AWS Diensten. Mit den benutzerdefinierten Anmerkungen, die Sie Ihrem Code hinzufügen, können Sie ganz einfach nach Spuren suchen. Weitere Informationen finden Sie unter [Verwendung ServiceLens zur Überwachung des Zustands Ihrer Anwendungen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ServiceLens.html) im * CloudWatch Amazon-Benutzerhandbuch*.