For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/data_observability/quality_monitoring/business_intelligence/hex.md. A documentation index is available at /llms.txt.
This product is not supported for your selected Datadog site. ().

Overview

Datadog’s Hex integration helps data teams view end-to-end lineage between warehouse tables and Hex projects. The integration collects metadata and field-level lineage for objects in your Hex workspace. When Datadog connects, it:

  • Pulls metadata from your Hex workspace, including projects and SQL cells
  • Generates field-level lineage between warehouse tables and columns and downstream Hex projects and SQL cells
  • Derives lineage for all supported data warehouse destinations

Setup

Create a Hex workspace token

  1. In your Hex workspace settings, go to the API keys page.
  2. Click New Token to generate a workspace token.
  3. Provide a description and an expiration time frame. Datadog recommends setting up a token with no expiration.
  4. For the API scopes, select Read Access under Projects, Cells, and Data connections.

Add the API credentials to Datadog

  1. Navigate to the Hex integration tile.
  2. Click Configure > + Add New Account.
  3. Fill out the form with the following:
    • API Token: The token from the previous step
    • Workspace URL: Required only if you are a single-tenant, EU multi-tenant, or HIPAA multi-tenant customer. Leave empty otherwise.
  4. Click Save.

What’s next

It can take up to 60 minutes for data to appear after the initial setup.

After syncing, you can explore your Hex projects and their upstream warehouse dependencies in the Data Observability Catalog.

Further reading

Additional helpful documentation, links, and articles: