Accesso e utilizzo dei log di Amazon Q Developer - Amazon Q Developer
Panoramica degli accessi ai logRegistri delle estensioni IDERegistri CLI di Amazon QModelli e soluzioni di log comuniOttenere assistenza con l'analisi dei log

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à.

Accesso e utilizzo dei log di Amazon Q Developer

Amazon Q Developer genera log dettagliati che possono aiutarti a diagnosticare e risolvere i problemi. Questa guida mostra come accedere ai log per diverse interfacce Amazon Q e configurare i livelli di registrazione per ottenere le informazioni necessarie per la risoluzione dei problemi.

Navigazione rapida:

Panoramica degli accessi ai log

Esistono due modi principali per accedere ai log degli sviluppatori di Amazon Q, a seconda di come utilizzi il servizio:

  • Estensioni IDE - VS Code e JetBrains IDEs dispongono di un pulsante «Show Logs» per accedere ai log specifici di Amazon Q

  • Command Line Interface (Amazon Q CLI): i log vengono archiviati localmente in directory temporanee con livelli di dettaglio configurabili

Importante

I file di registro possono contenere informazioni sensibili relative alle tue conversazioni e interazioni con Amazon Q, inclusi percorsi di file, frammenti di codice, output di comandi, nomi di account e IDs risorse. Fai attenzione quando condividi i file di registro con altri.

Registri delle estensioni IDE

Accesso ai log tramite l'interfaccia IDE

  1. Apri il pannello di chat di Amazon Q nel tuo IDE (VS Code o JetBrains)

  2. Fai clic sul pulsante Mostra registri nell'angolo in alto a destra del pannello di chat

  3. Conferma l'avviso di sensibilità che appare

  4. La posizione del file di registro verrà aperta nel file manager del sistema per essere esaminata

Analisi dei log delle estensioni IDE

Quando esaminate i log delle estensioni IDE, cercate:

  • Messaggi di errore: le righe contenenti «ERROR» o «FATAL» indicano problemi critici

  • Problemi di autenticazione: cerca gli errori relativi all'autenticazione o alle credenziali

  • Connettività di rete: timeout di connessione o errori relativi alla rete

  • Errori specifici delle funzionalità: problemi relativi ai suggerimenti di codice, alla chat o ad altre funzionalità specifiche

Registri CLI di Amazon Q

L'Amazon Q CLI genera automaticamente log completi per tutte le operazioni, indipendentemente dalle impostazioni di dettaglio. I log vengono sempre scritti su file, mentre i flag di dettaglio controllano solo ciò che appare nell'output del terminale.

Posizioni e file dei log dell'Amazon Q CLI

I log CLI di Amazon Q vengono archiviati automaticamente nelle seguenti posizioni:

Sistema operativo Posizione del log
macOS $TMPDIR/qlog/(in genere/var/folders/.../qlog/)
Linux/WSL $XDG_RUNTIME_DIR/qlog/ o $TMPDIR/qlog/ o /tmp/qlog/
Windows %TEMP%\qlog\

L'Amazon Q CLI crea automaticamente più file di log specializzati:

chat.log- I principali log wrapper di Amazon Q CLI, tra cui:

  • Operazioni di avvio e inizializzazione della CLI di Amazon Q

  • Chiamate SDK AWS (Cognito Identity, flussi di autenticazione)

  • Operazioni di rete (connessioni HTTP/TLS, gestione dei certificati)

  • Operazioni di sistema a basso livello (telemetria, connessioni socket)

  • Risoluzione degli endpoint dei servizi AWS e pool di connessioni

  • Informazioni di debug dettagliate per i componenti dell'infrastruttura

qchat.log- Registri specifici delle applicazioni di chat, tra cui:

  • Errori delle applicazioni di chat e problemi di elaborazione dello stato

  • Errori di connessione e gestione del server MCP (Model Context Protocol)

  • Problemi di migrazione a livello di applicazione

  • Interruzioni delle interazioni con gli utenti e errori di elaborazione della chat

  • Errori logici applicativi di livello superiore

mcp.log- Registri del server Model Context Protocol (compilati quando si utilizzano server MCP)
translate.log- Registri di traduzione dal linguaggio naturale alla shell (compilati quando si utilizza la funzione di traduzione)

Principali differenze tra i file di registro

Differenze di ambito e dettaglio:

  • chat.log: registrazione completa a livello di sistema che copre l'intera infrastruttura Q CLI

  • qchat.log: Registrazione mirata a livello di applicazione specifica per la funzionalità di chat

Differenze di focalizzazione dei contenuti:

  • chat.log: componenti interni dell'SDK AWS, protocolli di rete, flussi di autenticazione, operazioni di sistema

  • qchat.log: Logica della chat, ciclo di vita del server MCP, problemi relativi all'esperienza utente, errori delle applicazioni

Nota

I file di registro vengono archiviati solo sul computer locale e non vengono inviati a. AWS Tutti i file di registro vengono creati automaticamente quando si utilizza per la prima volta la CLI, anche senza flag dettagliati.

Flusso di lavoro di risoluzione dei problemi della CLI di Amazon Q

Segui questo approccio per raccogliere informazioni diagnostiche dai log.

  1. Identifica la directory di log del tuo sistema:

    Su Linux/WSL:

    echo $XDG_RUNTIME_DIR/qlog/

    Su macOS:

    echo $TMPDIR/qlog/

    In Windows:

    echo %TEMP%\qlog\

  2. Esegui il comando Amazon Q CLI con la massima precisione per visualizzare l'output dettagliato nel tuo terminale:

    q -vvv chat

  3. Riproduci il problema che stai riscontrando

  4. Esci dalla CLI di Amazon Q ed esamina i file di log pertinenti. Per la maggior parte dei problemi, controlla entrambi i file di log principali:

    Su macOS/Linux:

    less -r $XDG_RUNTIME_DIR/qlog/qchat.log
