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 von Serviceereignissen

Service Events bietet automatisierte, umfassende Beobachtbarkeit für Services, die mit CloudWatch Application Signals überwacht werden. Es erfasst Fehlermetriken, Leistungsdaten auf Funktionsebene, Snapshots von Vorfällen (wenn Anfragen Latenzschwellenwerte überschreiten oder Ausnahmen auslösen) und Bereitstellungsereignisse — ohne zusätzliche Codeänderungen.

So funktionieren Serviceereignisse

Service Events sammelt 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 Ausnahmeverfolgung sind sofort aktiv. Function-call Metriken erfordern eine zusätzliche Konfiguration — Sie müssen Pakete für die Instrumentierung konfigurieren, bevor Daten zu Funktionsaufrufen erfasst werden (sieheFunktionsinstrumentierung aktivieren). Serviceereignisse können per 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-nameProtokollgruppen) 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 service-name es sich um den Wert Ihrer OTEL_SERVICE_NAME Umgebungsvariablen handelt. Pro Dienst wird eine Protokollgruppe erstellt.

Die Aufnahme und Speicherung von Protokollen wird Ihnen zu den CloudWatch Standardtarifen für Logs in Rechnung gestellt.

Fehler in der Konsole anzeigen

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

Auf der Registerkarte werden angezeigt:

Wählen Sie eine Ausnahme aus, um Details wie den Stack-Trace, die Ausnahmemeldung und einen Link zum zugehörigen Trace aufzuschlüsseln.

Fehler werden nach Operation, Ausnahmetyp und Top-Stack-Frames gruppiert. Es wird nur der jüngste Vertreter jeder Gruppe 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 mit CloudWatch Logs Insights abfragen, um benutzerdefinierte Ansichten zu erstellen, Dashboards zu erstellen oder bestimmte Vorfälle zu untersuchen.

So fragen Sie Serviceereignisse ab:

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

Auf die Daten von Serviceereignissen kann über den MCP-Server (Model Context Protocol) von CloudWatch Application Signals 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 der Website auf dem MCP-Server von Application Signals. GitHub

Konfigurieren Sie Dienstereignisse

Voraussetzungen

Um Serviceereignisse verwenden zu können, stellen Sie sicher, dass Sie über die mindestens erforderlichen Versionen der folgenden Komponenten verfügen:

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

Funktionen sind standardmäßig aktiviert

Wenn Sie CloudWatch Application Signals verwenden, sind die folgenden Service-Event-Signale 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

Funktionsinstrumentierung aktivieren

Die Funktionsinstrumentierung ist standardmäßig aktiviert, erzeugt aber keine Metriken, bis Sie konfiguriert haben, welche Pakete instrumentiert werden sollen. Stellen Sie eine Liste mit den erlaubten Paketen bereit, um mit der Erfassung von Telemetriedaten pro Funktion zu beginnen:

Endpunktfilterung

Die Endpunktfilterung steuert, welche Endgeräte Endpunktfehlermetriken und Vorfall-Snapshots generieren. Diese Einstellungen haben keinen Einfluss auf die Funktionsinstrumentierung.

Latenzschwellenwerte

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

Ratenbegrenzung

Verwenden Sie die folgenden Umgebungsvariablen, um die Geschwindigkeit zu steuern, mit der Daten zu Serviceereignissen gesammelt 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 bereichert, sodass Sie Vorfälle und Leistungsänderungen mit bestimmten Codebereitstellungen korrelieren können.

Legen Sie die folgenden Umgebungsvariablen für Ihre Anwendungscontainer oder -prozesse fest, um Bereitstellungsmetadaten bereitzustellen:

Konfigurieren Sie Bereitstellungsereignisse mit GitHub Aktionen

Verwenden Sie in Ihrem GitHub Aktionsablauf die integrierten Umgebungsvariablen, um Bereitstellungsmetadaten aufzufü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 während 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 die Bereitstellungsmetadaten aufzufüllen. Fügen Sie Ihrem Bereitstellungsjob 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).