From e11b1a8388484722dbd0bee5a2cec632e6ff5188 Mon Sep 17 00:00:00 2001 From: Eliska Romanova Date: Thu, 12 Jun 2025 11:07:32 +0200 Subject: [PATCH] OBSDOCS-1912: Review the format for external links in monitoring docs --- .../accessing-metrics-as-a-developer.adoc | 2 +- .../accessing-metrics-as-an-administrator.adoc | 2 +- .../configuring-alerts-and-notifications.adoc | 10 +++++----- .../configuring-metrics.adoc | 6 +++--- .../configuring-performance-and-scalability.adoc | 10 +++++----- .../storing-and-recording-data.adoc | 2 +- .../configuring-alerts-and-notifications-uwm.adoc | 8 ++++---- .../configuring-metrics-uwm.adoc | 8 ++++---- .../configuring-performance-and-scalability-uwm.adoc | 8 ++++---- .../storing-and-recording-data-uwm.adoc | 2 +- .../managing-alerts-as-a-developer.adoc | 6 +++--- .../managing-alerts-as-an-administrator.adoc | 12 ++++++------ 12 files changed, 38 insertions(+), 38 deletions(-) diff --git a/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc b/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc index ca82ee4b79ad..79a5c4848493 100644 --- a/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc +++ b/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc @@ -24,7 +24,7 @@ include::modules/monitoring-querying-metrics-for-user-defined-projects-with-mon- [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/prometheus/latest/querying/basics/[Querying Prometheus] (Prometheus documentation) +* link:https://prometheus.io/docs/prometheus/latest/querying/basics/[Querying Prometheus (Prometheus documentation)] //Reviewing monitoring dashboards as a developer include::modules/monitoring-reviewing-monitoring-dashboards-developer.adoc[leveloffset=+1] diff --git a/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc b/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc index 0ce2b3d0cb51..858454d9e8a1 100644 --- a/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc +++ b/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc @@ -24,7 +24,7 @@ include::modules/monitoring-querying-metrics-for-all-projects-with-mon-dashboard [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/prometheus/latest/querying/basics/[Querying Prometheus] (Prometheus documentation) +* link:https://prometheus.io/docs/prometheus/latest/querying/basics/[Querying Prometheus (Prometheus documentation)] //Getting detailed information about a metrics target include::modules/monitoring-getting-detailed-information-about-a-target.adoc[leveloffset=+1] diff --git a/observability/monitoring/configuring-core-platform-monitoring/configuring-alerts-and-notifications.adoc b/observability/monitoring/configuring-core-platform-monitoring/configuring-alerts-and-notifications.adoc index 5554017537ad..3035d6ddffec 100644 --- a/observability/monitoring/configuring-core-platform-monitoring/configuring-alerts-and-notifications.adoc +++ b/observability/monitoring/configuring-core-platform-monitoring/configuring-alerts-and-notifications.adoc @@ -17,7 +17,7 @@ include::modules/monitoring-disabling-the-local-alertmanager.adoc[leveloffset=+2 [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/alerting/latest/alertmanager/[Alertmanager] (Prometheus documentation) +* link:https://prometheus.io/docs/alerting/latest/alertmanager/[Alertmanager (Prometheus documentation)] * xref:../../../observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc#managing-alerts-as-an-administrator[Managing alerts as an Administrator] //Configuring secrets for Alertmanager @@ -47,8 +47,8 @@ Alertmanager does not send notifications by default. It is strongly recommended .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#sending-notifications-to-external-systems_key-concepts[Sending notifications to external systems] -* link:https://www.pagerduty.com/[PagerDuty] (PagerDuty official site) -* link:https://www.pagerduty.com/docs/guides/prometheus-integration-guide/[Prometheus Integration Guide] (PagerDuty official site) +* link:https://www.pagerduty.com/[PagerDuty website] +* link:https://www.pagerduty.com/docs/guides/prometheus-integration-guide/[Prometheus Integration Guide (PagerDuty documentation)] * xref:../../../observability/monitoring/getting-started/maintenance-and-support-for-monitoring.adoc#support-version-matrix-for-monitoring-components_maintenance-and-support-for-monitoring[Support version matrix for monitoring components] * xref:../../../observability/monitoring/configuring-user-workload-monitoring/preparing-to-configure-the-monitoring-stack-uwm.adoc#enabling-alert-routing-for-user-defined-projects_preparing-to-configure-the-monitoring-stack-uwm[Enabling alert routing for user-defined projects] @@ -57,13 +57,13 @@ include::modules/monitoring-configuring-alert-routing-default-platform-alerts.ad [role="_additional-resources"] .Additional resources -* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4] (Red{nbsp}Hat Customer Portal) +* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4 (Red{nbsp}Hat Customer Portal)] include::modules/monitoring-configuring-alert-routing-console.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4] (Red{nbsp}Hat Customer Portal) +* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4 (Red{nbsp}Hat Customer Portal)] include::modules/monitoring-configuring-different-alert-receivers-for-default-platform-alerts-and-user-defined-alerts.adoc[leveloffset=+2] diff --git a/observability/monitoring/configuring-core-platform-monitoring/configuring-metrics.adoc b/observability/monitoring/configuring-core-platform-monitoring/configuring-metrics.adoc index eecc2258d73d..41a6556f664a 100644 --- a/observability/monitoring/configuring-core-platform-monitoring/configuring-metrics.adoc +++ b/observability/monitoring/configuring-core-platform-monitoring/configuring-metrics.adoc @@ -22,7 +22,7 @@ include::modules/monitoring-configuring-remote-write-storage.adoc[leveloffset=+1 .Additional resources * xref:../../../rest_api/monitoring_apis/prometheus-monitoring-coreos-com-v1.adoc#spec-remotewrite-writerelabelconfigs[`writeRelabelConfigs`] -* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[`relabel_config`] (Prometheus documentation) +* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[`relabel_config` (Prometheus documentation)] include::modules/monitoring-supported-remote-write-authentication-settings.adoc[leveloffset=+2] @@ -34,8 +34,8 @@ include::modules/monitoring-example-remote-write-queue-configuration.adoc[levelo .Additional resources * xref:../../../rest_api/monitoring_apis/prometheus-monitoring-coreos-com-v1.adoc#spec-remotewrite-2[Prometheus REST API reference for remote write] -* link:https://prometheus.io/docs/operating/integrations/#remote-endpoints-and-storage[Setting up remote write compatible endpoints] (Prometheus documentation) -* link:https://prometheus.io/docs/practices/remote_write/#remote-write-tuning[Tuning remote write settings] (Prometheus documentation) +* link:https://prometheus.io/docs/operating/integrations/#remote-endpoints-and-storage[Remote write compatible endpoints (Prometheus documentation)] +* link:https://prometheus.io/docs/practices/remote_write/#remote-write-tuning[Remote write tuning (Prometheus documentation)] * xref:../../../nodes/pods/nodes-pods-secrets.adoc#nodes-pods-secrets-about_nodes-pods-secrets[Understanding secrets] //Creating cluster ID labels for metrics for core platform monitoring diff --git a/observability/monitoring/configuring-core-platform-monitoring/configuring-performance-and-scalability.adoc b/observability/monitoring/configuring-core-platform-monitoring/configuring-performance-and-scalability.adoc index c2cb06cc0025..79394346c9f2 100644 --- a/observability/monitoring/configuring-core-platform-monitoring/configuring-performance-and-scalability.adoc +++ b/observability/monitoring/configuring-core-platform-monitoring/configuring-performance-and-scalability.adoc @@ -35,7 +35,7 @@ include::modules/monitoring-moving-monitoring-components-to-different-nodes.adoc * xref:../../../observability/monitoring/configuring-core-platform-monitoring/preparing-to-configure-the-monitoring-stack.adoc#preparing-to-configure-the-monitoring-stack[Preparing to configure core platform monitoring stack] * xref:../../../nodes/nodes/nodes-nodes-working.adoc#nodes-nodes-working-updating_nodes-nodes-working[Understanding how to update labels on nodes] * xref:../../../nodes/scheduling/nodes-scheduler-node-selectors.adoc#nodes-scheduler-node-selectors[Placing pods on specific nodes using node selectors] -* link:https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector[nodeSelector] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector[`nodeSelector` (Kubernetes documentation)] include::modules/monitoring-assigning-tolerations-to-monitoring-components.adoc[leveloffset=+2,tags=**;CPM;!UWM] @@ -44,7 +44,7 @@ include::modules/monitoring-assigning-tolerations-to-monitoring-components.adoc[ * xref:../../../observability/monitoring/configuring-core-platform-monitoring/preparing-to-configure-the-monitoring-stack.adoc#preparing-to-configure-the-monitoring-stack[Preparing to configure core platform monitoring stack] * xref:../../../nodes/scheduling/nodes-scheduler-taints-tolerations.adoc#nodes-scheduler-taints-tolerations[Controlling pod placement using node taints] -* link:https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/[Taints and Tolerations] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/[Taints and tolerations (Kubernetes documentation)] // Setting the body size limit for metrics scraping include::modules/monitoring-setting-the-body-size-limit-for-metrics-scraping.adoc[leveloffset=+1] @@ -52,7 +52,7 @@ include::modules/monitoring-setting-the-body-size-limit-for-metrics-scraping.ado [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config[scrape_config configuration] (Prometheus documentation) +* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config[`scrape_config` (Prometheus documentation)] [id="managing-cpu-and-memory-resources-for-monitoring-components_{context}"] == Managing CPU and memory resources for monitoring components @@ -67,7 +67,7 @@ include::modules/monitoring-specifying-limits-and-requests-for-monitoring-compon .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#about-specifying-limits-and-requests-for-monitoring-components_key-concepts[About specifying limits and requests] -* link:https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#requests-and-limits[Kubernetes requests and limits documentation] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#requests-and-limits[Requests and limits (Kubernetes documentation)] // Choosing a metrics collection profile include::modules/monitoring-choosing-a-metrics-collection-profile.adoc[leveloffset=+1] @@ -87,7 +87,7 @@ include::modules/monitoring-configuring-pod-topology-spread-constraints.adoc[lev * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#using-pod-topology-spread-constraints-for-monitoring_key-concepts[About pod topology spread constraints for monitoring] * xref:../../../nodes/scheduling/nodes-scheduler-pod-topology-spread-constraints.adoc#nodes-scheduler-pod-topology-spread-constraints-about[Controlling pod placement by using pod topology spread constraints] -* link:https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/[Pod Topology Spread Constraints] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/[Pod topology spread constraints (Kubernetes documentation)] diff --git a/observability/monitoring/configuring-core-platform-monitoring/storing-and-recording-data.adoc b/observability/monitoring/configuring-core-platform-monitoring/storing-and-recording-data.adoc index cb70873c1dec..80cf2f7be43d 100644 --- a/observability/monitoring/configuring-core-platform-monitoring/storing-and-recording-data.adoc +++ b/observability/monitoring/configuring-core-platform-monitoring/storing-and-recording-data.adoc @@ -17,7 +17,7 @@ include::modules/monitoring-configuring-a-persistent-volume-claim.adoc[leveloffs .Additional resources * xref:../../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage] -* link:https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims[PersistentVolumeClaims] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims[PersistentVolumeClaims (Kubernetes documentation)] include::modules/monitoring-resizing-a-persistent-volume.adoc[leveloffset=+2,tags=**;CPM;!UWM] diff --git a/observability/monitoring/configuring-user-workload-monitoring/configuring-alerts-and-notifications-uwm.adoc b/observability/monitoring/configuring-user-workload-monitoring/configuring-alerts-and-notifications-uwm.adoc index fa5a8bc54f19..80a6750077c2 100644 --- a/observability/monitoring/configuring-user-workload-monitoring/configuring-alerts-and-notifications-uwm.adoc +++ b/observability/monitoring/configuring-user-workload-monitoring/configuring-alerts-and-notifications-uwm.adoc @@ -56,8 +56,8 @@ Review the following limitations of alert routing for user-defined projects: * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#understanding-alert-routing-for-user-defined-projects_key-concepts[Understanding alert routing for user-defined projects] * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#sending-notifications-to-external-systems_key-concepts[Sending notifications to external systems] -* link:https://www.pagerduty.com/[PagerDuty] (PagerDuty official site) -* link:https://www.pagerduty.com/docs/guides/prometheus-integration-guide/[Prometheus Integration Guide] (PagerDuty official site) +* link:https://www.pagerduty.com/[PagerDuty website] +* link:https://www.pagerduty.com/docs/guides/prometheus-integration-guide/[Prometheus Integration Guide (PagerDuty documentation)] * xref:../../../observability/monitoring/getting-started/maintenance-and-support-for-monitoring.adoc#support-version-matrix-for-monitoring-components_maintenance-and-support-for-monitoring[Support version matrix for monitoring components] * xref:../../../observability/monitoring/configuring-user-workload-monitoring/preparing-to-configure-the-monitoring-stack-uwm.adoc#enabling-alert-routing-for-user-defined-projects_preparing-to-configure-the-monitoring-stack-uwm[Enabling alert routing for user-defined projects] @@ -66,13 +66,13 @@ include::modules/monitoring-configuring-alert-routing-for-user-defined-projects. [role="_additional-resources"] .Additional resources -* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4] (Red{nbsp}Hat Customer Portal) +* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4 (Red{nbsp}Hat Customer Portal)] include::modules/monitoring-configuring-alert-routing-user-defined-alerts-secret.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4] (Red{nbsp}Hat Customer Portal) +* link:https://access.redhat.com/solutions/6828481[Send test alerts to Alertmanager in OpenShift 4 (Red{nbsp}Hat Customer Portal)] include::modules/monitoring-configuring-different-alert-receivers-for-default-platform-alerts-and-user-defined-alerts.adoc[leveloffset=+2] diff --git a/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.adoc b/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.adoc index 6f9466f67916..690fa7a5f5d3 100644 --- a/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.adoc +++ b/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.adoc @@ -23,7 +23,7 @@ include::modules/monitoring-configuring-remote-write-storage.adoc[leveloffset=+1 ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../rest_api/monitoring_apis/prometheus-monitoring-coreos-com-v1.adoc#spec-remotewrite-writerelabelconfigs[`writeRelabelConfigs`] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[`relabel_config`] (Prometheus documentation) +* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[`relabel_config` (Prometheus documentation)] include::modules/monitoring-supported-remote-write-authentication-settings.adoc[leveloffset=+2] @@ -36,8 +36,8 @@ include::modules/monitoring-example-remote-write-queue-configuration.adoc[levelo ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../rest_api/monitoring_apis/prometheus-monitoring-coreos-com-v1.adoc#spec-remotewrite-2[Prometheus REST API reference for remote write] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://prometheus.io/docs/operating/integrations/#remote-endpoints-and-storage[Setting up remote write compatible endpoints] (Prometheus documentation) -* link:https://prometheus.io/docs/practices/remote_write/#remote-write-tuning[Tuning remote write settings] (Prometheus documentation) +* link:https://prometheus.io/docs/operating/integrations/#remote-endpoints-and-storage[Remote write compatible endpoints (Prometheus documentation)] +* link:https://prometheus.io/docs/practices/remote_write/#remote-write-tuning[Remote write tuning (Prometheus documentation)] * xref:../../../nodes/pods/nodes-pods-secrets.adoc#nodes-pods-secrets-about_nodes-pods-secrets[Understanding secrets] // Creating cluster ID labels for metrics for monitoring of user-defined projects @@ -67,5 +67,5 @@ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../rest_api/monitoring_apis/podmonitor-monitoring-coreos-com-v1.adoc#podmonitor-monitoring-coreos-com-v1[PodMonitor API] * xref:../../../rest_api/monitoring_apis/servicemonitor-monitoring-coreos-com-v1.adoc#servicemonitor-monitoring-coreos-com-v1[ServiceMonitor API] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://access.redhat.com/articles/6675491[Scrape Prometheus metrics using TLS in ServiceMonitor configuration] (Red{nbsp}Hat Customer Portal article) +* link:https://access.redhat.com/articles/6675491[Scrape Prometheus metrics using TLS in ServiceMonitor configuration (Red{nbsp}Hat Customer Portal)] diff --git a/observability/monitoring/configuring-user-workload-monitoring/configuring-performance-and-scalability-uwm.adoc b/observability/monitoring/configuring-user-workload-monitoring/configuring-performance-and-scalability-uwm.adoc index dcec6cfbee83..e4ab25db9c5a 100644 --- a/observability/monitoring/configuring-user-workload-monitoring/configuring-performance-and-scalability-uwm.adoc +++ b/observability/monitoring/configuring-user-workload-monitoring/configuring-performance-and-scalability-uwm.adoc @@ -35,7 +35,7 @@ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../nodes/nodes/nodes-nodes-working.adoc#nodes-nodes-working-updating_nodes-nodes-working[Understanding how to update labels on nodes] * xref:../../../nodes/scheduling/nodes-scheduler-node-selectors.adoc#nodes-scheduler-node-selectors[Placing pods on specific nodes using node selectors] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector[nodeSelector] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector[`nodeSelector` (Kubernetes documentation)] include::modules/monitoring-assigning-tolerations-to-monitoring-components.adoc[leveloffset=+2,tags=**;!CPM;UWM] @@ -46,7 +46,7 @@ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../observability/monitoring/configuring-user-workload-monitoring/preparing-to-configure-the-monitoring-stack-uwm.adoc#enabling-monitoring-for-user-defined-projects-uwm_preparing-to-configure-the-monitoring-stack-uwm[Enabling monitoring for user-defined projects] * xref:../../../nodes/scheduling/nodes-scheduler-taints-tolerations.adoc#nodes-scheduler-taints-tolerations[Controlling pod placement using node taints] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/[Taints and Tolerations] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/[Taints and tolerations (Kubernetes documentation)] [id="managing-cpu-and-memory-resources-for-monitoring-components_{context}"] == Managing CPU and memory resources for monitoring components @@ -60,7 +60,7 @@ include::modules/monitoring-specifying-limits-and-requests-for-monitoring-compon [role="_additional-resources"] .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/key-concepts.adoc#about-specifying-limits-and-requests-for-monitoring-components_key-concepts[About specifying limits and requests for monitoring components] -* link:https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#requests-and-limits[Kubernetes requests and limits documentation] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#requests-and-limits[Requests and limits (Kubernetes documentation)] [id="controlling-the-impact-of-unbound-attributes-in-user-defined-projects_{context}"] == Controlling the impact of unbound metrics attributes in user-defined projects @@ -110,4 +110,4 @@ include::modules/monitoring-configuring-pod-topology-spread-constraints.adoc[lev ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] * xref:../../../nodes/scheduling/nodes-scheduler-pod-topology-spread-constraints.adoc#nodes-scheduler-pod-topology-spread-constraints-about[Controlling pod placement by using pod topology spread constraints] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -* link:https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/[Pod Topology Spread Constraints] (Kubernetes documentation) \ No newline at end of file +* link:https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/[Pod topology spread constraints (Kubernetes documentation)] diff --git a/observability/monitoring/configuring-user-workload-monitoring/storing-and-recording-data-uwm.adoc b/observability/monitoring/configuring-user-workload-monitoring/storing-and-recording-data-uwm.adoc index cb8eebcb8a43..feba156a95f3 100644 --- a/observability/monitoring/configuring-user-workload-monitoring/storing-and-recording-data-uwm.adoc +++ b/observability/monitoring/configuring-user-workload-monitoring/storing-and-recording-data-uwm.adoc @@ -17,7 +17,7 @@ include::modules/monitoring-configuring-a-persistent-volume-claim.adoc[leveloffs .Additional resources * xref:../../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage] -* link:https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims[PersistentVolumeClaims] (Kubernetes documentation) +* link:https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims[PersistentVolumeClaims (Kubernetes documentation)] ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] include::modules/monitoring-resizing-a-persistent-volume.adoc[leveloffset=+2,tags=**;!CPM;UWM] diff --git a/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc b/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc index 292b501cb434..f5a111fbea51 100644 --- a/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc +++ b/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc @@ -28,7 +28,7 @@ include::modules/monitoring-getting-information-about-alerts-silences-and-alerti [role="_additional-resources"] .Additional resources -* link:https://github.com/openshift/runbooks/tree/master/alerts/cluster-monitoring-operator[{cmo-full} runbooks] ({cmo-full} GitHub repository) +* link:https://github.com/openshift/runbooks/tree/master/alerts/cluster-monitoring-operator[GitHub {cmo-full} runbooks repository] [id="managing-silences_{context}"] == Managing silences @@ -77,7 +77,7 @@ include::modules/monitoring-creating-cross-project-alerting-rules-for-user-defin [role="_additional-resources"] .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/monitoring-stack-architecture.adoc#monitoring-stack-architecture[Monitoring stack architecture] -* link:https://prometheus.io/docs/practices/alerting/[Alerting] (Prometheus documentation) +* link:https://prometheus.io/docs/practices/alerting/[Alerting (Prometheus documentation)] include::modules/monitoring-accessing-alerting-rules-for-your-project.adoc[leveloffset=+2] include::modules/monitoring-removing-alerting-rules-for-user-defined-projects.adoc[leveloffset=+2] @@ -85,4 +85,4 @@ include::modules/monitoring-removing-alerting-rules-for-user-defined-projects.ad [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager] (Prometheus documentation) +* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager (Prometheus documentation)] diff --git a/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc b/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc index 73a4826a09ec..c7a7dcf0f9c1 100644 --- a/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc +++ b/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc @@ -28,7 +28,7 @@ include::modules/monitoring-getting-information-about-alerts-silences-and-alerti [role="_additional-resources"] .Additional resources -* link:https://github.com/openshift/runbooks/tree/master/alerts/cluster-monitoring-operator[{cmo-full} runbooks] ({cmo-full} GitHub repository) +* link:https://github.com/openshift/runbooks/tree/master/alerts/cluster-monitoring-operator[GitHub {cmo-full} runbooks repository] [id="managing-silences_{context}"] == Managing silences @@ -83,9 +83,9 @@ include::modules/monitoring-modifying-core-platform-alerting-rules.adoc[leveloff .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/monitoring-stack-architecture.adoc#monitoring-stack-architecture[Monitoring stack architecture] -* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager] (Prometheus documentation) -* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[relabel_config configuration] (Prometheus documentation) -* link:https://prometheus.io/docs/practices/alerting/[Alerting] (Prometheus documentation) +* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager (Prometheus documentation)] +* link:https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config[`relabel_config` (Prometheus documentation)] +* link:https://prometheus.io/docs/practices/alerting/[Alerting (Prometheus documentation)] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] [id="managing-alerting-rules-for-user-defined-projects_{context}"] @@ -106,7 +106,7 @@ include::modules/monitoring-creating-cross-project-alerting-rules-for-user-defin .Additional resources * xref:../../../observability/monitoring/about-ocp-monitoring/monitoring-stack-architecture.adoc#monitoring-stack-architecture[Monitoring stack architecture] -* link:https://prometheus.io/docs/practices/alerting/[Alerting] (Prometheus documentation) +* link:https://prometheus.io/docs/practices/alerting/[Alerting (Prometheus documentation)] include::modules/monitoring-listing-alerting-rules-for-all-projects-in-a-single-view.adoc[leveloffset=+2] include::modules/monitoring-removing-alerting-rules-for-user-defined-projects.adoc[leveloffset=+2] @@ -115,7 +115,7 @@ include::modules/monitoring-disabling-cross-project-alerting-rules-for-user-defi [role="_additional-resources"] .Additional resources -* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager] (Prometheus documentation) +* link:https://prometheus.io/docs/alerting/alertmanager/[Alertmanager (Prometheus documentation)]