診断バンドル
コンテナまたはComposeスタックのinspectデータ、events、logs、statsをワンクリックでzip化します。
診断バンドルは、コンテナまたはComposeスタックのデバッグに必要なすべてのものを単一の.zipファイルにパックします。友人と共有したり、issueに投稿したり、自分の参照用に保持したりできます。
バンドルの内容
| ファイル | 内容 |
|---|---|
manifest.json | 生成タイムスタンプ、Dockermanバージョン、ホストタイプ、ファイルインベントリ、編集カウント、発生したエラー |
system.json | Docker バージョンとシステム情報。レジストリのユーザー名は消去されますが、一般的なシークレット除去は行いません。 |
events.json | 選択された時間ウィンドウとターゲットコンテナでフィルタリングされたDockerイベント |
inspect.json | コンテナ、イメージ、ネットワーク、ボリュームの inspect データ。デフォルトではコンテナ config の Env リストで名前が一致した値だけを除去します。State.Health を含みます。 |
logs.txt | 選択された時間ウィンドウ内のタイムスタンプ付きコンテナログ |
stats.json | 時系列ストアからのリソース使用サンプル(利用可能な場合は生の5秒サンプル、長期間の場合は5分集計にフォールバック、時系列データが利用できない場合は現在のスナップショット) |
Composeスタックを対象とする場合、バンドルにはスタック内のコンテナごとに1つのサブディレクトリが含まれます。
バンドルの生成
コンテナのアクションメニューを開き、診断バンドルを選択します。
Composeスタックのオーバーフローメニューを開き、診断バンドルを選択します。
Spotlightを開き、「diagnostic bundle」を検索してからターゲットを選択します。
時間ウィンドウを選択
logs、events、statsを含める期間を選択します。長いウィンドウは大きなバンドルを生成します。
編集設定を確認
TOKEN、PASSWORD、SECRET、KEY、CREDENTIAL、またはAUTH(大文字小文字を区別しない)に一致する環境変数は、デフォルトで***REDACTED***に置き換えられます。生の値が必要な場合はこれをオフに切り替えてください。
保存場所を選択
ローカルファイルシステム上で.zipファイルを保存する場所を選択します。
生成を待つ
進行状況インジケーターがパッキングステータスを表示します。単一コンテナの生成は通常10秒未満で完了します。
結果を開く
生成後、Finderに表示(macOS)または同等の操作をクリックして保存されたファイルにジャンプします。
機密データの編集
デフォルトでは、以下のパターンに一致する環境変数の値は***REDACTED***に置き換えられます:
(?i)(TOKEN|PASSWORD|SECRET|KEY|CREDENTIAL|AUTH)これはバンドル内のinspect.jsonファイルに適用されます。自分のデバッグに生の値が必要な場合は、バンドルダイアログで編集を無効にできます。
除去範囲は限定的です。イメージの環境変数、ラベル、コマンド、マウントパス、ネットワークとボリュームの inspect、コンテナログにはシークレットや非公開パスが残る可能性があります。共有前にすべてのファイルを確認してください。
ヒント
- GitHub issuesやコミュニティフォーラムで助けを求めるときは診断バンドルを使用してください。構造化された形式により、他の人があなたのセットアップを理解しやすくなります。
- バンドル内のstatsデータは、バックグラウンドタスクスケジューラが時系列データを収集していることに依存します。スケジューラが最近有効化された場合、statsセクションには現在のスナップショットのみが含まれる可能性があります。
- 多くのコンテナを含むComposeスタックの場合、バンドルは大きくなる可能性があります。ファイルサイズを管理可能に保つために短い時間ウィンドウを使用してください。