Merge pull request #35289 from bison/MON-1756

MON-1756: Document excluding projects from user-workload monitoring

Author: EricPonvelle

modules/monitoring-excluding-a-user-defined-project-from-monitoring.adoc

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+//
+// * monitoring/enabling-monitoring-for-user-defined-projects.adoc
+
+[id="excluding-a-user-defined-project-from-monitoring_{context}"]
+= Excluding a user-defined project from monitoring
+
+Individual user-defined projects can be excluded from user workload monitoring. To do so, simply add the `openshift.io/user-monitoring` label to the project's namespace with a value of `false`.
+
+.Procedure
+
+. Add the label to the project namespace:
++
+[source,terminal]
+----
+$ oc label namespace my-project 'openshift.io/user-monitoring=false'
+----
++
+. To re-enable monitoring, remove the label from the namespace:
++
+[source,terminal]
+----
+$ oc label namespace my-project 'openshift.io/user-monitoring-'
+----
++
+[NOTE]
+====
+If there were any active monitoring targets for the project, it may take a few minutes for Prometheus to stop scraping them after adding the label.
+====

monitoring/enabling-monitoring-for-user-defined-projects.adoc

@@ -32,6 +32,9 @@ include::modules/monitoring-granting-users-permission-to-configure-monitoring-fo
 // Accessing metrics from outside the cluster for custom applications
 include::modules/accessing-metrics-outside-cluster.adoc[leveloffset=+1]
 
+// Excluding a user-defined project from monitoring
+include::modules/monitoring-excluding-a-user-defined-project-from-monitoring.adoc[leveloffset=+1]
+
 // Disabling monitoring for user-defined projects
 include::modules/monitoring-disabling-monitoring-for-user-defined-projects.adoc[leveloffset=+1]