Repository: redhat-developer/red-hat-developers-documentation-rhdh
Pull request #1000: RHDHPAI-596: Added content for RHDH adoption insights plugin
Author: login: pabel-rh
Labels: name: Technical review done :partly_sunny:
description: Any procedure has been succesfully tested
name: Ready to merge  :guard:
name: Peer review done :blue_book:
Created: 2025-03-20T10:14:00Z | Merged: 2025-03-21T11:20:27Z

<!--- PR title format: [GH#<gh-issue-id>][BZ#<bz-issue-id>][RHIDP#<jira-issue-id>]: <short-description-of-the-pr> --->

<!--- If your changes apply to the latest released and/or in-development version of RHDH, open your PR against the `main` branch and cherrypick your PR to any released branches that you want to apply your changes to. --->

**IMPORTANT: Do Not Merge - To be merged by Docs Team Only**

**Version(s):**
1.5
**Issue:**
[RHDHPAI-596](https://issues.redhat.com/browse/RHDHPAI-596)
**Preview Link:**




Diff:
diff --git a/artifacts/snip-developer-preview.adoc b/artifacts/snip-developer-preview.adoc
new file mode 100644
index 00000000000..11360d52575
--- /dev/null
+++ b/artifacts/snip-developer-preview.adoc
@@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in the Adoption Insights plugin. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
+
+For more information about the support scope of Red Hat Developer Preview features, see https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope].
+====
diff --git a/assemblies/assembly-adoption-insights.adoc b/assemblies/assembly-adoption-insights.adoc
new file mode 100644
index 00000000000..e0763e592d2
--- /dev/null
+++ b/assemblies/assembly-adoption-insights.adoc
@@ -0,0 +1,31 @@
+[id="assembly-adoption-insights"]
+= Adoption Insights
+
+include::../artifacts/snip-developer-preview.adoc[]
+
+//about adoption insights
+include::modules/observe/adoption-insights/con-about-adoption-insights.adoc[leveloffset=+1]
+
+//installing adoption insights
+include::modules/observe/adoption-insights/proc-install-adoption-insights.adoc[leveloffset=+1]
+
+//configuring adoption insights
+include::modules/observe/adoption-insights/proc-configure-adoption-insights.adoc[leveloffset=+1]
+
+//using adoption insights
+include::modules/observe/adoption-insights/proc-using-adoption-insights.adoc[leveloffset=+1]
+
+//setting data metrics
+include::modules/observe/adoption-insights/proc-setting-duration-of-data-metrics.adoc[leveloffset=+2]
+
+//viewing cards
+include::modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc[leveloffset=+1]
+
+//modify number of displayed records
+include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc[leveloffset=+1]
+
+//filter records
+include::modules/observe/adoption-insights/proc-filter-records-to-display-spec.adoc[leveloffset=+1]
+
+//viewing searches
+include::modules/observe/adoption-insights/proc-viewing-searches.adoc[leveloffset=+1]
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/con-about-adoption-insights.adoc b/modules/observe/adoption-insights/con-about-adoption-insights.adoc
new file mode 100644
index 00000000000..bb65055255a
--- /dev/null
+++ b/modules/observe/adoption-insights/con-about-adoption-insights.adoc
@@ -0,0 +1,17 @@
+:_mod-docs-content-type: CONCEPT
+[id="con-about-adoption-insights_{context}"]
+= About Adoption Insights
+
+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 {product} to visualize key metrics and trends to get information about the usage of {product-short} in your organization. The information provided by Adoption Insights in {product-short} 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 {product-short} includes the following cards:
+
+* *Active users*
+* *Total nuber of users*
+* *Top catalog entities*
+* *Top 3 templates*
+* *Top 3 techdocs*
+* *Top 3 plugins*
+* *Portal searches*
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-configure-adoption-insights.adoc b/modules/observe/adoption-insights/proc-configure-adoption-insights.adoc
new file mode 100644
index 00000000000..94326b0f50d
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-configure-adoption-insights.adoc
@@ -0,0 +1,25 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-configure-adoption-insights_{context}"]
+= Configuring the Adoption Insights plugin in {product}
+
+You can enable the Adoption Insights plugin by configuring the {product} Helm chart or the {product} Operator ConfigMap.
+
+.Procedure
+
+* To configure the Adoption Insights plugin in {product-short}, in your {product} `app-config.yaml` file, add the following code:
++
+.`app-config.yaml` fragment
+[source,terminal]
+----
+	App:
+  analytics:
+    adoptionInsights: 
+      maxBufferSize: 20 <1>
+      flushInterval: 5000 <2>
+      debug: false <3>
+      licensedUsers: 2000 <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`.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-filter-records-to-display-spec.adoc b/modules/observe/adoption-insights/proc-filter-records-to-display-spec.adoc
new file mode 100644
index 00000000000..ce03b23d71a
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-filter-records-to-display-spec.adoc
@@ -0,0 +1,11 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-filter-records-to-display-spec_{context}"]
+= 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 {product-short} 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.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-install-adoption-insights.adoc b/modules/observe/adoption-insights/proc-install-adoption-insights.adoc
new file mode 100644
index 00000000000..b53acc5a57b
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-install-adoption-insights.adoc
@@ -0,0 +1,48 @@
+// Module included in the following assemblies:
+//
+// * assemblies/assembly-rhdh-observability.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="proc-install-adoption-insights_{context}"]
+= Installing the Adoption Insights plugin in {product}
+
+For the {product} Adoption Insights plugin, you must manually install the plugin.
+
+.Procedure
+
+* To enable the Adoption Insights plugin, set the `disabled` property to `false` in your `app-config-dynamic.yaml` file as shown in the following example:
++
+[source,yaml]
+----
+- package: oci://quay.io/_<your_rhdh_plugins_repo>_/adoption-insights:latest!red-hat-developer-hub-backstage-plugin-adoption-insights
+  disabled: false
+  pluginConfig:
+    dynamicPlugins:
+      frontend:
+        red-hat-developer-hub.backstage-plugin-adoption-insights:
+          appIcons:
+            - name: adoptionInsightsIcon
+              importName: AdoptionInsightsIcon
+          dynamicRoutes:
+            - path: /adoption-insights
+              importName: AdoptionInsightsPage
+              menuItem:
+                icon: adoptionInsightsIcon
+                text: Adoption Insights
+          menuItems:
+            adoption-insights:
+              parent: admin
+              icon: adoptionInsightsIcon
+
+- package: oci://quay.io/_<your_rhdh_plugins_repo>_/adoption-insights:latest!red-hat-developer-hub-backstage-plugin-adoption-insights-backend-dynamic
+  disabled: false
+
+- package: oci://quay.io/_<your_rhdh_plugins_repo>_/adoption-insights:latest!red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights
+  disabled: false
+  pluginConfig:
+    dynamicPlugins:
+      frontend:
+        red-hat-developer-hub.backstage-plugin-analytics-module-adoption-insights:
+          apiFactories:
+            - importName: AdoptionInsightsAnalyticsApiFactory
+----
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc b/modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc
new file mode 100644
index 00000000000..42111e999c9
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc
@@ -0,0 +1,63 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-modify-number-of-displayed-records_{context}"]
+= Modifying the number of displayed records
+
+== 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.
+
+== 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.
+
+== 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.
+
+== 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.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-setting-duration-of-data-metrics.adoc b/modules/observe/adoption-insights/proc-setting-duration-of-data-metrics.adoc
new file mode 100644
index 00000000000..e34b0ed20d7
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-setting-duration-of-data-metrics.adoc
@@ -0,0 +1,10 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-setting-duration-of-data-metrics_{context}"]
+= Setting the duration of data metrics
+
+You can set the data metrics duration using any of the time ranges, such as *All time* (default), *today*, *last week*, *last month*, *last year*, or you can select the range from the calendar.
+
+.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.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-using-adoption-insights.adoc b/modules/observe/adoption-insights/proc-using-adoption-insights.adoc
new file mode 100644
index 00000000000..86f8d4309d2
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-using-adoption-insights.adoc
@@ -0,0 +1,5 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-using-adoption-insights_{context}"]
+= Using Adoption Insights in {product}
+
+In the {product-short} application, on the navigation menu, click *Administration -> Adoption Insights*.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc b/modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc
new file mode 100644
index 00000000000..807343f9bc2
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc
@@ -0,0 +1,93 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-viewing-adoption-insights-card_{context}"]
+= Viewing the Adoption Insights card
+
+== Viewing the active users
+
+The *Active users* card displays the total number of active users over a specified time range. It also provides a breakdown comparison of *New users* and *Returning users* in a line/area graph format. You can export the user data in a .csv format.
+
+*Returning users*: Existing users who have logged into {product-short}
+
+*New users*: New users who have registered and logged into {product-short}
+
+.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.
+
+== Viewing the total number of users
+
+This card displays the total number of users that have license to use {product}. 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 {product-short}
+
+*Licensed users*: Total number of licensed users logged in {product-short}. You can set the number of licensed users in your {product-short} app-config.yaml file.
+
+.Procedure
+
+* To view the total number of users in your {product-short} 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.
+
+== 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 *Name*, *Kind*, *Last used*, and *Views*.
+
+*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 {product-short} 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.
+
+== 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 that used this template
+*Executions*: Number of times this template was used
+
+.Procedure
+
+* To view the most commonly used templates in your {product-short} 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.
+
+== Viewing the top 3 techdocs
+
+This card lists the most viewed documentation entries, including the total views, in a table.
+
+*Name*: Name of the TechDoc
+*Entity*: Type of the TechDoc
+*Last used*: The last time the TechDoc was viewed
+*Views*: Number of times the TechDocs was visited
+
+.Procedure
+
+* To view the most commonly used templates in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top 3 techdocs* card. 
+
+* To know more about the displayed techdocs, hover over the techdocs name.
+
+== 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 {product-short} 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.
\ No newline at end of file
diff --git a/modules/observe/adoption-insights/proc-viewing-searches.adoc b/modules/observe/adoption-insights/proc-viewing-searches.adoc
new file mode 100644
index 00000000000..56c0beae39c
--- /dev/null
+++ b/modules/observe/adoption-insights/proc-viewing-searches.adoc
@@ -0,0 +1,9 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-viewing-searches_{context}"]
+= 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
diff --git a/modules/observe/con-audit-log-track-changes-catalog.adoc b/modules/observe/con-audit-log-track-changes-catalog.adoc
index 28784117b1c..b913cbc83c5 100644
--- a/modules/observe/con-audit-log-track-changes-catalog.adoc
+++ b/modules/observe/con-audit-log-track-changes-catalog.adoc
@@ -4,4 +4,4 @@
 [id="con-audit-log-track-changes-catalog_{context}"]
 = {product-short} catalog database changes
 
-In {product} {ocp-version-min} and later, changes to the catalog database are forwarded to a central log management system, such as ElasticSearch or Splunk by default. Administrators can view changes that add, remove, or update data in the catalog database to help ensure accountability and transparency of user actions.
+In {product} {ocp-version-min} and later, changes to the catalog database are forwarded to a central log management system, such as ElasticSearch or Splunk by default. Administrators can view changes that add, remove, or update data in the catalog database to help ensure accountability and transparency of user actions.
\ No newline at end of file
diff --git a/modules/observe/proc-admin-enabling-metrics-ocp-helm.adoc b/modules/observe/proc-admin-enabling-metrics-ocp-helm.adoc
index 92227626310..bd5b2a71d16 100644
--- a/modules/observe/proc-admin-enabling-metrics-ocp-helm.adoc
+++ b/modules/observe/proc-admin-enabling-metrics-ocp-helm.adoc
@@ -41,4 +41,4 @@ image::rhdh/upgrade-helm-metrics.png[]
 .Verification
 
 . From the *Developer* perspective in the {ocp-short} web console, select the *Observe* view.
-. Click the *Metrics* tab to view metrics for {product} pods.
+. Click the *Metrics* tab to view metrics for {product} pods.
\ No newline at end of file
diff --git a/titles/adoption-insights/artifacts b/titles/adoption-insights/artifacts
new file mode 120000
index 00000000000..f30b6dea609
--- /dev/null
+++ b/titles/adoption-insights/artifacts
@@ -0,0 +1 @@
+../../artifacts
\ No newline at end of file
diff --git a/titles/adoption-insights/assemblies b/titles/adoption-insights/assemblies
new file mode 120000
index 00000000000..91646274dbe
--- /dev/null
+++ b/titles/adoption-insights/assemblies
@@ -0,0 +1 @@
+../../assemblies
\ No newline at end of file
diff --git a/titles/adoption-insights/docinfo.xml b/titles/adoption-insights/docinfo.xml
new file mode 100644
index 00000000000..5f7fe2ebace
--- /dev/null
+++ b/titles/adoption-insights/docinfo.xml
@@ -0,0 +1,11 @@
+<title>{title}</title>
+<productname>{product}</productname>
+<productnumber>{product-version}</productnumber>
+<subtitle>{subtitle}</subtitle>
+<abstract>
+  <para>{abstract}</para>
+</abstract>
+<authorgroup>
+  <orgname>{company-name} Customer Content Services</orgname>
+</authorgroup>
+<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/titles/adoption-insights/images b/titles/adoption-insights/images
new file mode 120000
index 00000000000..5fa6987088d
--- /dev/null
+++ b/titles/adoption-insights/images
@@ -0,0 +1 @@
+../../images
\ No newline at end of file
diff --git a/titles/adoption-insights/master.adoc b/titles/adoption-insights/master.adoc
new file mode 100644
index 00000000000..460626f3b58
--- /dev/null
+++ b/titles/adoption-insights/master.adoc
@@ -0,0 +1,10 @@
+include::artifacts/attributes.adoc[]
+:context: title-adoption-insights
+:imagesdir: images
+:title: Adoption Insights in {product}
+:subtitle: Delivers detailed analytics on adoption and engagement within your internal developer portal.
+:abstract: As a platform engineer, you can configure Adoption Insights in {product-very-short} to visualize key metrics and trends to get information about the usage of {product-very-short} in your organization.
+= {title}
+
+//{product} Adoption Insights (Developer Preview)
+include::assemblies/assembly-adoption-insights.adoc[leveloffset=+1]
diff --git a/titles/adoption-insights/modules b/titles/adoption-insights/modules
new file mode 120000
index 00000000000..36719b9de74
--- /dev/null
+++ b/titles/adoption-insights/modules
@@ -0,0 +1 @@
+../../modules/
\ No newline at end of file


Reviews:
user: login: karthikjeeyar
state: CHANGES_REQUESTED
author_association: MEMBER
submitted_at: 2025-03-21T10:29:06Z
user: login: pabel-rh
state: COMMENTED
author_association: MEMBER
submitted_at: 2025-03-21T10:32:15Z
user: login: karthikjeeyar
body: Thanks for the followup! Looks good to me

/lgtm
state: APPROVED
author_association: MEMBER
submitted_at: 2025-03-21T10:34:44Z
user: login: hmanwani-rh
state: COMMENTED
author_association: MEMBER
submitted_at: 2025-03-21T11:08:23Z
user: login: hmanwani-rh
state: APPROVED
author_association: MEMBER
submitted_at: 2025-03-21T11:20:05Z

Review comments:
diff_hunk: @@ -0,0 +1,10 @@
+include::artifacts/attributes.adoc[]
+:context: title-adoption-insights
+:imagesdir: images
+:title: {product} Adoption Insights (Developer Preview)
path: titles/adoption-insights/master.adoc
user: login: hmanwani-rh
body: ```suggestion
:title: Adoption Insights in {product}
```
created_at: 2025-03-21T10:02:29Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in Red Hat OpenShift AI 2.16. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
path: artifacts/snip-developer-preview.adoc
user: login: karthikjeeyar
body: `Red Hat OpenShift AI 2.16` needs to be Adoption Insights?
created_at: 2025-03-21T10:21:34Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,26 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-configure-adoption-insights_{context}"]
+= Configuring the Adoption Insights plugin in {product}
+
+You can enable the Adoption Insights plugin by configuring the {product} Helm chart or the {product} Operator ConfigMap.
+
+.Procedure
+
+* To enable the Adoption Insights plugin in {product-short},
path: modules/observe/adoption-insights/proc-configure-adoption-insights.adoc
user: login: karthikjeeyar
body: 
```suggestion
* To configure the Adoption Insights plugin in {product-short},
```
created_at: 2025-03-21T10:23:34Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,48 @@
+// Module included in the following assemblies:
+//
+// * assemblies/assembly-rhdh-observability.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="proc-install-adoption-insights_{context}"]
+= Installing the Adoption Insights plugin in {product}
+
+For the {product} Adoption Insights plugin, you must manually install the Insights plugin.
path: modules/observe/adoption-insights/proc-install-adoption-insights.adoc
user: login: karthikjeeyar
body: 
```suggestion
For the {product} Adoption Insights plugin, you must manually install the plugin.
```
created_at: 2025-03-21T10:27:54Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in Red Hat OpenShift AI 2.16. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
path: artifacts/snip-developer-preview.adoc
user: login: pabel-rh
body: I've changed it to "Red Hat Developer Hub"! Thank you for pointing it out!
created_at: 2025-03-21T10:32:15Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,48 @@
+// Module included in the following assemblies:
+//
+// * assemblies/assembly-rhdh-observability.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="proc-install-adoption-insights_{context}"]
+= Installing the Adoption Insights plugin in {product}
+
+For the {product} Adoption Insights plugin, you must manually install the plugin.
+
+.Procedure
+
+* To enable the Adoption Insights plugin, set the disabled property to `false` in your `app-config-dynamic.yaml` file as shown in the following example:
path: modules/observe/adoption-insights/proc-install-adoption-insights.adoc
user: login: hmanwani-rh
body: ```suggestion
* To enable the Adoption Insights plugin, set the `disabled` property to `false` in your `app-config-dynamic.yaml` file as shown in the following example:
```
created_at: 2025-03-21T11:06:51Z
author_association: MEMBER

PR comments:
user: login: rhdh-bot
created_at: 2025-03-20T11:20:45Z
body: Updated preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1000/ @ 03/21/25 11:17:20
author_association: COLLABORATOR
user: login: benwilcock
created_at: 2025-03-21T10:29:27Z
body: /lgtm
author_association: NONE
user: login: hmanwani-rh
created_at: 2025-03-21T11:20:22Z
body: /cherry-pick release-1.5
author_association: MEMBER
user: login: openshift-cherrypick-robot
created_at: 2025-03-21T11:20:24Z
body: @hmanwani-rh: once the present PR merges, I will cherry-pick it on top of `release-1.5` in a new PR and assign it to you.

<details>

In response to [this](https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/pull/1000#issuecomment-2743068684):

>/cherry-pick release-1.5


Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md).  If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
</details>
author_association: CONTRIBUTOR
user: login: openshift-cherrypick-robot
created_at: 2025-03-21T11:21:05Z
body: @hmanwani-rh: new pull request created: #1003

<details>

In response to [this](https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/pull/1000#issuecomment-2743068684):

>/cherry-pick release-1.5


Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md).  If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
</details>
author_association: CONTRIBUTOR