メインコンテンツまでスキップ

Databricks CLI のトラブルシューティング

注記

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。

Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。

Databricks CLI の問題のトラブルシューティングを行うには、次の情報を使用します。

ログ記録を有効にする

コマンドが失敗した場合、または予期した出力が生成されない場合は、ロギングを使用して、問題の原因を特定できます。 Databricks CLI が出力する、さまざまなコマンド イベント、警告、エラーに関するメッセージをログに記録できます。 これらのメッセージをログに記録するには、次の Databricks CLI コマンド オプションを指定します。

説明

--log-file

出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。

--log-format

text 出力ログをテキストに書き込むか、 json 出力ログを JSON に書き込むかします。 このフラグが指定されていない場合、出力ログはテキストとして書き込まれます。

--log-level

ログ形式のレベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。

--log-level には、次のレベルのいずれかを指定してください。

  • error error レベルでのみメッセージをログに記録します。
  • warn を使用して、 warn レベルと error レベルでメッセージをログに記録します。
  • info を使用して、 infoerror、および warn レベルでメッセージをログに記録します。
  • debug debuginfoerrorwarn レベルでメッセージを記録します。 (--debug--log-level debug と同等です。)
  • trace tracedebuginfoerror、および warn レベルでメッセージをログに記録します。
  • disabled メッセージをログに記録しないようにします。 これは、 --log-level が指定されていない場合のデフォルトです。

次のコマンド例では error 指定したコマンドのみのメッセージを databricks-cli.logという名前のテキスト ファイルに記録します。 --log-format text は、メッセージがデフォルトでテキスト形式で記録されるため、オプションです。

Bash
databricks clusters list --log-file databricks-cli.log --log-format text --log-level error

次のコマンド例では、指定したコマンドの tracedebuginfoerror、および warn メッセージを databricks-cli.log という名前のファイルに JSON 形式で記録します。

Bash
databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

次のコマンド例では、指定したコマンドの debuginfoerror、および warn メッセージを databricks-cli.log という名前のファイルにテキスト形式で記録します。 --log-format が指定されていないため、メッセージはテキスト形式でログに記録されます。

Bash
databricks clusters list --log-file databricks-cli.log --log-level debug

次のコマンド例では、指定したコマンドの infoerror、および warn メッセージを stderr に記録します。 --log-format が指定されていないため、メッセージはテキスト形式でログに記録されます。

Bash
databricks clusters list --log-level info