|
| 1 | +--- |
| 2 | +title: Hex |
| 3 | +description: Connect Hex to Datadog Data Observability to view field-level lineage from warehouse tables to Hex projects and SQL cells. |
| 4 | +further_reading: |
| 5 | + - link: '/data_observability/' |
| 6 | + tag: 'Documentation' |
| 7 | + text: 'Learn about Data Observability' |
| 8 | +--- |
| 9 | + |
| 10 | +## Overview |
| 11 | + |
| 12 | +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: |
| 13 | + |
| 14 | +- Pulls metadata from your Hex workspace, including projects and SQL cells |
| 15 | +- Generates field-level lineage between warehouse tables and columns and downstream Hex projects and SQL cells |
| 16 | +- Derives lineage for all [supported data warehouse destinations][1] |
| 17 | + |
| 18 | +## Setup |
| 19 | + |
| 20 | +### Create a Hex workspace token |
| 21 | + |
| 22 | +1. In your Hex workspace settings, go to the {{< ui >}}API keys{{< /ui >}} page. |
| 23 | +2. Click {{< ui >}}New Token{{< /ui >}} to generate a workspace token. |
| 24 | +3. Provide a description and an expiration time frame. Datadog recommends setting up a token with no expiration. |
| 25 | +4. For the API scopes, select {{< ui >}}Read Access{{< /ui >}} under {{< ui >}}Projects{{< /ui >}}, {{< ui >}}Cells{{< /ui >}}, and {{< ui >}}Data connections{{< /ui >}}. |
| 26 | + |
| 27 | +### Add the API credentials to Datadog |
| 28 | + |
| 29 | +1. Navigate to the [Hex integration tile][2]. |
| 30 | +2. Click {{< ui >}}Configure{{< /ui >}} > {{< ui >}}+ Add New Account{{< /ui >}}. |
| 31 | +3. Fill out the form with the following: |
| 32 | + - {{< ui >}}API Token{{< /ui >}}: The token from the previous step |
| 33 | + - {{< ui >}}Workspace URL{{< /ui >}}: Required only if you are a single-tenant, EU multi-tenant, or HIPAA multi-tenant customer. Leave empty otherwise. |
| 34 | +4. Click {{< ui >}}Save{{< /ui >}}. |
| 35 | + |
| 36 | +## What's next |
| 37 | + |
| 38 | +It can take up to 60 minutes for data to appear after the initial setup. |
| 39 | + |
| 40 | +After syncing, you can explore your Hex projects and their upstream warehouse dependencies in the [Data Observability Catalog][3]. |
| 41 | + |
| 42 | +## Further reading |
| 43 | + |
| 44 | +{{< partial name="whats-next/whats-next.html" >}} |
| 45 | + |
| 46 | +[1]: /data_observability/quality_monitoring/data_warehouses |
| 47 | +[2]: https://app.datadoghq.com/integrations/hex |
| 48 | +[3]: https://app.datadoghq.com/data-obs/catalog |
0 commit comments