Zugreifen auf und Verwenden von Amazon Q Developer-Protokollen - Amazon Q Developer
Überblick über den ProtokollzugriffProtokolle der IDE-ErweiterungenAmazon Q CLI-ProtokolleAllgemeine Protokollmuster und LösungenSie erhalten Hilfe bei der Protokollanalyse

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.

Zugreifen auf und Verwenden von Amazon Q Developer-Protokollen

Amazon Q Developer generiert detaillierte Protokolle, die Ihnen bei der Diagnose und Lösung von Problemen helfen können. Diese Anleitung zeigt Ihnen, wie Sie auf Protokolle für verschiedene Amazon Q-Schnittstellen zugreifen und Protokollierungsebenen konfigurieren, um die Informationen zu erhalten, die Sie für die Fehlerbehebung benötigen.

Schnelle Navigation:

Überblick über den Protokollzugriff

Je nachdem, wie Sie den Service nutzen, gibt es zwei Möglichkeiten, auf Amazon Q Developer-Logs zuzugreifen:

  • IDE-Erweiterungen — VS Code und JetBrains IDEs verfügen über eine Schaltfläche „Protokolle anzeigen“ für den Zugriff auf Amazon Q-spezifische Protokolle

  • Befehlszeilenschnittstelle (Amazon Q CLI) — Protokolle werden lokal in temporären Verzeichnissen mit konfigurierbaren Detailebenen gespeichert

Wichtig

Protokolldateien können vertrauliche Informationen aus Ihren Konversationen und Interaktionen mit Amazon Q enthalten, darunter Dateipfade, Codefragmente, Befehlsausgaben IDs, Konto- und Ressourcennamen. Seien Sie vorsichtig, wenn Sie Protokolldateien mit anderen teilen.

Protokolle der IDE-Erweiterungen

Zugriff auf Protokolle über die IDE-Schnittstelle

  1. Öffnen Sie das Amazon Q-Chat-Panel in Ihrer IDE (VS Code oder JetBrains)

  2. Klicken Sie in der oberen rechten Ecke des Chat-Panels auf die Schaltfläche Protokolle anzeigen

  3. Bestätigen Sie die angezeigte Sensibilitätswarnung

  4. Der Speicherort der Protokolldatei wird im Dateimanager Ihres Systems zur Überprüfung geöffnet

Analysieren von IDE-Erweiterungsprotokollen

Achten Sie bei der Überprüfung der IDE-Erweiterungsprotokolle auf:

  • Fehlermeldungen — Zeilen, die „ERROR“ oder „FATAL“ enthalten, weisen auf kritische Probleme hin

  • Authentifizierungsprobleme — Suchen Sie nach Fehlern im Zusammenhang mit der Authentifizierung oder den Anmeldeinformationen

  • Netzwerkkonnektivität — Verbindungstimeouts oder netzwerkbedingte Fehler

  • Funktionsspezifische Fehler — Probleme im Zusammenhang mit Codevorschlägen, Chat oder anderen spezifischen Funktionen

Amazon Q CLI-Protokolle

Die Amazon Q CLI generiert automatisch umfassende Protokolle für alle Operationen, unabhängig von den Ausführlichkeitseinstellungen. Protokolle werden immer in Dateien geschrieben, wobei Ausführlichkeitsflags nur steuern, was in der Terminalausgabe angezeigt wird.

Amazon Q CLI-Protokollspeicherorte und Dateien

Amazon Q CLI-Protokolle werden automatisch an den folgenden Orten gespeichert:

Betriebssystem Speicherort des Protokolls
macOS $TMPDIR/qlog/(in der Regel/var/folders/.../qlog/)
Linux/WSL $XDG_RUNTIME_DIR/qlog/ oder $TMPDIR/qlog/ oder /tmp/qlog/
Windows %TEMP%\qlog\

Die Amazon Q CLI erstellt automatisch mehrere spezialisierte Protokolldateien:

chat.log- Die wichtigsten Amazon Q CLI-Wrapper-Protokolle, darunter:

  • Amazon Q CLI-Initialisierungs- und Startvorgänge

  • AWS-SDK-Aufrufe (Cognito Identity, Authentifizierungsabläufe)

  • Netzwerkoperationen (HTTP/TLS-Verbindungen, Umgang mit Zertifikaten)

  • Systemoperationen auf niedriger Ebene (Telemetrie, Socket-Verbindungen)

  • AWS-Serviceendpunktauflösung und Verbindungspooling

  • Detaillierte Debugging-Informationen für Infrastrukturkomponenten

