ログアクセスの概要 IDE 拡張機能ログ Amazon Q CLI ログ一般的なログパターンとソリューションログ分析のヘルプ

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

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

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

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

ログアクセスの概要

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

IDE 拡張機能 - VS Code および JetBrains IDEsには、Amazon Q 固有のログにアクセスするための「ログの表示」ボタンがあります
コマンドラインインターフェイス (Amazon Q CLI) - ログは設定可能な詳細レベルを持つ一時ディレクトリにローカルに保存されます。

重要

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

IDE 拡張機能ログ

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

IDE で Amazon Q チャットパネルを開く (VS Code または JetBrains)
チャットパネルの右上隅にあるログの表示ボタンをクリックします。
表示される機密警告を確認する
ログファイルの場所は、レビューのためにシステムのファイルマネージャーで開きます。

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 Identity、認証フロー）
ネットワークオペレーション (HTTP/TLS 接続、証明書処理）
低レベルのシステムオペレーション (テレメトリ、ソケット接続）
AWS サービスエンドポイントの解決と接続プーリング
インフラストラクチャコンポーネントの詳細なデバッグ情報

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

チャットアプリケーションのエラーと状態処理の問題
MCP (モデルコンテキストプロトコル) サーバー管理と接続エラー
アプリケーションレベルの移行の問題
ユーザーインタラクションの中断とチャット処理の失敗
高レベルのアプリケーションロジックエラー

mcp.log - Model Context Protocol サーバーログ (MCP サーバーを使用する場合に入力）

translate.log - 自然言語からシェルへの翻訳ログ (翻訳機能を使用する場合に入力）

ログファイルの主な違い

範囲と詳細の違い：

chat.log: Q CLI インフラストラクチャ全体を対象とする包括的なシステムレベルのログ記録
qchat.log: チャット機能に特化したアプリケーションレベルのログ記録

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

chat.log: AWS SDK の内部、ネットワークプロトコル、認証フロー、システムオペレーション
qchat.log: チャットロジック、MCP サーバーのライフサイクル、ユーザーエクスペリエンスの問題、アプリケーションエラー

注記

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

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

ログから診断情報を収集するには、この方法に従います。

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

Linux/WSL の場合：
```
echo $XDG_RUNTIME_DIR/qlog/
```
macOS の場合：
```
echo $TMPDIR/qlog/
```
Windows の場合:
```
echo %TEMP%\qlog\
```
最大の詳細度で Amazon Q CLI コマンドを実行して、ターミナルの詳細な出力を確認します。
```
q -vvv chat
```
発生している問題を再現する
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
```
トラブルシューティング中のリアルタイムのログモニタリングには、以下を使用します。

すべてのログファイルを同時にモニタリングします。
```
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 接続管理とネットワークオペレーション
エラー fig_telemetry - システムテレメトリとソケット接続の問題

一般的な分析のヒント：

タイムスタンプ - 問題が発生したときにログエントリを関連付ける
エラーパターン - 繰り返し発生するエラーやエラーカスケードを探す
リクエスト IDs - 特定の API コールとその結果を追跡する
接続状態 - ネットワーク接続と認証ステータスのモニタリング

ヒント

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

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

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

MCP サーバー接続エラー

ログパターン (qchat.log): "Background listening thread for client [server-name]: RecvError(Closed)" or "All senders dropped for transport layer"

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

チャット処理の中断

ログパターン (qchat.log): 「現在の状態 err=Interrupted { tool_uses: None } の処理中にエラーが発生しました」

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

テレメトリ検証エラー

ログパターン (qchat.log): 「cw テレメトリイベント err=ValidationError [ValidationException]: Improperly formed request」

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

移行の警告

ログパターン (qchat.log): 「移行が次の理由で行われませんでした: 移行の中止」

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

認証の失敗

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

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

ネットワーク接続の問題

ログパターン (chat.log 内):「接続タイムアウト」、「ネットワークに到達できません」、または失敗した HTTP 接続

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

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

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

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

ログ分析のヘルプ

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

サポートに連絡するときは、関連するログの抜粋を含めます (機密情報を削除）。
問題が発生するタイミングと再現手順に関するコンテキストを提供する

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

トラブルシューティング

Amazon Q Developer のサービス名称変更