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

  • Published on Jun 9, 2026
  • 1 minute(s) read
  • Ben F
  • AC
 Prev Next

This article describes how to migrate to the v2 Kentik Connect Datasource for 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 (kentik-connect-datasource).

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.

    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.

  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 with the Kentik Connect Datasource for Grafana.

Related articles