Incorporated Rohit's comments

Author: pabel-rh

assemblies/assembly-adoption-insights.adoc

@@ -23,7 +23,7 @@ image::rhdh-plugins-reference/adoption-insights.jpg[adoption insights]
 include::modules/observe/adoption-insights/proc-configure-adoption-insights.adoc[leveloffset=+1]
 
 //disabling adoption insights
-include::modules/observe/adoption-insights/proc-disable-adoption-insights.adoc[leveloffset=+1]
+include::modules/observe/adoption-insights/proc-customize-adoption-insights.adoc[leveloffset=+1]
 
 //using adoption insights
 include::modules/observe/adoption-insights/proc-using-adoption-insights.adoc[leveloffset=+1]

modules/observe/adoption-insights/proc-configure-adoption-insights.adoc

@@ -2,7 +2,7 @@
 [id="proc-configure-adoption-insights_{context}"]
 = Configuring the Adoption Insights plugin in {product}
 
-The Adoption Insights plugin is preinstalled and enabled on a {product-short} instance by default. You can disable or enable the Adoption Insights plugin, and change other parameters, by configuring the {product} Helm chart or the {product} Operator ConfigMap.
+The Adoption Insights plugin is preinstalled and enabled on a {product-short} instance by default. You can disable or enable the Adoption Insights plugin and change other parameters, by configuring the {product} Helm chart or the {product} Operator ConfigMap.
 
 [IMPORTANT]
 ====

modules/observe/adoption-insights/proc-customize-adoption-insights.adoc

@@ -0,0 +1,56 @@
+// Module included in the following assemblies:
+//
+// * assemblies/assembly-rhdh-observability.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="proc-customize-adoption-insights_{context}"]
+= Customizing the Adoption Insights plugin in {product}
+
+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 {product} Adoption Insights plugin, you must manually disable the plugin.
+
+.Procedure
+
+* To customize `maxBufferSize`, `flushInterval`, `debug`, and `licensedUsers` in the Adoption Insights plugin, in your {product} `app-config.yaml` file, update the relevant settings as shown in the following code:
++
+.`app-config.yaml` fragment
+[source,terminal]
+----
+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:
++
+[source,yaml]
+----
+  - 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:
++
+[source,yaml]
+----
+p, role:default/_<your_team>_, adoption-insights.events.read, read, allow
+g, user:default/_<your_user>_, role:default/_<your_team>_
+----
+See link:{authorization-book-url}#ref-rbac-permission-policies_title-authorization[Permission policies in {product}].