Databricks CLI のトラブルシューティング
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
Databricks CLI の問題のトラブルシューティングを行うには、次の情報を使用します。
ログ記録を有効にする
コマンドが失敗した場合、または予期した出力が生成されない場合は、ロギングを使用して、問題の原因を特定できます。 Databricks CLI が出力する、さまざまなコマンド イベント、警告、エラーに関するメッセージをログに記録できます。 これらのメッセージをログに記録するには、次の Databricks CLI コマンド オプションを指定します。
旗 | 説明 |
---|---|
| 出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。 |
|
|
| ログ形式のレベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。 |
--log-level
には、次のレベルのいずれかを指定してください。
error
error
レベルでのみメッセージをログに記録します。warn
を使用して、warn
レベルとerror
レベルでメッセージをログに記録します。info
を使用して、info
、error
、およびwarn
レベルでメッセージをログに記録します。debug
debug
、info
、error
、warn
レベルでメッセージを記録します。 (--debug
は--log-level debug
と同等です。)trace
trace
、debug
、info
、error
、およびwarn
レベルでメッセージをログに記録します。disabled
メッセージをログに記録しないようにします。 これは、--log-level
が指定されていない場合のデフォルトです。
次のコマンド例では error
指定したコマンドのみのメッセージを databricks-cli.log
という名前のテキスト ファイルに記録します。 --log-format text
は、メッセージがデフォルトでテキスト形式で記録されるため、オプションです。
databricks clusters list --log-file databricks-cli.log --log-format text --log-level error
次のコマンド例では、指定したコマンドの trace
、 debug
、 info
、 error
、および warn
メッセージを databricks-cli.log
という名前のファイルに JSON 形式で記録します。
databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace
次のコマンド例では、指定したコマンドの debug
、 info
、 error
、および warn
メッセージを databricks-cli.log
という名前のファイルにテキスト形式で記録します。 --log-format
が指定されていないため、メッセージはテキスト形式でログに記録されます。
databricks clusters list --log-file databricks-cli.log --log-level debug
次のコマンド例では、指定したコマンドの info
、 error
、および warn
メッセージを stderr に記録します。 --log-format
が指定されていないため、メッセージはテキスト形式でログに記録されます。
databricks clusters list --log-level info