注意
此信息适用于 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：记录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 消息以 JSON 格式记录到名为 databricks-cli.log 的文件中。
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