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

# Insights

> Monitor Portal adoption with usage analytics, developer sentiment surveys, and DevEx Metrics dashboards covering active users and feature engagement.

## Overview

Insights puts you in control of your Portal adoption journey by presenting you with data
and dashboards related to your developers' usage and sentiment of Portal:

* **Usage data**: Analyze overall active user trends, or dig deeper into key features
  that drive adoption, like the Catalog, Templates, or Search.
* **DevEx Metrics**: Understand developer productivity across your organization with
  automatically collected metrics covering pull requests, CI/CD, incidents, AI usage, and
  more. [Learn more](/portal/core-features-and-plugins/devex-metrics).
* **Surveys**: Configure short, in-context surveys that ask developers for qualitative
  feedback about Portal in-the-moment.

Find out more in the [Insights plugin documentation](/plugins/insights).

## Enabling Insights

It could take up to 48 hours before Insights' dashboards are populated with usage data, so
we recommend that you enable Insights as early as possible.

#### 1. Configure the plugin

Before you can start the plugin, you'll need to configure an API token.

1. Get a Spotify API token for your organization. See [detailed instructions here](/plugins/insights/setup-and-installation#create-an-api-token-for-your-organization)
   or [reach out to support](https://backstage.spotify.com/account/support/).
2. Open **Plugins** and find the `Backstage-insights` plugin card. click
   the `Manage plugin` button.
3. Enter the API token you retrieved in step 1 into the Spotify API Token field
   at the bottom of the configuration form.
4. Click `Save changes`.

#### 2. Start the plugin

1. After your configuration has been successfully saved, click `Start plugin` at the top of
   the plugin configuration page.
2. After the plugin has been successfully enabled, you should see an `Insights` navigation
   item in the nav bar. This is only accessible to Portal admins.