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 von Anwendungen mit dynamischer Instrumentierung

Mit Dynamic Instrumentation können Sie den Laufzeitstatus einer Live-Anwendung erfassen, ohne sie neu starten oder erneut bereitstellen zu müssen. Der Laufzeitstatus umfasst Variablenwerte, Methodenargumente, Rückgabewerte und Stack-Traces. Sie definieren Instrumentierungskonfigurationen, die angeben, wo in Ihrem Code Daten erfasst werden sollen, und der ausgeführte Agent instrumentiert die Anwendung zur Laufzeit.

Konzepte

Unterstützte Sprachen

Voraussetzungen

Um Dynamic Instrumentation zu verwenden, aktualisieren Sie Ihre Instrumentierungskomponenten auf die neueste Version, die Ihrem Bereitstellungstyp entspricht:

Die folgenden Bedingungen müssen ebenfalls erfüllt sein:

Fügen Sie Ihrer Anwendung dynamische Instrumentierung hinzu

Nachdem Sie Ihre Anwendung instrumentiert haben (sieheVoraussetzungen), erstellen Sie eine Instrumentierungskonfiguration, die festlegt, für welchen Teil Ihres Codes Sie dynamische Telemetrie einführen möchten. Jede Konfiguration definiert zwei Dinge:

Sie können Konfigurationen mit der AWS CLI oder dem SDK oder mithilfe des Model Context Protocol (MCP) -Servers mit einem KI-Codierungsassistenten in Ihrer IDE erstellen.

Konfigurationen mit der CLI oder dem SDK erstellen

Verwenden Sie die AWS CLI oder das AWS SDK, um Instrumentierungskonfigurationen programmgesteuert zu erstellen.

Geben Sie den Speicherort des Codes an

Die Position definiert, wo in Ihrem Code die Instrumentierung angewendet wird. Die erforderlichen Felder unterscheiden sich je nach Sprache:

Konfigurieren Sie, welche Daten erfasst werden sollen

Die Capture-Konfiguration steuert, welcher Laufzeitstatus erfasst wird, wenn die Instrumentierung ausgelöst wird. Verfügbare Optionen:

Konfigurationsparameter

Wichtige Parameter beim Erstellen einer Konfiguration:

Beispiel

Das folgende Beispiel erstellt einen Breakpoint für eine Java-Methode:

aws application-signals create-instrumentation-configuration \
    --instrumentation-type BREAKPOINT \
    --service "my-service" \
    --environment "production" \
    --signal-type SNAPSHOT \
    --location '{
        "CodeLocation": {
            "Language": "Java",
            "CodeUnit": "com.example.service",
            "ClassName": "OrderController",
            "MethodName": "processOrder",
            "FilePath": "OrderController.java"
        }
    }' \
    --capture-configuration '{
        "CodeCapture": {
            "CaptureArguments": ["orderId", "user"],
            "CaptureReturn": true,
            "CaptureStackTrace": true,
            "CaptureLimits": {
                "MaxHits": 100,
                "MaxStringLength": 255,
                "MaxCollectionWidth": 20,
                "MaxObjectDepth": 3,
                "MaxFieldsPerObject": 20,
                "MaxStackFrames": 20
            }
        }
    }'

Erstellen Sie Konfigurationen mithilfe des MCP-Servers

Der empfohlene Ansatz für die Verwendung von Dynamic Instrumentation erfolgt über den MCP-Server (Model Context Protocol) von CloudWatch Application Signals. Mit dem MCP können KI-Codierungsassistenten und -Agenten in Ihrer IDE Konfigurationen für dynamische Instrumentierung direkt in Ihrer Entwicklungsumgebung erstellen, verwalten und abfragen.

Mit dem MCP kann Ihr KI-Assistent:

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

Datenspeicher

Wenn ein Breakpoint oder eine Probe ausgelöst wird, erstellt Dynamic Instrumentation in CloudWatch Logs eine Protokollgruppe mit dem Präfix /aws/application-signals/service-name (wobei der Wert Ihrer OTEL_SERVICE_NAME Umgebungsvariablen service-name ist) und schreibt aufgezeichnete Snapshots als Protokolldatensätze in diese Protokollgruppe.

Wenn die Protokollgruppe noch nicht existiert, erstellt Dynamic Instrumentation sie automatisch, wenn zum ersten Mal ein Snapshot ausgegeben wird. Die Aufnahme und Speicherung von Protokollen wird Ihnen zu den CloudWatch Standardtarifen für Logs in Rechnung gestellt.

Konfigurationen anzeigen und verwalten

Navigieren Sie in der CloudWatch Konsole zur Seite mit den Servicedetails und wählen Sie die Registerkarte Instrumentierung aus.

Den Status verstehen

Jede Instrumentierungskonfiguration hat einen Status, der ihren aktuellen Status angibt.

Wenn eine Instrumentierung in den Status ERROR übergeht, können die folgenden Ursachen gemeldet werden:

Grenzwerte erfassen

Erfassungsgrenzen steuern die Größe und Tiefe der erfassten Daten. Konfigurieren Sie diese Werte im capture-limits Feld der Erfassungskonfiguration.

Jeder Instrumentierungspunkt ist auf 5 Aufnahmen pro Sekunde begrenzt.