qchat.log- Anwendungsspezifische Chat-Protokolle, einschließlich:

  • Fehler bei der Chat-Anwendung und Probleme bei der Statusverarbeitung

  • MCP-Servermanagement (Model Context Protocol) und Verbindungsfehler

  • Probleme bei der Migration auf Anwendungsebene

  • Unterbrechungen der Benutzerinteraktion und Fehler bei der Chat-Verarbeitung

  • Fehler in der Anwendungslogik auf höherer Ebene

mcp.log- Model Context Protocol-Serverprotokolle (werden bei Verwendung von MCP-Servern aufgefüllt)
translate.log- Übersetzungsprotokolle in natürlicher Sprache in die Shell (werden bei Verwendung der Übersetzungsfunktion aufgefüllt)

Hauptunterschiede zwischen Protokolldateien

Unterschiede im Umfang und im Detail:

  • chat.log: Umfassende Protokollierung auf Systemebene, die die gesamte Q CLI-Infrastruktur abdeckt

  • qchat.log: Spezifische Protokollierung auf Anwendungsebene, die speziell auf die Chat-Funktionalität zugeschnitten ist

Unterschiede bei der inhaltlichen Ausrichtung:

  • chat.log: Interne Funktionen des AWS SDK, Netzwerkprotokolle, Authentifizierungsabläufe, Systemoperationen

  • qchat.log: Chat-Logik, MCP-Serverlebenszyklus, Probleme mit der Benutzererfahrung, Anwendungsfehler

Anmerkung

Protokolldateien werden nur auf Ihrem lokalen Computer gespeichert und nicht an diese AWS gesendet. Alle Protokolldateien werden automatisch erstellt, wenn Sie die CLI zum ersten Mal verwenden, auch ohne ausführliche Flags.

Workflow zur Fehlerbehebung bei Amazon Q CLI

