Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5381,6 +5381,11 @@ menu:
identifier: business_intelligence_integrations_powerbi
parent: business_intelligence_integrations
weight: 4000000
- name: Hex
url: data_observability/quality_monitoring/business_intelligence/hex
identifier: business_intelligence_integrations_hex
parent: business_intelligence_integrations
weight: 5000000
- name: Jobs Monitoring
url: data_observability/jobs_monitoring/
pre: data-jobs-monitoring
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ Use these integrations to:
{{< nextlink href="data_observability/quality_monitoring/business_intelligence/sigma" >}}Sigma{{< /nextlink >}}
{{< nextlink href="data_observability/quality_monitoring/business_intelligence/metabase" >}}Metabase{{< /nextlink >}}
{{< nextlink href="data_observability/quality_monitoring/business_intelligence/powerbi" >}}Power BI{{< /nextlink >}}
{{< nextlink href="data_observability/quality_monitoring/business_intelligence/hex" >}}Hex{{< /nextlink >}}
{{< /whatsnext >}}

## Further reading
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: Hex
description: Connect Hex to Datadog Data Observability to view end-to-end lineage from warehouse tables to Hex projects.
further_reading:
- link: '/data_observability/'
tag: 'Documentation'
text: 'Learn about Data Observability'
---

## Overview

Datadog's Hex integration helps data teams understand which Hex projects and notebooks depend on their warehouse tables, so you can assess the impact of a schema or pipeline change before it breaks a report. When Datadog connects, it:

- Pulls project and SQL cell metadata from your Hex workspace.
- Parses the SQL in each cell to generate table- and column-level lineage from your warehouse to downstream Hex projects.

**Note**: Only SQL cells are synced. Code, Markdown, chart, and input cells are not included in lineage.

## Connect Hex

### Generate an API token

1. In your Hex workspace settings, go to the {{< ui >}}API keys{{< /ui >}} page.
1. Click {{< ui >}}New Token{{< /ui >}}.
1. Provide a description and an expiration. Datadog recommends a token with no expiration.
1. Under API scopes, select **Read Access** for {{< ui >}}Projects{{< /ui >}}, {{< ui >}}Cells{{< /ui >}}, and {{< ui >}}Data connections{{< /ui >}}.

### Add the Hex integration

Navigate to the Hex integration tile and enter the following information:

| Parameter | Description |
|-----------|-------------|
| API Token | The workspace token generated above. |
| Custom Domain | Optional. Set this if your workspace uses a single-tenant, EU multi-tenant, or HIPAA multi-tenant Hex domain (for example, `eu.hex.tech`). Leave blank for the standard `app.hex.tech`. |
| Workspace ID | Optional. Used to generate direct links from Datadog to your Hex projects and cells. Find it in any Hex URL: `https://app.hex.tech/<workspace_id>/hex/...`. |

Datadog syncs your Hex workspace every 60 minutes.

## Supported warehouses

Lineage resolution is fully supported for Hex data connections to **Snowflake** and **BigQuery**. Databricks and Postgres data connections are recognized, but lineage resolution for them is incomplete as of this writing — contact [support][1] if you rely on Hex-to-Databricks or Hex-to-Postgres lineage.

[1]: /help/
Loading