---
title: "Migrate to v2 Datasource"
slug: "migrate-to-v2-data-source"
description: "Migrate from the deprecated Kentik Grafana App to the standalone Kentik Connect Datasource plugin."
updated: 2026-06-09T16:28:42Z
published: 2026-06-09T16:28:42Z
canonical: "kb.kentik.com/migrate-to-v2-data-source"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.kentik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate to v2 Datasource

This article describes how to migrate to the v2 Kentik Connect Datasource for [**Grafana**](/v1/docs/grafana).

To provide a richer query experience and better performance, the legacy Kentik Grafana App (`kentik-connect-app`) has been deprecated and replaced by the standalone [**Kentik Connect Datasource**](https://grafana.com/grafana/plugins/kentik-connect-datasource/) (`kentik-connect-datasource`).

> [!TIP]
> **What to Expect During the Upgrade**: Version 1.8.0 of the legacy app acts as an "inert bridge". Its only job is to declare `kentik-connect-datasource` as a dependency so Grafana auto-installs it. Once the datasource is installed, the following happens:
> 
> - Any existing legacy v1.7.x app pages and built-in dashboards will disappear.
> - Any links to the above will result in a "dashboard not found" error.

## Migration Steps for Existing Users

If you currently have the legacy `kentik-connect-app` (v1.7.0 or older) installed, follow these steps to migrate your setup:

1. **Update the Legacy App**: In Grafana, navigate to **Administration >** **Plugins**, search for the legacy `kentik-connect-app`, and update it to v1.8.0. This will automatically install `kentik-connect-datasource` as a dependency.
2. **Update the Data Source Plugin**: Search for the `kentik-connect-datasource` and update it to the latest version (v2.0.1 or higher). The automatic bridge only pulls the initial v2.0.0 version, so a manual update ensures you have the latest patches.
3. **Configure Credentials**: Navigate to **Connections >** **Data Sources >** **Kentik** and enter your Kentik user email and API token.

![Kentik settings page for entering credentials and saving API settings.](https://cdn.us.document360.io/082e25b5-afce-42d4-8f47-70bd3f1d02b7/Images/Documentation/IG-kentik-grafana-login(1).png)

> [!NOTE]
> **Note**: Your existing credentials from the legacy app (`kentik-connect-app`) do not carry over. You must re-enter them as part of this migration.
4. **Import New Dashboards**: On the data source configuration page, open the **Dashboards** tab and click **Import** next to each of the four bundled dashboards: Home, Top Talkers, Network Health & Traffic Overview, Site & Device Overview.

![The Kentik Datasource settings in Grafana, showing the four bundled dashboards ready for import.](https://cdn.us.document360.io/082e25b5-afce-42d4-8f47-70bd3f1d02b7/Images/Documentation/base64-converted-image-1780411609133.png)
5. **Update Existing Panels**: If you built custom dashboards using the legacy app, you must manually point them to the new data source. Open your dashboard, click the title of a panel, and select **Edit**. In the query editor section below the graph, click the data source dropdown and select the new Kentik data source. Your existing filters and queries will carry over automatically. Be sure to save the dashboard when finished.
6. **Clean Up**: Once all your panels are migrated and working correctly, navigate back to **Administration >** **Plugins**, select the legacy `kentik-connect-app` and click **Uninstall** to safely remove it.

Next, learn more about [**Dashboards & Querying**](/v1/docs/dashboards-querying) with the Kentik Connect Datasource for Grafana.