Red Hat Developer Hub 1.9

Adoption Insights in Red Hat Developer Hub

Delivering detailed analytics on adoption and engagement within your internal developer portal

Red Hat Customer Content Services

Abstract

As a platform engineer, you can configure Adoption Insights in Red Hat Developer Hub (RHDH) to visualize key metrics and trends to get information about the usage of RHDH in your organization.

Visualize key metrics and trends to monitor adoption, engagement, and usage of Red Hat Developer Hub through the Adoption Insights plugin dashboard.

The Red Hat Developer Hub instance includes the Adoption Insights plugin preinstalled and enabled by default.

As organizations generate an increasing number of data events, there is a growing need for detailed insights into the adoption and engagement metrics of the internal developer portal. These insights help platform engineers make data-driven decisions to improve its performance, usability, and translate them into actionable insights.

You can use Adoption Insights in Red Hat Developer Hub to visualize key metrics and trends to get information about the usage of Developer Hub in your organization. The information provided by Adoption Insights in Developer Hub helps you pinpoint areas of improvement, highlights popular features, and evaluates progress toward adoption goals. You can also monitor user growth against licensed users and identify trends over time.

The Adoption Insights dashboard in Developer Hub includes the following cards:

  • Active users
  • Total number of users
  • Top catalog entities
  • Top 3 templates
  • Top 3 techdocs
  • Top 3 plugins
  • Portal searches
adoption insights

1. Enable the Adoption Insights plugin

Adoption Insights is enabled by default on Developer Hub instances. If you are migrating from a Developer Preview or you previously installed Adoption Insights manually, update your configuration.

Procedure

  1. Remove legacy plugins, because Adoption Insights is now built-in. Delete the following references from your dynamic-plugins.yaml file:
  2. red-hat-developer-hub-backstage-plugin-adoption-insights
  3. red-hat-developer-hub-backstage-plugin-adoption-insights-backend
  4. red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights

  5. Enable the backstage-community-plugin-analytics-provider-segment plugin by setting disabled to false: 

    plugins:
  - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
    disabled: false

2. Disable the Adoption Insights plugin

Disable the Adoption Insights plugin by updating the dynamic plugins configuration file.

Procedure

  • In your dynamic-plugins.yaml file, update the package.disabled value of the plugin to true: 

    plugins:
  - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
    disabled: true

3. Customize the Adoption Insights plugin in Red Hat Developer Hub

Customize buffer size, flush interval, debug settings, licensed users, and RBAC permissions for the Adoption Insights plugin.

Procedure

  1. To customize maxBufferSize, flushInterval, debug, and licensedUsers in the Adoption Insights plugin, in your Red Hat Developer Hub app-config.yaml file, update the relevant settings as shown in the following code: 

    app:
  analytics:
    adoptionInsights:
      maxBufferSize: _<maximum_buffer_size>_
      flushInterval: _<flush_interval>_
      debug: _<debug_value>_
      licensedUsers: _<licensed_users>_
    maxBufferSize
    (Optional) Enter the maximum buffer size for event batching. The default value is 20.
    flushInterval
    (Optional) Enter the flush interval in milliseconds for event batching. The default value is 5000ms.
    debug
    (Optional) Enter true to enable debug logging for the Adoption Insights plugin, or false to disable it. The default value is false.
    licensedUsers
    (Optional) Enter the maximum number of licensed users who can access the RHDH instance. The default value is 100.

  2. Optional: Configure the required RBAC permission for the users who are not administrators, as shown in the following example: 

    p, role:default/_<your_team>_, adoption-insights.events.read, read, allow
g, user:default/_<your_user>_, role:default/_<your_team>_

    See Permission policies in Red Hat Developer Hub.

4. Use Adoption Insights in Red Hat Developer Hub

Access the Adoption Insights dashboard through the Administration menu to view usage metrics and analytics.

Procedure

  • In the Developer Hub application, on the navigation menu, click Administration → Adoption Insights.

4.1. Set the duration of data metrics

Set the time range for viewing metrics data, including today, last week, last month, last 28 days, last year, or a custom date range.

You can set the data metrics duration by using any of the following time ranges:

  • Today
  • Last week
  • Last month
  • Last 28 days (default)
  • Last year
  • Date range…​

Procedure

  1. On the top of the screen, click the dropdown list to display the choices.

  2. Select the duration choice for which you want to see the data metrics.

    date range

5. View the Adoption Insights card

View detailed analytics through individual dashboard cards including active users, total users, and top catalog entities.

Procedure

  • Navigate to Administration → Adoption Insights to access the dashboard cards.

5.1. View the active users

View the total number of active users over time, including returning and new users, and export the data in CSV format.

The Active users card displays the total number of active users over a specified date and time period. You can export the user data in a .csv format.

