Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Eseguire il debug delle applicazioni con Dynamic Instrumentation

Con Dynamic Instrumentation, è possibile acquisire lo stato di runtime da un'applicazione live senza riavviare o ridistribuire. Lo stato di runtime include valori variabili, argomenti del metodo, valori restituiti e tracce dello stack. Si definiscono configurazioni di strumentazione che specificano dove nel codice acquisire i dati e gli strumenti dell'agente in esecuzione l'applicazione in fase di esecuzione.

Concetti

Lingue supportate

Prerequisiti

Per utilizzare Dynamic Instrumentation, aggiorna i componenti della strumentazione alla versione più recente in base al tipo di implementazione:

Devono inoltre essere soddisfatte le seguenti condizioni:

Aggiungi strumentazione dinamica alla tua applicazione

Dopo aver strumentato l'applicazione (vediPrerequisiti), create una configurazione di strumentazione che specifica in quale parte del codice desiderate introdurre la telemetria dinamica. Ogni configurazione definisce due elementi:

Puoi creare configurazioni utilizzando la AWS CLI o l'SDK o utilizzando il server Model Context Protocol (MCP) con un assistente di codifica AI nel tuo IDE.

Crea configurazioni utilizzando la CLI o l'SDK

Usa la AWS CLI o l' AWS SDK per creare configurazioni di strumentazione a livello di codice.

Specificate la posizione del codice

La posizione definisce dove nel codice viene applicata la strumentazione. I campi obbligatori variano in base alla lingua:

Configura quali dati acquisire

La configurazione di acquisizione controlla lo stato di runtime raccolto quando la strumentazione si attiva. Opzioni disponibili:

Parametri di configurazione

Parametri chiave per la creazione di una configurazione:

Esempio

L'esempio seguente crea un punto di interruzione su un metodo Java:

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
            }
        }
    }'

Crea configurazioni utilizzando il server MCP

L'approccio consigliato all'utilizzo di Dynamic Instrumentation prevede l'utilizzo del server CloudWatch Application Signals MCP (Model Context Protocol). L'MCP consente agli assistenti e agli agenti di codifica AI dell'IDE di creare, gestire e interrogare le configurazioni di Dynamic Instrumentation direttamente dall'ambiente di sviluppo.

Utilizzando l'MCP, il tuo assistente AI può:

Per istruzioni di configurazione e utilizzo, consultate il server MCP Application Signals sul sito Web. GitHub

Archiviazione di dati

Quando si attiva un breakpoint o una sonda, Dynamic Instrumentation crea un gruppo di log in CloudWatch Logs con il prefisso /aws/application-signals/service-name (service-namedov'è il valore della variabile di OTEL_SERVICE_NAME ambiente) e scrive le istantanee acquisite come record di registro in quel gruppo di log.

Se il gruppo di log non esiste già, Dynamic Instrumentation lo crea automaticamente la prima volta che viene emessa un'istantanea. L'inserimento e lo storage dei log vengono fatturati alle tariffe standard di Logs. CloudWatch

Visualizza e gestisci le configurazioni

Nella CloudWatch console, vai alla pagina dei dettagli del servizio e scegli la scheda Strumentazione.

Comprendi lo stato

Ogni configurazione della strumentazione ha uno stato che indica lo stato attuale.

Quando una strumentazione entra nello stato ERROR, potrebbero essere segnalate le seguenti cause:

Limiti di acquisizione

I limiti di acquisizione controllano le dimensioni e la profondità dei dati acquisiti. Configura questi valori nel capture-limits campo della configurazione di acquisizione.

Ogni punto di strumentazione ha una frequenza limitata a 5 acquisizioni al secondo.