You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update Databricks docs to use workspace-level service principal flow (DataDog#23099)
Replace the account-level service principal setup with a workspace-level
flow, removing the Account ID requirement. This aligns with
DataDog/documentation#35527.
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: databricks/README.md
+8-10Lines changed: 8 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,22 +31,20 @@ First, [connect a new Databricks workspace](#connect-to-a-new-databricks-workspa
31
31
<!-- xxx tabs xxx -->
32
32
33
33
<!-- xxx tab "Use a Service Principal for OAuth" xxx -->
34
-
<divclass="alert alert-warning">New workspaces must authenticate using OAuth. Workspaces integrated with a Personal Access Token continue to function and can switch to OAuth at any time. After a workspace starts using OAuth, it cannot revert to a Personal Access Token.</div>
34
+
<divclass="alert alert-warning">New workspace integrations must authenticate using OAuth. Workspaces already integrated with a Personal Access Token continue to function and can switch to OAuth at any time. After a workspace starts using OAuth, it cannot revert to a Personal Access Token.</div>
35
35
36
-
<divclass="alert alert-info">The following steps must be performed by a Databricks account admin. A workspace admin alone does not have sufficient permissions to create service principals at the account level.</div>
37
-
38
-
1. In your Databricks account console, click **User Management** in the left menu. Then, under the **Service principals** tab, click **Add service principal**.
39
-
2. Under the **Credentials & secrets** tab, click **Generate secret**. Set **Lifetime (days)** to the maximum value allowed (730), then click **Generate**. Take note of your client ID and client secret. Also take note of your account ID, which can be found by clicking on your profile in the upper-right corner. (You must be in the account console to retrieve the account ID. The ID will not display inside a workspace.)
40
-
3. Click **Workspaces** in the left menu, then select the name of your workspace.
41
-
4. Go to the **Permissions** tab and click **Add permissions**.
42
-
5. Search for the service principal you created and assign it the **Admin** permission.
36
+
1. As a **Databricks workspace admin**, go to **Settings** by clicking on your profile in the upper-right corner from within a workspace.
37
+
2. Under the **Identity and access** tab, click **Manage** next to **Service principals**. Click **Add service principal**, then **Add new**. Enter a name, then click **Add**.
38
+
3. Click on the name of your new service principal. Under the **Secrets** tab, click **Generate secret**. Set **Lifetime (days)** to the maximum value allowed (730), then click **Generate**. Take note of your client ID and client secret.
39
+
4. Under the **Permissions** tab, click **Grant access**. Search for the new service principal and grant it the **Manage** permission. Click **Save**.
40
+
5. Go back to the **Identity and access** tab and click **Manage** next to **Groups**. Click the **admins** group and add the new service principal by clicking **Add members**.
43
41
6. In Datadog, open the Databricks integration tile.
44
42
7. On the **Configure** tab, click **Add Databricks Workspace**.
45
-
9. Enter a workspace name, your Databricks workspace URL, account ID, and the client ID and secret you generated.
43
+
8. Enter a workspace name, your Databricks workspace URL, and the client ID and secret you generated.
46
44
<!-- xxz tab xxx -->
47
45
48
46
<!-- xxx tab "Use a Personal Access Token (Legacy)" xxx -->
49
-
<divclass="alert alert-warning">This option is only available for workspaces created before July 7, 2025. New workspaces must authenticate using OAuth.</div>
47
+
<divclass="alert alert-warning">This option is only available for workspace integrations created before July 7, 2025. New workspace integrations must authenticate using OAuth.</div>
50
48
51
49
1. In your Databricks workspace, click on your profile in the top right corner and go to **Settings**. Select **Developer** in the left side bar. Next to **Access tokens**, click **Manage**.
52
50
2. Click **Generate new token**, enter "Datadog Integration" in the **Comment** field, remove the default value in **Lifetime (days)**, and click **Generate**. Take note of your token.
0 commit comments