Gehen Sie wie folgt vor, um Diagnoseinformationen aus den Protokollen zu sammeln.

  1. Identifizieren Sie das Protokollverzeichnis für Ihr System:

    Unter Linux/WSL:

    echo $XDG_RUNTIME_DIR/qlog/

    Auf macOS:

    echo $TMPDIR/qlog/

    Unter Windows:

    echo %TEMP%\qlog\

  2. Führen Sie den Amazon Q CLI-Befehl mit maximaler Ausführlichkeit aus, um eine detaillierte Ausgabe in Ihrem Terminal zu sehen:

    q -vvv chat

  3. Reproduzieren Sie das aufgetretene Problem

  4. Beenden Sie die Amazon Q CLI und überprüfen Sie die entsprechenden Protokolldateien. Überprüfen Sie bei den meisten Problemen beide Hauptprotokolldateien:

    Unter macOS/Linux:

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

    Alternative auf macOS:

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

    Unter Windows:

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

  5. Verwenden Sie für die Protokollüberwachung in Echtzeit während der Fehlerbehebung:

    Überwachen Sie alle Protokolldateien gleichzeitig:

    tail -f $XDG_RUNTIME_DIR/qlog/*.log

    Überwachen Sie bestimmte Dateien:

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

Analysieren von Amazon Q-CLI-Protokollen

Amazon Q CLI-Protokolle verwenden Standardprotokollierungsebenen, um Informationen nach Wichtigkeit zu kategorisieren:

ERROR

Kritische Probleme, die den normalen Betrieb verhindern — beginnen Sie hier mit der Fehlerbehebung

WARN

Mögliche Probleme, die die Funktionalität nicht beeinträchtigen, aber zur Kenntnis genommen werden sollten

INFO

Allgemeine Betriebsmeldungen darüber, was die Anwendung tut

DEBUG

Detaillierte technische Informationen, die für eingehendere Untersuchungen nützlich sind

Konzentrieren Sie sich bei der Untersuchung von Amazon Q CLI-Protokollen auf die folgenden Schlüsselbereiche in den verschiedenen Protokolldateien:

qchat.logAnalyse — Probleme auf Anwendungsebene, einschließlich:

  • FEHLER chat_cli: :cli: :chat — Fehler bei der Chat-Verarbeitung und Statusverwaltung

  • FEHLER chat_cli: :cli: :agent — Probleme mit der Migration und mit Agenten

  • FEHLER chat_cli: :telemetry — Telemetrievalidierung und Übertragungsfehler

chat.logAnalyse — Einzelheiten zum Betrieb während der Laufzeit, einschließlich:

  • DEBUG q_cli: :cli — Ausführung und Initialisierung von Amazon Q CLI-Befehlen

  • DEBUG aws_sdk_* — AWS-SDK-Operationen und Serviceanrufe

  • DEBUG rustls: :* — Verbindungsaufbau und Umgang mit Zertifikaten TLS/SSL

  • DEBUG hyper_* — Verwaltung von HTTP-Verbindungen und Netzwerkoperationen

  • FEHLER fig_telemetry — Probleme mit der Systemtelemetrie und der Socket-Verbindung

Allgemeine Analysetipps:

  • Zeitstempel — Korrelieren Sie Protokolleinträge mit dem Zeitpunkt, zu dem Probleme aufgetreten sind

  • Fehlermuster — Suchen Sie nach wiederholten Fehlern oder Fehlerkaskaden

  • Anfrage IDs — Verfolgen Sie bestimmte API-Aufrufe und deren Ergebnisse

  • Verbindungsstatus — Überwachen Sie die Netzwerkkonnektivität und den Authentifizierungsstatus

Tipp

Verwenden Sie Tools wie grepawk, oder Texteditoren mit Suchfunktion, um Protokolle nach bestimmten Fehlermeldungen oder Mustern zu filtern. Beispiel: grep -i error $XDG_RUNTIME_DIR/qlog/*.log

Allgemeine Protokollmuster und Lösungen

Im Folgenden finden Sie einige häufig auftretende Probleme in Protokollen und deren typische Lösungen:

Verbindungsfehler beim MCP-Server

Protokollmuster (in qchat.log): „Hintergrund-Listening-Thread für Client [Servername]: RecvError (Geschlossen)“ oder „Alle Absender wurden für die Transportschicht gelöscht“

Lösung: MCP-Serverprozesse laufen nicht mehr. Dieses Verhalten wird normalerweise beim Beenden der Amazon Q CLI oder beim normalen Herunterfahren von Servern erwartet.

Unterbrechungen der Chat-Verarbeitung

Protokollmuster (in qchat.log): „Bei der Verarbeitung des aktuellen Status ist ein Fehler aufgetreten ERR=Interrupted {tool_uses: None}“

Lösung: Dies tritt auf, wenn Chat-Operationen vom Benutzer abgebrochen werden (z. B. Strg+C) und entspricht dem erwarteten Verhalten.

Fehler bei der Telemetrieüberprüfung

Protokollmuster (in qchat.log): „Fehler beim Senden des CW-Telemetrie-Ereignisses err= ValidationError [ValidationException]: Falsch formulierte Anfrage“

Lösung: Dabei handelt es sich in der Regel um unkritische Probleme bei der Telemetrieübertragung, die die Kernfunktionalität nicht beeinträchtigen.

Migrationswarnungen

Protokollmuster (in qchat.log): „Die Migration konnte aus dem folgenden Grund nicht durchgeführt werden: Die Migration wurde abgebrochen“

Lösung: Dies ist in der Regel eine unkritische Warnung im Zusammenhang mit der Konfigurationsmigration und kann normalerweise ignoriert werden.

Authentication failures (Authentifizierungsfehler)

Protokollmuster (in chat.log): Authentifizierungsbedingte Fehler bei AWS-SDK-Vorgängen

Lösung: Führen Sie ausq login, um Ihre AWS-Anmeldeinformationen erneut zu authentifizieren oder zu überprüfen

Probleme mit der Netzwerkkonnektivität

Protokollmuster (in chat.log): „Verbindungstimeout“, „Netzwerk nicht erreichbar“ oder fehlgeschlagene HTTP-Verbindungen

Lösung: Überprüfen Sie Ihre Internetverbindungs- und Firewall-Einstellungen

Fehler bei AWS-SDK-Vorgängen

Protokollmuster (in chat.log): Fehlgeschlagene Cognito Identity-Vorgänge oder Fehler beim Abrufen von Anmeldeinformationen

Lösung: Überprüfen Sie Ihre AWS-Anmeldeinformationen und Ihre Netzwerkkonnektivität. Möglicherweise ist eine erneute Authentifizierung erforderlich

Sie erhalten Hilfe bei der Protokollanalyse

Wenn Sie Unterstützung bei der Analyse von Protokollen oder der Lösung von Problemen benötigen:

  • Wenn Sie sich an den Support wenden, fügen Sie relevante Protokollauszüge bei (wobei vertrauliche Informationen entfernt wurden)

  • Erläutern Sie, wann das Problem aufgetreten ist, und erläutern Sie, wie Sie es reproduzieren können