** DO NOT REMOVE Hidden Margin Required **

UNRAVEL FOR DATABRICKS DEPLOYMENT GUIDE

Getting started with your Unravel account has never been easier!

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

Bring Unravel to life by connecting your telemetry data

For you to get value from your account, we need access to your telemetry data. This guide provides instructions on how to connect a Databricks workspace to your Unravel account. Review our Privacy & Security FAQs for details on how your telemetry data is correlated within Unravel.

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
GENERATE ACCESS TOKEN

Step 1: Create a personal access token within Databricks

In this step we will confirm that the ability to create personal access tokens is enabled within your Databricks workspace, then create one for your Databricks user. (Required for the next step.) Personal access tokens are used to authenticate to and access Databricks REST APIs.

Get Live HelpWatch Video
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

WHAT YOU NEED
Administrator-level access to your Databricks workspace. Note, you’ll need this for Step 2 as well.

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

    1. Enable personal access token authentication for your Databricks workspace.

      This is done in the Databricks Platform, not the Administrator Account Console. The web address should resemble this URL: https://dbc-c94690a5-8580.cloud.databricks.com. You will need administrator access privileges to complete this step.

      1. Sign in to your Databricks account
      2. From the dropdown located in the upper right corner, select the Admin Settings link.
      3. Select the Advanced link from the vertical Settings menu.
      4. Verify that the Personal Access Tokens setting is toggled to Enabled. If not, toggle it now.

 

  1. Create a Databricks personal access token for your Databricks workspace user.
    1. From the dropdown located in the upper right corner, select the User Settings link.
    2. Select the Developer link from the vertical Settings menu.
    3. Select the Manage button next to Access tokens.
    4. Select the Generate new token button.
    5. In the Comment field, enter a human-readable term to identify your token later. For example, Unravel.
    6. Select the Generate button. KEEP THE NEXT DIALOG BOX AND BROWSER TAB OPEN.
    7. Congrats, your new personal access token is now generated! KEEP THIS NEXT DIALOG BOX AND BROWSER TAB OPEN as you will not be able to see it again and will need to access this token for the next step: Add your Databricks workspace within Unravel.
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
ADD UNRAVEL WORKSPACE

Step 2: Add your Databricks workspace within Unravel

In this step we will add your Databricks workspace to Unravel by filling out a short form with information regarding your workspace. Standard accounts are limited to one workspace.

Get Live HelpWatch Video
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

WHAT YOU NEED
A browser open with the personal access token dialog box from the previous step. Additionally, the Databricks plan your workspace is subscribed to. If you don’t know, ask your Databricks Administrator.

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

  1. Sign in to your Unravel account.

  2. Select the Gear icon located in the upper right corner. Then from the dropdown, select the Workspaces link.

  3. From the Workspace Manager screen, select the Add Workspace button.

  4. Submit the required inputs into the Add Workspace form.
    1. In the Workspace ID field, enter your Databricks workspace ID. See tip below on how to locate it.

      TIP
      The quickest way to locate your Databricks workspace ID is to copy it from the web URL. Sign in to your Databricks workspace and look at the URL displayed in your browser’s address bar. The workspace ID is the long series of numbers displayed at the end of the web URL after o=. For example, in this URL: https://dbc-c94690a5-8580.cloud.databricks.com/browse?o=4135841184671186, the Databricks workspace ID is 4135841184671186.

    2. In the Workspace Name field, enter a human-readable term to identify your workspace later. For example, ACME-Workspace.
    3. In the Instance(Region) URL field, enter your Databricks workspace URL. See tip below on how to locate it.

      TIP
      The quickest way to locate your Databricks workspace URL is to copy it from the web URL. Sign in to your Databricks workspace and look at the URL displayed in your browser’s address bar. The workspace URL is the long character and number string displayed before the forward slash (/). For example, in this URL: https://dbc-c94690a5-8580.cloud.databricks.com/browse?o=4135841184671186, the Databricks workspace URL is https://dbc-c94690a5-8580.cloud.databricks.com.

    4. In the Tier field, select your Databricks workspace subscription plan from the available radio button options. You will need to get this from your Databricks Administrator. See tip below on how to locate it.

      TIP
      The quickest way to locate your Databricks workspace subscription plan is to go to the Administrator Account Console (not the Databricks Platform) and select Settings from the vertical menu. Your current plan will be displayed on the default Subscriptions & billing tab. Contact your Databricks Administrator should you need help.

    5. In the Token field, enter your personal access token you generated from Step 1: Create a personal access token within Databricks.
    6. Select the Save button. Unravel will need a few minutes to add your new Databricks workspace. Do not refresh this page or close this dialog box.
    7. Congrats, your Databricks workspace is now connected to Unravel. Almost done!
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
CONFIGURE CLUSTERS

Step 3: Enable the global init script within Databricks

In this step we will enable Unravel’s global init script within Databricks to add our configure to all your clusters in your workspace. The global init script is deployed automatically on the workspace but needs to be enabled manually.

Get Live HelpWatch Video
** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

WHAT YOU NEED
Administrator-level access to your Databricks workspace.

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **

  1. Sign in to your Databricks account.

    This should be the Databricks Platform, not the Administrator Account Console. The web address should resemble this URL: https://dbc-c94690a5-8580.cloud.databricks.com. You will need administrator access privileges to complete this step.

  2. From the dropdown located in the upper right corner, select the Admin Settings link.

  3. Select the Compute link from the vertical Settings menu.

  4. Select the Manage button next to Global init scripts.

  5. You should see unravel_init listed among the init scripts configured for your workspace. Select the Toggle under the Enabled column to enable it.

** DO NOT REMOVE Hidden Margin Required **
** DO NOT REMOVE Hidden Margin Required **
Congrats, all done!

Now you'll start seeing Unravel's detailed visibility into Databricks performance + usage.

Next up, take Unravel’s unique features out for a test drive. Need help? We’re here to help. Check out options below for guidance and support.

Privacy & SecuritySelf-Guided ToursSchedule Live Help
** DO NOT REMOVE Hidden Margin Required **
AI-POWERED DATA OBSERVABILITY & FINOPS

Accelerate lakehouse performance and efficiency.

BOOK A DEMOSELF-GUIDED TOUR
** DO NOT REMOVE Hidden Margin Required **