Amazon Q Developer ログへのアクセスと使用 - Amazon Q Developer
ログへのアクセスの概要IDE 拡張ログAmazon Q CLI ログ一般的なログパターンとソリューションログ分析に関するヘルプの取得

Amazon Q Developer ログへのアクセスと使用

Amazon Q Developer は、問題の診断と解決に役立つ詳細なログを生成します。このガイドでは、さまざまな Amazon Q インターフェイスのログにアクセスし、トラブルシューティングに必要な情報を取得するためのログ記録レベルを設定する方法について説明します。

クイックナビゲーション:

ログへのアクセスの概要

Amazon Q Developer ログにアクセスするには、サービスの使用方法に応じて、主に 2 つの方法があります。

  • IDE 拡張機能 - VS Code および JetBrains IDE には、Amazon Q 固有のログにアクセスするための [ログの表示] ボタンがあります

  • コマンドラインインターフェイス (Amazon Q CLI) - ログは設定可能な詳細レベルの一時ディレクトリにローカルに保存されます。

重要

ログファイルには、ファイルパス、コードスニペット、コマンド出力、アカウント ID、リソース名など、Amazon Q との会話ややり取りからの機密情報が含まれている場合があります。ログファイルを他のユーザーと共有する場合は注意が必要です。

IDE 拡張ログ

IDE インターフェイスを介したログへのアクセス

  1. IDE (VS Code または JetBrains) で Amazon Q チャットパネルを開きます。

  2. チャットパネルの右上隅にある [ログの表示] ボタンをクリックします。

  3. 表示される機密情報に関する警告を確認します。

  4. ログファイルの場所は、レビュー用のシステムのファイルマネージャーで開きます。

IDE 拡張ログの分析

IDE 拡張ログのレビューでは、以下を確認します。

  • エラーメッセージ - 「ERROR」または「FATAL」を含む行は重大な問題を示します。

  • 認証の問題 - 認証または認証情報関連のエラーを確認します。

  • ネットワーク接続 - 接続タイムアウトまたはネットワーク関連のエラー。

  • 機能固有のエラー - コードの提案、チャット、またはその他の特定の機能に関連する問題。

Amazon Q CLI ログ

Amazon Q CLI は、詳細設定に関係なく、すべてのオペレーションの包括的なログを自動的に生成します。ログは常にファイルに書き込まれます。詳細フラグはターミナル出力に表示される内容のみを制御します。

Amazon Q CLI のログの場所とファイル

Amazon Q CLI ログは、次の場所に自動的に保存されます。

オペレーティングシステム ログの場所
macOS $TMPDIR/qlog/ (通常は /var/folders/.../qlog/)
Linux/WSL $XDG_RUNTIME_DIR/qlog/ または $TMPDIR/qlog/ または /tmp/qlog/
Windows %TEMP%\qlog\

Amazon Q CLI は、複数の特殊なログファイルを自動的に作成します。

chat.log - 以下を含む主要な Amazon Q CLI ラッパーログ。

  • Amazon Q CLI の初期化とスタートアップオペレーション

  • AWS SDK 呼び出し (Cognito ID、認証フロー)

  • ネットワークオペレーション (HTTP/TLS 接続、証明書処理)

  • 低レベルのシステムオペレーション (テレメトリ、ソケット接続)

  • AWS サービスエンドポイントの解決と接続プーリング

  • インフラストラクチャコンポーネントの詳細なデバッグ情報

qchat.log - 以下を含むチャットアプリケーション固有のログ。

  • チャットアプリケーションのエラーとステータス処理の問題

  • MCP (モデルコンテキストプロトコル) サーバー管理および接続エラー

  • アプリケーションレベルの移行の問題

  • ユーザーインタラクションの中断とチャット処理の失敗

  • 高レベルのアプリケーションロジックエラー

mcp.log - モデルコンテキストプロトコルサーバーログ (MCP サーバーを使用する場合に入力)
translate.log - 自然言語からシェルへの翻訳ログ (翻訳機能を使用する場合に入力)

ログファイルの主な違い

スコープと詳細の違い:

  • chat.log: Q CLI インフラストラクチャ全体を対象とする包括的なシステムレベルのログ記録

  • qchat.log: チャット機能に特化したアプリケーションレベルのログ記録

コンテンツフォーカスの違い:

  • chat.log: AWS SDK の内部、ネットワークプロトコル、認証フロー、システムオペレーション

  • qchat.log: チャットロジック、MCP サーバーのライフサイクル、ユーザーエクスペリエンスの問題、アプリケーションエラー

注記

ログファイルはローカルマシンにのみ保存され、AWS には送信されません。すべてのログファイルは、詳細フラグがなくても、最初に CLI を使用すると自動的に作成されます。

Amazon Q CLI のトラブルシューティングワークフロー

