Metabase

Overview

Datadog’s Metabase integration helps data teams make changes to their data platform without breaking Metabase dashboards, and identify unused cards or dashboards. When Datadog connects, it:

  • Pulls metadata from your Metabase environment, including cards and dashboards.
  • Automatically generates lineage from warehouse tables and columns to downstream Metabase cards, as well as from those cards to downstream dashboards.

Connect Metabase

Prerequisites

This integration requires a Metabase Pro or Enterprise plan.

Generate an API key

Follow Metabase’s API documentation to generate an API key.

Get DNS alias (required for cloud instances only)

  1. Log into your Metabase cloud instance as an administrator.
  2. Click on the gear icon in the upper right corner.
  3. Select Admin settings.
  4. Go to the Settings tab.
  5. Click on the Cloud tab from the left menu.
  6. Click on Go to the Metabase Store.
  7. Log into your Metabase Store using Metabase credentials.
  8. Go to the Instances tab.
  9. Click on the DNS alias section to get the DNS alias value.

Get self-hosted instance domain (required for self-hosted instances only)

Note: Your self-hosted Metabase instance must be accessible from the internet through HTTPS only.

  1. Log in to your Metabase instance as an administrator.
  2. Click on the gear icon in the upper right corner.
  3. Select Admin settings.
  4. Go to the Settings tab.
  5. Click on the General tab from the left menu.
  6. Under SITE URL, copy the domain portion of the URL. For example, if the URL is https://example.com, copy example.com.

Add the Metabase integration

  1. Navigate to the Metabase integration tile and enter the following information:

    ParameterDescription
    Account nameDatadog-only account name associated with these credentials.
    Instance typeThe hosting type of your Metabase instance. Valid values are cloud or self-hosted. Default is cloud.
    DNS aliasThe DNS alias of your Metabase cloud instance (required for cloud instances only). Must be at least three characters long and contain only lowercase letters, dashes, and numbers.
    Self-hosted instance domainThe domain of your self-hosted Metabase instance (required for self-hosted instances only). Must be publicly accessible through HTTPS only (for example, example.com).
    Metabase API keyThe API key used to authenticate the API requests.

  2. After you’ve entered these credentials, click Save.

What’s next

When your Metabase account is successfully connected, Datadog syncs and automatically derives lineage from warehouse tables/columns to Metabase cards and dashboards.

Initial syncs may take up to several hours depending on the size of your Metabase deployment.

After syncing, you can explore your Metabase assets and their upstream dependencies in the Data Observability Explorer.

Further reading

Additional helpful documentation, links, and articles:

Learn about Data ObservabilityDOCUMENTATION more more