active users
Returning users
Existing users who have logged into Developer Hub previously
New users
New users who have registered and logged into Developer Hub for the first time

Procedure

  1. To view the list of active users in your Red Hat Developer Hub instance, go to Administration → Adoption Insights, and see the Active users card.
  2. To view the exact number of users for a particular day, hover over the corresponding date in the Active users card.
  3. To export the user data in a .csv format, click the Export CSV link.

5.2. View the total number of users

View the total number of licensed users, and compare logged-in users versus licensed users in numeric and percentage format.

This card displays the total number of users who have license to use Red Hat Developer Hub. It also provides a comparison of the number of Logged-in users and Licensed users in numeric and percentage form.

Logged-in users
Total number of users, including licensed and unlicensed users, currently logged in to Developer Hub.
Licensed users
Total number of licensed users logged in to Developer Hub. You can set the target for the number of licensed users in your Developer Hub app-config.yaml file.

Procedure

  1. To view the total number of users in your Developer Hub instance in numeric and percentage forms, go to Administration → Adoption Insights and see the Total number of users card.
  2. To view a percentage representation of the total number of logged-in users among the total number of licensed users, hover over the tooltip in the Total number of users card.

5.3. View the top catalog entities

View the most-viewed catalog entities including name, type, last used date, and total views in the Top catalog entities card.

This card lists the most-viewed catalog entities (such as components, APIs, and so on) and documentation entries, including usage statistics, in a table.

Each item displays the following details:

Name
Name of the catalog
Kind
Type of the catalog
Last used
The last time the catalog was used
Views
The number of times the catalog was viewed

Procedure

  1. To view the most commonly used catalog entities in your Developer Hub instance, go to Administration → Adoption Insights and see the Top catalog entities card.
  2. To know more about the displayed catalog entity, hover over the catalog entity name.

5.4. View the top 3 templates

View the most commonly used templates including name, most frequent user type, and total executions in the Top 3 templates card.

This card lists the three most commonly used templates in a table. You can click the down arrow next to 3 rows to view the full list of the commonly used templates.

Name
Name of the template
Mostly in use by
Type of user who is using this template most frequently
Executions
Number of times this template was used

Procedure

  1. To view the most commonly used templates in your Developer Hub instance, go to Administration → Adoption Insights and see the Top 3 templates card.
  2. To know more about the displayed template, hover over the template name.

5.5. View the top 3 TechDocs documents

View the most-viewed TechDocs documentation entries including name, entity type, last used date, and total views.

This card lists the most-viewed documentation entries, including the total views, in a table.

Name
Title of the document
Entity
Type of document
Last used
The last time the document was viewed
Views
Number of times the document was visited

Procedure

  1. To view the most commonly used templates in your Developer Hub instance, go to Administration → Adoption Insights and see the Top 3 techdocs card.
  2. To learn more about the documents, hover over each name.

5.6. View the top 3 plugins

View the most commonly used plugins, including name, popularity trend, and total views in the Top 3 plugins card.

This card lists the three most commonly used plugins in a table. You can click the down arrow next to 3 rows to view the full list of the commonly used plugins.

Name
Name of the plugin
Trend
Popularity of the plugin as a graph
Views
Number of times this plugin was seen

Procedure

  1. To view the most commonly used plugins and the plugin page visit trends in your Developer Hub instance, go to Administration → Adoption Insights and see the Top 3 plugins card.
  2. To know more about the displayed plugin, hover over the plugin name.

6. Modify the number of displayed records

Change the number of displayed records from top 3 to top 5, 10, or 20 for catalog entities, templates, TechDocs, and plugins cards.

You can modify the number of displayed records in Adoption Insights for the following cards:

  • Top catalog entities
  • Top 3 templates
  • Top 3 techdocs
  • Top 3 plugins

You can select any of the following number of records for display:

  • Top 3
  • Top 5
  • Top 10
  • Top 20

By default, the top three most-viewed catalog entities are displayed.

Procedure

  • Go to Administration → Adoption Insights and click the Down arrow next to 3 rows to change the number of displayed records.

    Catalog Entities dropdown

7. Filter records to display specific catalog entities in Top catalog entities

By default, the Top catalog entities card displays all of the items in your Developer Hub instance. Filter the Top catalog entities card to display specific entity types.

Procedure

  • To view a specific catalog entity in the table, go to Administration → Adoption Insights, click the drop-down list on the Top catalog entities card, and select the item that you want to view.

8. View Searches

View portal search trends over time, including total searches and average searches per time period in the Searches card.

In the Searches card, you can view the following data:

  • Visualizes the number of portal searches and trends over time as a graph
  • Displays the total for the period in the card title
  • Clarifies the average number each hour/day/week/month depending on the time period chosen

Procedure

  • Go to Administration → Adoption Insights to view the Searches card.

Legal Notice

Copyright © 2026 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.