less -r $XDG_RUNTIME_DIR/qlog/chat.log

    Alternativa su macOS:

    less -r $TMPDIR/qlog/qchat.log
less -r $TMPDIR/qlog/chat.log

    In Windows:

    type %TEMP%\qlog\qchat.log
type %TEMP%\qlog\chat.log

  5. Per il monitoraggio dei log in tempo reale durante la risoluzione dei problemi, usa:

    Monitora tutti i file di registro contemporaneamente:

    tail -f $XDG_RUNTIME_DIR/qlog/*.log

    Monitora file specifici:

    tail -f $XDG_RUNTIME_DIR/qlog/qchat.log
    tail -f $XDG_RUNTIME_DIR/qlog/chat.log

Analisi dei log dell'interfaccia a riga di comando di Amazon Q

I log dell'interfaccia a riga di comando di Amazon Q utilizzano livelli di registrazione standard per classificare le informazioni in base all'importanza:

ERRORE

Problemi critici che impediscono il normale funzionamento: inizia da qui per la risoluzione dei problemi

WARN

Potenziali problemi che non impediscono la funzionalità ma che devono essere segnalati

INFO

Messaggi operativi generali sull'attività dell'applicazione

DEBUG

Informazioni tecniche dettagliate utili per un'indagine più approfondita

Quando esamini i log della CLI di Amazon Q, concentrati su queste aree chiave nei diversi file di log:

qchat.loganalisi - Problemi a livello di applicazione, tra cui:

  • ERROR chat_cli: :cli: :chat - Errori di elaborazione della chat e gestione dello stato

  • ERRORE chat_cli: :cli: :agent - Problemi relativi alla migrazione e agli agenti

  • ERROR chat_cli: :telemetry - Convalida della telemetria e errori di trasmissione

chat.loganalisi - Dettagli operativi in fase di esecuzione, tra cui:

  • DEBUG q_cli: :cli - Esecuzione e inizializzazione di comandi Amazon Q CLI

  • DEBUG aws_sdk_* - Operazioni e chiamate di servizio SDK AWS

  • DEBUG rustls: :* - creazione della connessione e gestione dei certificati TLS/SSL

  • DEBUG hyper_* - Gestione della connessione HTTP e operazioni di rete

  • ERROR fig_telemetry - Telemetria del sistema e problemi di connessione al socket

Suggerimenti generali per l'analisi:

  • Timestamp: correla le voci di registro con quando si sono verificati i problemi

  • Schemi di errore: cerca gli errori ripetuti o le cascate di errori

  • Richiesta IDs: monitora chiamate API specifiche e i relativi risultati

  • Stati di connessione: monitora la connettività di rete e lo stato di autenticazione

Suggerimento

Utilizza strumenti come grepawk, o editor di testo con funzionalità di ricerca, per filtrare i log in base a messaggi o schemi di errore specifici. Ad esempio: grep -i error $XDG_RUNTIME_DIR/qlog/*.log

Modelli e soluzioni di log comuni

Ecco alcuni problemi comuni che potresti riscontrare nei log e le relative soluzioni tipiche:

Errori di connessione al server MCP

Schema di registro (in qchat.log): «Thread di ascolto in background per il client [nome-server]: RecvError (Chiuso)» o «Tutti i mittenti sono stati eliminati dal livello di trasporto»

Soluzione: i processi del server MCP hanno smesso di funzionare. Questo è in genere un comportamento previsto quando si esce dalla CLI di Amazon Q o quando i server si spengono normalmente.

Interruzioni dell'elaborazione delle chat

Schema di registro (in qchat.log): «Si è verificato un errore durante l'elaborazione dello stato corrente ERR=interrupted {tool_uses: None}»

Soluzione: ciò si verifica quando le operazioni di chat vengono annullate dall'utente (ad esempio, Ctrl+C) ed è un comportamento previsto.

Errori di convalida della telemetria

Schema di registro (in qchat.log): «Impossibile inviare l'evento di telemetria cw err= []: richiesta formata in modo errato» ValidationError ValidationException

Soluzione: in genere si tratta di problemi non critici di trasmissione telemetrica che non influiscono sulle funzionalità di base.

Avvertenze sulla migrazione

Schema di registro (in qchat.log): «La migrazione non è avvenuta per il seguente motivo: interruzione della migrazione»

Soluzione: in genere si tratta di un avviso non critico relativo alla migrazione della configurazione e in genere può essere ignorato.

Authentication failures (Errori di autenticazione)

Schema di registro (in chat.log): errori relativi all'autenticazione nelle operazioni dell'SDK AWS

Soluzione: esegui q login per riautenticare o controllare le tue credenziali AWS

Problemi di connettività di rete

Schema di registro (in chat.log): «Timeout della connessione», «Rete non raggiungibile» o connessioni HTTP non riuscite

Soluzione: controlla la connessione Internet e le impostazioni del firewall

Errori operativi dell'SDK AWS

Schema di registro (in chat.log): operazioni di Cognito Identity non riuscite o errori di recupero delle credenziali

Soluzione: verifica le credenziali AWS e la connettività di rete. Potrebbe richiedere una nuova autenticazione

Ottenere assistenza con l'analisi dei log

Se hai bisogno di assistenza per l'analisi dei log o la risoluzione di problemi:

  • Quando contatti l'assistenza, includi gli estratti di registro pertinenti (con le informazioni sensibili rimosse)

  • Fornisci un contesto su quando si verifica il problema e sui passaggi per riprodurlo