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.

Überwachen Sie Serviceereignisse

Service Events bietet automatische detaillierte Beobachtbarkeit für Dienste, die mit CloudWatch Anwendungssignalen überwacht werden. Es erfasst Fehlermetriken, Leistungsdaten auf Funktionsebene, Momentaufnahmen von Vorfällen (wenn Anfragen Latenzschwellenwerte überschreiten oder Ausnahmen auslösen) und Bereitstellungsereignisse — ohne zusätzliche Codeänderungen.

So funktionieren Serviceereignisse

Service Events erfasst die folgenden Arten von Signalen von Ihren instrumentierten Diensten:

Service Events wird automatisch aktiviert, wenn Sie CloudWatch Application Signals für Ihren Service aktivieren. Fehlermetriken und Ausnahme-Tracking sind sofort aktiv. Function-call Für Metriken ist eine zusätzliche Konfiguration erforderlich. Sie müssen die Pakete für die Instrumente konfigurieren, bevor Daten zu Funktionsaufrufen erfasst werden (sieheAktivieren Sie die Funktionsinstrumentierung). Service Events können durch eine Einstellung deaktiviert werden. OTEL_AWS_SERVICE_EVENTS_ENABLED=false Daten fließen vom ADOT SDK zum CloudWatch Agenten. Der Agent veröffentlicht Ereignisse in CloudWatch Logs (/aws/service-events/service-nameLoggruppen) und CloudWatch Metriken.

Unterstützte Sprachen: Java, Python und Node.js.

Datenspeicher

Service Events speichert Daten in CloudWatch Protokollen. CloudWatch veröffentlicht Serviceereignisdaten in einer Protokollgruppe mit dem Präfix/aws/application-signals/service-name, wobei der Wert Ihrer OTEL_SERVICE_NAME Umgebungsvariablen service-name ist. Pro Dienst wird eine Protokollgruppe erstellt.

Das Aufnehmen und Speichern von Protokollen wird Ihnen zu den CloudWatch Standardtarifen für Protokolle in Rechnung gestellt.

Fehler in der Konsole anzeigen

Navigieren Sie in der CloudWatch Konsole zu Application Signals, wählen Sie Ihren Service aus und wählen Sie dann die Registerkarte Fehler. Auf dieser Registerkarte werden Ausnahmemetriken für Ihren Service angezeigt.

Auf der Registerkarte wird Folgendes angezeigt:

Wählen Sie eine Ausnahme aus, um detaillierte Informationen wie den Stack-Trace, die Ausnahmemeldung und einen Link zum zugehörigen Trace anzuzeigen.

Die Fehler werden nach Operation, Ausnahmetyp und Top-Stack-Frames gruppiert. Nur der neueste Vertreter jeder Gruppe wird angezeigt.

Serviceereignisse in Protokollen anzeigen

Daten zu Serviceereignissen werden in CloudWatch Protokollen unter Protokollgruppen mit dem Präfix gespeichert/aws/service-events/service-name. Sie können diese Daten direkt mithilfe von CloudWatch Logs Insights abfragen, um benutzerdefinierte Ansichten zu erstellen, Dashboards zu erstellen oder bestimmte Vorfälle zu untersuchen.

So fragen Sie Serviceereignisse ab:

Serviceereignisse auf dem CloudWatch Application Signals MCP (Model Context Protocol) -Server

Auf Daten zu Serviceereignissen kann über den CloudWatch Application Signals MCP-Server (Model Context Protocol) zugegriffen werden, sodass KI-Codierungsassistenten und -Agenten das Laufzeitverhalten Ihres Dienstes direkt abfragen können.

Fehlersuche

Verbesserung der Leistung

Anweisungen zur Einrichtung und Verwendung finden Sie auf dem Application Signals MCP-Server auf der Website. GitHub

Konfigurieren Sie Serviceereignisse

Voraussetzungen

Um Service Events verwenden zu können, stellen Sie sicher, dass Sie über die erforderlichen Mindestversionen der folgenden Komponenten verfügen:

Wenn Sie Amazon EKS verwenden, finden Sie Anweisungen Anwendungen auf Amazon-EKS-Clustern aktivieren zur Einrichtung des Add-Ons.

Funktionen sind standardmäßig aktiviert

Wenn Sie CloudWatch Anwendungssignale verwenden, sind die folgenden Signale für Serviceereignisse standardmäßig aktiviert, ohne dass eine zusätzliche Konfiguration erforderlich ist:

Die folgenden Funktionen sind optional und erfordern das Setzen von Umgebungsvariablen, um Daten zu erzeugen:

Allgemeine Einstellungen

Aktivieren Sie die Funktionsinstrumentierung

Die Funktionsinstrumentierung ist standardmäßig aktiviert, aber sie erzeugt keine Metriken, bis Sie konfigurieren, welche Pakete instrumentiert werden sollen. Stellen Sie eine Liste der zulässigen Pakete bereit, um mit der Erfassung der Telemetriedaten pro Funktion zu beginnen:

Filterung von Endpunkten

Die Endpunktfilterung steuert, welche Endpunkte Endpunktfehlermetriken und Vorfall-Snapshots generieren. Diese Einstellungen wirken sich nicht auf die Funktionsinstrumentierung aus.

Latenz-Schwellenwerte

Verwenden Sie die folgenden Umgebungsvariablen, um Latenzschwellenwerte für Incident-Snapshot-Trigger zu konfigurieren.

Ratenbegrenzung

Verwenden Sie die folgenden Umgebungsvariablen, um die Rate zu steuern, mit der Daten zu Serviceereignissen erfasst und gemeldet werden.

Konfigurieren Sie Bereitstellungsereignisse

Bereitstellungsereignisse werden immer beim Start der Anwendung und alle 24 Stunden ausgelöst. Durch die Bereitstellung von Bereitstellungsmetadaten werden diese Ereignisse angereichert, sodass Sie Vorfälle und Leistungsänderungen bestimmten Codebereitstellungen zuordnen können.

Stellen Sie die folgenden Umgebungsvariablen in Ihren Anwendungscontainern oder Prozessen ein, um Bereitstellungsmetadaten bereitzustellen:

Konfigurieren Sie Bereitstellungsereignisse mit GitHub Aktionen

Verwenden Sie in Ihrem GitHub Aktionsworkflow die integrierten Umgebungsvariablen, um Bereitstellungsmetadaten zu füllen. Fügen Sie Ihrem Bereitstellungsschritt oder Ihrer Container-Umgebung Folgendes hinzu:

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Wenn Sie Container-Images bereitstellen, übergeben Sie diese Werte als Umgebungsvariablen in Ihrer Aufgabendefinition oder Pod-Spezifikation. Sie können sie bei der Erstellung in das Image integrieren oder sie bei der Bereitstellung über Ihre Bereitstellungskonfiguration einfügen.

Konfigurieren Sie Bereitstellungsereignisse mit GitLab CI/CD

Verwenden Sie in Ihrer GitLab CI/CD Pipeline die vordefinierten CI/CD Variablen, um Deployment-Metadaten aufzufüllen. Fügen Sie Ihrem Bereitstellungsauftrag Folgendes hinzu:

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

Übergeben Sie diese Variablen bei der Bereitstellung über Ihre Container-Orchestrierungsplattform an Ihre Anwendungscontainer (z. B. als Umgebungsvariablen in Ihrer Amazon ECS-Aufgabendefinition oder Ihrem Kubernetes-Bereitstellungsmanifest).