diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 69ba6d57d55..12124ea9e37 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -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 diff --git a/content/en/data_observability/quality_monitoring/business_intelligence/_index.md b/content/en/data_observability/quality_monitoring/business_intelligence/_index.md index bda3beeffe2..bb5e8beaa5f 100644 --- a/content/en/data_observability/quality_monitoring/business_intelligence/_index.md +++ b/content/en/data_observability/quality_monitoring/business_intelligence/_index.md @@ -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 diff --git a/content/en/data_observability/quality_monitoring/business_intelligence/hex.md b/content/en/data_observability/quality_monitoring/business_intelligence/hex.md new file mode 100644 index 00000000000..516fdeaee97 --- /dev/null +++ b/content/en/data_observability/quality_monitoring/business_intelligence/hex.md @@ -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//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/