ログから診断情報を収集するには、このアプローチに従います。

  1. システムのログディレクトリを特定します。

    Linux/WSL の場合:

    echo $XDG_RUNTIME_DIR/qlog/

    macOS の場合:

    echo $TMPDIR/qlog/

    Windows の場合:

    echo %TEMP%\qlog\

  2. 最大の詳細度で Amazon Q CLI コマンドを実行して、ターミナルの詳細な出力を確認します。

    q -vvv chat

  3. 発生している問題を再現します。

  4. Amazon Q CLI を終了し、関連するログファイルを調べます。ほとんどの問題については、両方のメインログファイルを確認します。

    macOS/Linux の場合:

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

    macOS の場合 (代替):

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

    Windows の場合:

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

  5. トラブルシューティング中のリアルタイムのログモニタリングには、以下を使用します。

    すべてのログファイルを同時にモニタリングします。

    tail -f $XDG_RUNTIME_DIR/qlog/*.log

    特定のファイルをモニタリングします。

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

Amazon Q CLI ログの分析

Amazon Q CLI ログは、標準のログ記録レベルを使用して情報を重要度別に分類します。

ERROR

通常のオペレーションを妨げる重大な問題 - トラブルシューティング時はここから始めます。

WARN

機能を停止しないが、注意すべき潜在的な問題

情報

アプリケーションの動作に関する一般的なオペレーションメッセージ

DEBUG

より詳細な調査に役立つ詳細な技術情報

Amazon Q CLI ログを調べる際は、さまざまなログファイルの以下の主要な領域に焦点を当てます。

qchat.log 分析 - 次のようなアプリケーションレベルの問題。

  • ERROR chat_cli::cli::chat - チャット処理とステータス管理エラー

  • ERROR chat_cli::cli::agent -移行およびエージェント関連の問題

  • ERROR chat_cli::telemetry - テレメトリの検証と送信の失敗

chat.log 分析 - 以下を含むランタイムオペレーションの詳細。

  • DEBUG q_cli::cli - Amazon Q CLI コマンドの実行と初期化

  • DEBUG aws_sdk_* - AWS SDK オペレーションとサービスコール

  • DEBUG rustls::* - TLS/SSL 接続の確立と証明書の処理

  • DEBUG hyper_* - HTTP 接続管理とネットワークオペレーション

  • ERROR fig_telemetry - システムテレメトリおよびソケット接続の問題

一般的な分析のヒント:

  • タイムスタンプ - 問題が発生したときとログエントリの関連

  • エラーパターン - 繰り返し発生するエラーやエラーカスケードを探す

  • リクエスト ID - 特定の API コールとその結果の追跡

  • 接続ステータス - ネットワーク接続と認証ステータスのモニタリング

ヒント

grep、awk、または検索機能を備えたテキストエディタなどのツールを使用して、特定のエラーメッセージやパターンのログをフィルタリングします。例: grep -i error $XDG_RUNTIME_DIR/qlog/*.log

一般的なログパターンとソリューション

ログで発生する可能性がある一般的な問題とその一般的な解決策は次のとおりです。

MCP サーバー接続エラー

ログパターン (qchat.log 内): 「Background listening thread for client [server-name]: RecvError(Closed)」または「All senders dropped for transport layer」

解決策: MCP サーバープロセスの実行が停止しました。これは通常、Amazon Q CLI を終了するとき、またはサーバーが正常にシャットダウンするときに予想される動作です。

チャット処理の中断

ログパターン (qchat.log 内): 「An error occurred processing the current state err=Interrupted { tool_uses: None }」

解決策: これは、チャット操作がユーザーによってキャンセルされ (Ctrl+C など)、予想される動作である場合に発生します。

テレメトリ検証エラー

ログパターン (qchat.log 内): 「Failed to send cw telemetry event err=ValidationError [ValidationException]: Improperly formed request」

解決策: これらは通常、コア機能に影響を与えない重要でないテレメトリ送信の問題です。

移行の警告

ログパターン (qchat.log 内): 「Migration did not happen for the following reason: Aborting migration」

解決策: これは通常、設定の移行に関連する重要ではない警告であり、通常は無視できます。

認証の失敗

ログパターン (chat.log 内): AWS SDK オペレーションでの認証関連エラー

解決策: q login を実行して AWS 認証情報を再認証またはチェックする

ネットワーク接続の問題

ログパターン (chat.log 内): 「Connection timeout」、「Network unreachable」、または HTTP 接続の失敗

解決策: インターネット接続とファイアウォールの設定を確認する

AWS SDK オペレーションの失敗

ログパターン (chat.log 内): Cognito ID オペレーションの失敗または認証情報の取得エラー

解決策: AWS 認証情報とネットワーク接続を確認する 再認証が必要になる場合があります

ログ分析に関するヘルプの取得

ログ分析や問題の解決についてサポートが必要な場合:

  • サポートに連絡するときは、関連するログの抜粋を含めます (機密情報を削除)。

  • 問題が発生するタイミングとそれを再現する手順に関するコンテキストを提供する