---
title: Metabase
description: Gain insights into Metabase activity events, view logs and query logs.
breadcrumbs: Docs > Integrations > Metabase
---

# Metabase
Integration version1.1.0            Metabase - Activity Overview 1Metabase - Activity Overview 2Metabase - Activity Overview 3Metabase - Views Overview 1Metabase - Views Overview 2Metabase - Views Overview 3Metabase - Query Overview 1Metabase - Query Overview 2
## Overview{% #overview %}

[Metabase](https://www.metabase.com/) is a business intelligence analytics platform that can be used to ask questions about your data, or can be embedded in your apps to let your customers explore their data on their own.

Integrate Metabase with Datadog for:

**Log Collection**: Gain insights into activity event logs, view logs, and query logs through the Metabase API. The data is normalized and enriched before ingestion. Pre-built dashboard visualizations provide immediate insights into Metabase logs.

**Data Lineage**: View end-to-end lineage across Metabase collections, dashboards, and cards to understand dependencies and downstream impact.

## Setup{% #setup %}

### Prerequisites{% #prerequisites %}

- This integration requires a Metabase Pro or Enterprise plan.

### Generate API credentials in Metabase{% #generate-api-credentials-in-metabase %}

1. Log into your Metabase instance as an administrator.
1. Click on the gear icon in the upper right corner.
1. Select **Admin settings**.
1. Go to the **Settings** tab.
1. Click on the **Authentication** tab from the left menu.
1. Select the **API Keys** section.
1. Click **Create API Key**.
1. Enter a key name.
1. Select the **Administrators** Group.
1. Click **Create** to get the generated API key.

### Get DNS alias of Metabase (required for cloud instances only){% #get-dns-alias-of-metabase-required-for-cloud-instances-only %}

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

### Get self-hosted instance domain of Metabase (required for self-hosted instances only){% #get-self-hosted-instance-domain-of-metabase-required-for-self-hosted-instances-only %}

**Note**: Your self-hosted Metabase instance must be accessible from the internet via HTTPS only, and ensure that the API is not being intercepted by SAML/SSO at the proxy/network level.

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

### Connect your Metabase account to Datadog{% #connect-your-metabase-account-to-datadog %}

1. Add your Metabase instance type, DNS alias or self-hosted domain, and API key.

| Parameters                           | Description                                                                                                                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Metabase instance type               | The hosting type of your Metabase instance. Valid values are `cloud` or `self-hosted`. Default is `cloud`.                                                                         |
| Metabase DNS alias                   | The 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. |
| Metabase self-hosted instance domain | The domain of your self-hosted Metabase instance (required for self-hosted instances only). Must be publicly accessible via HTTPS only (e.g., example.com).                        |
| Metabase API key                     | The API key used to authenticate the API requests.                                                                                                                                 |

1. Click the Save button to save your settings.

## Data Collected{% #data-collected %}

### Logs{% #logs %}

The Metabase integration collects and forwards Metabase activity event logs, view logs, and query logs to Datadog.

### Metrics{% #metrics %}

The Metabase integration does not include any metrics.

### Events{% #events %}

The Metabase integration does not include any events.

## Support{% #support %}

For further assistance, contact [Datadog Support](https://docs.datadoghq.com/help/).