From f407421ee572911ff64b093c4e892ca1ad9a49d6 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 | 6 +++--- .../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, 37 insertions(+), 37 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 348aaf79e11d..9a90fe9b21d1 100644 --- a/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc +++ b/observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc @@ -22,7 +22,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 d552bf30d171..f2e93a945419 100644 --- a/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc +++ b/observability/monitoring/accessing-metrics/accessing-metrics-as-an-administrator.adoc @@ -22,7 +22,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 c025b6d19d25..8a0e99f8ff95 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 4f02dfff7fd6..f5e55de23993 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 @@ -48,8 +48,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] @@ -58,13 +58,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 c5c3f3ac254b..1b2427ab5369 100644 --- a/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.adoc +++ b/observability/monitoring/configuring-user-workload-monitoring/configuring-metrics-uwm.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 monitoring of user-defined projects 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 7d92090ddab1..74f4016099e9 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 @@ -32,7 +32,7 @@ include::modules/monitoring-moving-monitoring-components-to-different-nodes.adoc * 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/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] @@ -40,7 +40,7 @@ include::modules/monitoring-assigning-tolerations-to-monitoring-components.adoc[ .Additional resources * 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] -* 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 @@ -54,7 +54,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 @@ -94,4 +94,4 @@ 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) \ 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 ee27889c5663..9a262fdd53bb 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)] 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 d25fe03f4a03..6d6c261e9818 100644 --- a/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc +++ b/observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc @@ -26,7 +26,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 @@ -67,7 +67,7 @@ include::modules/monitoring-creating-alerting-rules-for-user-defined-projects.ad [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] @@ -75,4 +75,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 32a4b2ecfea1..27a9185e14eb 100644 --- a/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc +++ b/observability/monitoring/managing-alerts/managing-alerts-as-an-administrator.adoc @@ -26,7 +26,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 @@ -74,9 +74,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)] [id="managing-alerting-rules-for-user-defined-projects_{context}"] == Managing alerting rules for user-defined projects @@ -95,7 +95,7 @@ include::modules/monitoring-creating-alerting-rules-for-user-defined-projects.ad .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] @@ -103,7 +103,7 @@ 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)]