Red Hat Developer Hub 1.7

Adoption Insights in Red Hat Developer Hub

Delivers 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 RHDH to visualize key metrics and trends to get information about the usage of RHDH in your organization.

1. Adoption Insights

1. Adoption Insights

The Red Hat Developer Hub instance comes with 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 pinpoints areas of improvement, highlights popular features, and evaluates progress toward adoption goals. You can also monitor user growth against license users and identify trends over time.

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

Active users
Total nuber of users
Top catalog entities
Top 3 templates
Top 3 techdocs
Top 3 plugins
Portal searches

1.1. Configuring the Adoption Insights plugin in Red Hat Developer Hub

The Adoption Insights plugin is preinstalled and enabled on a Developer Hub instance by default. You can disable or enable the Adoption Insights plugin and change other parameters, by configuring the Red Hat Developer Hub Helm chart or the Red Hat Developer Hub Operator ConfigMap.

1.2. Customizing the Adoption Insights plugin in Red Hat Developer Hub

You can customize the Adoption Insights plugin to suit your needs by disabling or re-enabling it, and adjusting other settings as needed.

For the Red Hat Developer Hub Adoption Insights plugin, you must manually disable the plugin.

Procedure

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-config.yaml fragment
```
app:
  analytics:
    adoptionInsights:
      maxBufferSize: _<maximum_buffer_size>_ 1
      flushInterval: _<flush_interval>_ 2
      debug: _<debug_value>_ 3
      licensedUsers: _<licensed_users>_ 4
```
1
(Optional) Specifies the maximum buffer size for event batching. The default value is 20.
2
(Optional) Specifies the flush interval in milliseconds for event batching. The default value is 5000ms.
3
(Optional) The default value is false.
4
(Optional) Specifies the maximum number of licensed users who can access the RHDH instance. The default value is 100.

To disable the Adoption Insights plugin, in your app-config-dynamic.yaml file, update the package.disabled value to false as shown in the following example:

  - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
    disabled: true
  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-adoption-insights:bs_1.35.1__0.0.3!red-hat-developer-hub-backstage-plugin-adoption-insights
    disabled: true
    pluginConfig:
      dynamicPlugins:
        frontend:
          red-hat-developer-hub.backstage-plugin-analytics-module-adoption-insights:
            analyticsApiExtensions:
              - importName: AdoptionInsightsAnalyticsApi

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.

1.3. Using Adoption Insights in Red Hat Developer Hub

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

1.3.1. Setting the duration of data metrics

You can set the data metrics duration using any of the time ranges, such as Today, Last week, Last month, Last 28 days (default), Last year, or Date range….

Procedure

On the top of the screen, click the dropdown list to display the choices.
Select the duration choice for which you want to see the data metrics.

1.4. Viewing the Adoption Insights card

1.4.1. Viewing the active users

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.

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

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

1.4.2. Viewing the total number of users

This card displays the total number of users that 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

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.
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.

1.4.3. Viewing the top catalog entities

This card lists the most viewed catalog entities (like 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

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.
To know more about the displayed catalog entity, hover over the catalog entity name.

1.4.4. Viewing the top 3 templates

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 using this template most frequently
Executions: Number of times this template was used

Procedure

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

1.4.5. Viewing the top 3 techdocs

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

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

1.4.6. Viewing the top 3 plugins

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

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.
To know more about the displayed plugin, hover over the plugin name.

1.5. Modifying the number of displayed records

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

1.5.1. Modifying the number of displayed records in Top catalog entities

You can modify the number of records that are displayed in the Top catalog entities card. 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.

1.5.2. Modifying the number of displayed records in Top 3 templates

You can modify the number of records that are displayed in the Top 3 templates card. 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 templates are displayed.

Procedure

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

1.5.3. Modifying the number of displayed records in Top 3 techdocs

You can modify the number of records that are displayed in the Top 3 techdocs card. 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 TechDocs are displayed.

Procedure

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

1.5.4. Modifying the number of displayed records in Top 3 plugins

You can modify the number of records that are displayed in the Top 3 plugins card. 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 plugins are displayed.

Procedure

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

1.5.5. Modifying the number of displayed records in Top catalog entities

You can modify the number of records that are displayed in the Top catalog entities card. 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.

1.5.6. Modifying the number of displayed records in Top 3 templates

You can modify the number of records that are displayed in the Top 3 templates card. 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 templates are displayed.

Procedure

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

1.5.7. Modifying the number of displayed records in Top 3 techdocs

You can modify the number of records that are displayed in the Top 3 techdocs card. 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 TechDocs are displayed.

Procedure

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

1.5.8. Modifying the number of displayed records in Top 3 plugins

You can modify the number of records that are displayed in the Top 3 plugins card. 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 plugins are displayed.

Procedure

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

1.6. Filtering records to display specific catalog entities in Top catalog entities

You can use the dropdown filter in the title to filter the table display by any of the items. By default, the Top catalog entities card displays all of the items in your Developer Hub instance.

Procedure

To view a specific catalog entity in the table, complete the following step:

Go to Administration → Adoption Insights, click the dropdown filter on the Top catalog entities card, and select the item that you want to view.

1.7. Viewing Searches

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

Legal Notice

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.