如何通过Databricks REST API配置访问Log Analytics端点及参数说明

开发者阿泽

2026-7-3

通过Databricks REST API配置Log Analytics端点及日志查看指南

一、API调用前置准备

你需要具备以下权限和基础信息：

Databricks账号管理员权限（用于生成访问令牌、配置日志投递规则）
Azure Log Analytics工作区的管理权限（用于获取工作区密钥、ID等核心参数）

二、API请求详情

使用POST请求调用Databricks账号级日志投递配置API，端点格式如下：

https://accounts.azuredatabricks.net/api/2.0/accounts/<account-id>/log-delivery/configs

请求头要求

Authorization: Bearer <databricks-token>：使用Databricks个人访问令牌（PAT）完成身份认证
Content-Type: application/json：指定请求体格式为JSON

请求体示例

{
  "config_name": "log-analytics-delivery",
  "log_type": "WORKSPACE_AUDIT_LOGS",
  "output_format": "JSON",
  "destination": {
    "type": "AZURE_LOG_ANALYTICS",
    "customer_id": "<log-analytics-workspace-id>",
    "shared_key": "<log-analytics-shared-key>",
    "log_analytics_workspace_resource_id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<workspace-name>"
  }
}

三、各参数获取来源

参数	具体获取路径
`<account-id>`	1. 登录Databricks账号门户，URL中`accounts/<account-id>`部分即为账号ID；2. 或在Azure门户找到Databricks资源，进入「属性」页面查看「账号ID」
`<databricks-token>`	登录Databricks账号门户，进入「用户设置」→「访问令牌」，生成具备`account admin`权限的令牌
`customer_id`	进入Azure Log Analytics工作区，「概述」页面的「工作区ID」字段
`shared_key`	进入Azure Log Analytics工作区，「代理管理」→「代理密钥」，复制主键或辅助键均可
`log_analytics_workspace_resource_id`	进入Azure Log Analytics工作区，「属性」页面的「资源ID」字段
`log_type`	可选值包括`WORKSPACE_AUDIT_LOGS`（审计日志）、`JOBS_RUN_LOGS`（作业运行日志）、`CLUSTER_LOGS`（集群日志）等，按需选择

四、在Databricks中查看日志

配置完成后，可通过两种方式在Databricks内查看日志：

原生日志界面
- 账号级：登录Databricks账号门户，进入「审计日志」页面查看全账号审计类日志
- 工作区级：进入对应Databricks工作区，在「工作区」→「日志」模块查看集群、作业等工作区专属日志
Databricks SQL查询Log Analytics
- 在Databricks工作区中创建Azure Log Analytics外部数据源，编写SQL查询直接拉取并分析Log Analytics中存储的日志数据

五、验证配置有效性

发送GET请求到以下端点，可查看已配置的日志投递规则：

https://accounts.azuredatabricks.net/api/2.0/accounts/<account-id>/log-delivery/configs

同时可登录Azure Log Analytics工作区，检查是否有对应类型的日志流入。

内容的提问来源于stack exchange，提问作者Dimitar Grigorov

如何通过Databricks REST API配置访问Log Analytics端点及参数说明

一、API调用前置准备 #

二、API请求详情 #

请求头要求 #

请求体示例 #

三、各参数获取来源 #

四、在Databricks中查看日志 #

五、验证配置有效性 #