Dockerman Docs
Homelab

診断バンドル

コンテナまたはComposeスタックのinspectデータ、events、logs、statsをワンクリックでzip化します。

診断バンドルは、コンテナまたはComposeスタックのデバッグに必要なすべてのものを単一の.zipファイルにパックします。友人と共有したり、issueに投稿したり、自分の参照用に保持したりできます。

バンドルの内容

manifest.json
system.json
events.json
inspect.json
logs.txt
stats.json
ファイル内容
manifest.json生成タイムスタンプ、Dockermanバージョン、ホストタイプ、ファイルインベントリ、編集カウント、発生したエラー
system.jsonDockerバージョンとシステム情報(機密フィールドは除外)
events.json選択された時間ウィンドウとターゲットコンテナでフィルタリングされたDockerイベント
inspect.jsonコンテナ、イメージ、ネットワーク、ボリュームのinspectデータを結合。環境変数はデフォルトで編集されます。State.Healthが含まれます。
logs.txt選択された時間ウィンドウ内のタイムスタンプ付きコンテナログ
stats.json時系列ストアからのリソース使用サンプル(利用可能な場合は生の5秒サンプル、長期間の場合は5分集計にフォールバック、時系列データが利用できない場合は現在のスナップショット)

Composeスタックを対象とする場合、バンドルにはスタック内のコンテナごとに1つのサブディレクトリが含まれます。

バンドルの生成

コンテナのアクションメニューを開き、診断バンドルを選択します。

Composeスタックのオーバーフローメニューを開き、診断バンドルを選択します。

Spotlightを開き、「diagnostic bundle」を検索してからターゲットを選択します。

時間ウィンドウを選択

logs、events、statsを含める期間を選択します。長いウィンドウは大きなバンドルを生成します。

編集設定を確認

TOKENPASSWORDSECRETKEYCREDENTIAL、またはAUTH(大文字小文字を区別しない)に一致する環境変数は、デフォルトで***REDACTED***に置き換えられます。生の値が必要な場合はこれをオフに切り替えてください。

保存場所を選択

ローカルファイルシステム上で.zipファイルを保存する場所を選択します。

生成を待つ

進行状況インジケーターがパッキングステータスを表示します。単一コンテナの生成は通常10秒未満で完了します。

結果を開く

生成後、Finderに表示(macOS)または同等の操作をクリックして保存されたファイルにジャンプします。

機密データの編集

デフォルトでは、以下のパターンに一致する環境変数の値は***REDACTED***に置き換えられます:

(?i)(TOKEN|PASSWORD|SECRET|KEY|CREDENTIAL|AUTH)

これはバンドル内のinspect.jsonファイルに適用されます。自分のデバッグに生の値が必要な場合は、バンドルダイアログで編集を無効にできます。

編集が有効でも、コンテナログにはアプリケーションによって出力された機密データが含まれる可能性があります。公開して共有する前にバンドルを確認してください。

ヒント

  • GitHub issuesやコミュニティフォーラムで助けを求めるときは診断バンドルを使用してください。構造化された形式により、他の人があなたのセットアップを理解しやすくなります。
  • バンドル内のstatsデータは、バックグラウンドタスクスケジューラが時系列データを収集していることに依存します。スケジューラが最近有効化された場合、statsセクションには現在のスナップショットのみが含まれる可能性があります。
  • 多くのコンテナを含むComposeスタックの場合、バンドルは大きくなる可能性があります。ファイルサイズを管理可能に保つために短い時間ウィンドウを使用してください。