From bbe2523617ec70c18a011e31f59638f056835461 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 16 Dec 2024 14:53:16 -0700 Subject: [PATCH 1/4] Remove kurl info from prom monitoring topic --- docs/enterprise/monitoring-applications.mdx | 75 ++++++++++----------- docs/partials/monitoring/_overview-prom.mdx | 12 ++-- 2 files changed, 40 insertions(+), 47 deletions(-) diff --git a/docs/enterprise/monitoring-applications.mdx b/docs/enterprise/monitoring-applications.mdx index df5b8fa314..97424b24df 100644 --- a/docs/enterprise/monitoring-applications.mdx +++ b/docs/enterprise/monitoring-applications.mdx @@ -3,24 +3,41 @@ import LimitationEc from "../partials/monitoring/_limitation-ec.mdx" # Monitoring Applications with Prometheus -This topic describes monitoring applications and clusters with Prometheus. It includes information about how to configure Prometheus monitoring for existing clusters and how to access the dashboard using a port forward. +This topic describes how to monitor applications and clusters with Prometheus in existing cluster installations with Replicated KOTS. + +For information about consuming Prometheus metrics externally in Replicated kURL installations, see [Consuming Prometheus Metrics Externally](monitoring-external-prometheus). ## Overview -## Limitation +To configure Prometheus monitoring for applications installed with KOTS in an existing cluster, you can connect the Admin Console to the endpoint of an instance of Prometheus installed in the cluster. - +### About Visualizing Metrics with Grafana + +In addition to the Prometheus Expression Browser, Grafana and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. + +For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). + +For information about constructing Prometheus queries, see the [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. + +For information about the Prometheus Expression Browser, see [Expression Browser](https://prometheus.io/docs/visualization/browser/) in the Prometheus documentation. + + +### About Alerting with Prometheus + +Alerting with Prometheus has two phases: -## Configure Monitoring in Existing Clusters {#configure-existing} +1. Alerting rules in Prometheus servers send alerts to an Alertmanager. +1. The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. -To configure Prometheus monitoring for applications installed in an existing cluster, connect the Admin Console to the endpoint of an installed instance of Prometheus on the cluster. See the following sections: +For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. + +## Limitation -* [Install Prometheus](#install-prometheus) -* [Connect to a Prometheus Endpoint](#connect-to-a-prometheus-endpoint) + -### Install Prometheus +## Install Prometheus in the Cluster {#configure-existing} Replicated recommends that you use CoreOS's Kube-Prometheus distribution for installing and configuring highly available Prometheus on an existing cluster. For more information, see the [kube-prometheus](https://github.com/coreos/kube-prometheus) GitHub repository. @@ -43,9 +60,9 @@ To install Prometheus using the recommended Kube-Prometheus distribution: For more information about advanced Kube-Prometheus configuration options, see [Customizing Kube-Prometheus](https://github.com/coreos/kube-prometheus#customizing-kube-prometheus) in the kube-prometheus GitHub repository. -### Connect to a Prometheus Endpoint +## Connect to a Prometheus Endpoint -To view graphs on the Admin Console dashboard, you must provide the address of the Prometheus instance that you installed on the cluster. +To view graphs on the Admin Console dashboard, provide the address of a Prometheus instance installed in the cluster. To connect the Admin Console to a Prometheus endpoint: @@ -56,19 +73,17 @@ To connect the Admin Console to a Prometheus endpoint: Graphs appear on the dashboard shortly after saving the address. -## Access the Dashboards with kubectl Port Forward +## Access the Dashboards Using Port Forwarding -You can use the commands below to access Prometheus, Grafana, and Alertmanager dashboards using `kubectl port-forward` after you install the manifests. +You can access Prometheus, Grafana, and Alertmanager dashboards using `kubectl port-forward` after you install the manifests. You can also expose these pods on NodePorts or behind an ingress controller. This is an advanced use case. For information about exposing the pods on NodePorts, see [NodePorts](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/node-ports.md) in the kube-prometheus GitHub repository. For information about exposing the pods behind an ingress controller, see [Expose via Ingress](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/exposing-prometheus-alertmanager-grafana-ingress.md) in the kube-prometheus GitHub repository. -For Replicated kURL clusters, you can consume Prometheus metrics from an external monitoring solution by connecting to the Prometheus NodePort service running in the cluster. For more information, see [Consuming Prometheus Metrics Externally](monitoring-external-prometheus). - ### Access Prometheus -To access the Prometheus dashboard with a port forward: +To access the Prometheus dashboard: -1. Run the following command to create the port forward: +1. Run the following command to port forward the Prometheus service: ```bash kubectl --namespace monitoring port-forward svc/prometheus-k8s 9090 @@ -78,9 +93,9 @@ To access the Prometheus dashboard with a port forward: ### Access Grafana -To access the Grafana dashboard with a port forward: +To access the Grafana dashboard: -1. Run the following command to create the port forward: +1. Run the following command to port forward the Grafana service: ```bash kubectl --namespace monitoring port-forward deployment/grafana 3000 @@ -98,32 +113,12 @@ To access the Grafana dashboard with a port forward: ### Access Alertmanager -To access the Alertmanager dashboard with a port forward: +To access the Alertmanager dashboard: -1. Run the following command to create the port forward: +1. Run the following command to port forward the Alertmanager service: ``` kubectl --namespace monitoring port-forward svc/prometheus-alertmanager 9093 ``` 1. Access the dashboard at http://localhost:9093. - -## About Visualizing Metrics with Grafana - -In addition to the Prometheus Expression Browser, Grafana and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. - -For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). - -For information about constructing Prometheus queries, see the [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. - -For information about the Prometheus Expression Browser, see [Expression Browser](https://prometheus.io/docs/visualization/browser/) in the Prometheus documentation. - - -## About Alerting with Prometheus - -Alerting with Prometheus has two phases: - -1. Alerting rules in Prometheus servers send alerts to an Alertmanager. -1. The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. - -For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. diff --git a/docs/partials/monitoring/_overview-prom.mdx b/docs/partials/monitoring/_overview-prom.mdx index 4393378ead..398ad6e4cc 100644 --- a/docs/partials/monitoring/_overview-prom.mdx +++ b/docs/partials/monitoring/_overview-prom.mdx @@ -1,6 +1,6 @@ -For installations in existing clusters and in Replicated kURL clusters, the Replicated KOTS Admin Console uses the open source systems monitoring tool Prometheus to collect metrics on an application and the cluster where the application is installed. Prometheus components include the main Prometheus server, which scrapes and stores time series data, an Alertmanager for alerting on metrics, and Grafana for visualizing metrics. For more information about Prometheus, see [What is Prometheus?](https://prometheus.io/docs/introduction/overview/) in the Prometheus documentation. +The KOTS Admin Console can use the open source systems monitoring tool Prometheus to collect metrics on an application and the cluster where the application is installed. Prometheus components include the main Prometheus server, which scrapes and stores time series data, an Alertmanager for alerting on metrics, and Grafana for visualizing metrics. For more information about Prometheus, see [What is Prometheus?](https://prometheus.io/docs/introduction/overview/) in the Prometheus documentation. -The Admin Console exposes graphs with key metrics collected by Prometheus in the **Monitoring** section of the dashboard. By default, the Admin Console includes the following graphs: +The Admin Console exposes graphs with key metrics collected by Prometheus in the **Monitoring** section of the dashboard. By default, the Admin Console displays the following graphs: * Cluster disk usage * Pod CPU usage @@ -8,12 +8,10 @@ The Admin Console exposes graphs with key metrics collected by Prometheus in the In addition to these default graphs, application developers can also expose business and application level metrics and alerts on the dashboard. -The following screenshot shows an example of the **Monitoring** section on the Admin Console dashboard with the Disk Usage, CPU Usage, and Memory Usage default graphs. +The following screenshot shows an example of the **Monitoring** section on the Admin Console dashboard with the Disk Usage, CPU Usage, and Memory Usage default graphs: -Graphs on the Admin Console dashboard +Graphs on the Admin Console dashboard [View a larger version of this image](/images/kotsadm-dashboard-graph.png) -For kURL installations, if the kURL Prometheus add-on is included in the kURL installer spec, then the Prometheus monitoring system is installed alongside the application. No additional configuration is required to collect metrics and view any default and custom graphs on the Admin Console dashboard. For more information about configuring kURL installers, see [Creating a kURL Installer](/vendor/packaging-embedded-kubernetes). - -For existing cluster installations with KOTS, users can install Prometheus and connect the Admin Console to the Prometheus endpoint to enable monitoring. For information about how to set up Prometheus monitoring in existing clusters, see [Configure Monitoring in Existing Clusters](/enterprise/monitoring-applications#configure-existing). \ No newline at end of file +For existing cluster installations with KOTS, users can install Prometheus in the cluster and then connect the Admin Console to the Prometheus endpoint to enable monitoring. \ No newline at end of file From fab7f0b6c6ed546b2702c31b5a045c7f75e3b21e Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Tue, 17 Dec 2024 11:44:22 -0700 Subject: [PATCH 2/4] edits --- docs/enterprise/monitoring-applications.mdx | 40 ++++++++++----------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/enterprise/monitoring-applications.mdx b/docs/enterprise/monitoring-applications.mdx index 97424b24df..e0b21dfce3 100644 --- a/docs/enterprise/monitoring-applications.mdx +++ b/docs/enterprise/monitoring-applications.mdx @@ -13,26 +13,6 @@ For information about consuming Prometheus metrics externally in Replicated kURL To configure Prometheus monitoring for applications installed with KOTS in an existing cluster, you can connect the Admin Console to the endpoint of an instance of Prometheus installed in the cluster. -### About Visualizing Metrics with Grafana - -In addition to the Prometheus Expression Browser, Grafana and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. - -For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). - -For information about constructing Prometheus queries, see the [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. - -For information about the Prometheus Expression Browser, see [Expression Browser](https://prometheus.io/docs/visualization/browser/) in the Prometheus documentation. - - -### About Alerting with Prometheus - -Alerting with Prometheus has two phases: - -1. Alerting rules in Prometheus servers send alerts to an Alertmanager. -1. The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. - -For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. - ## Limitation @@ -122,3 +102,23 @@ To access the Alertmanager dashboard: ``` 1. Access the dashboard at http://localhost:9093. + +## About Visualizing Metrics with Grafana + +In addition to the Prometheus Expression Browser, Grafana and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. + +For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). + +For information about constructing Prometheus queries, see the [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. + +For information about the Prometheus Expression Browser, see [Expression Browser](https://prometheus.io/docs/visualization/browser/) in the Prometheus documentation. + + +## About Alerting with Prometheus + +Alerting with Prometheus has two phases: + +1. Alerting rules in Prometheus servers send alerts to an Alertmanager. +1. The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. + +For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. \ No newline at end of file From 4dfa00f8b43b0f3f334f8a900ca70bcfcde2e085 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Tue, 28 Jan 2025 15:36:02 -0700 Subject: [PATCH 3/4] add xrefs to info that applies to both installers --- .../monitoring-access-dashboards.mdx | 66 ++++++++++++++ docs/enterprise/monitoring-applications.mdx | 89 ++----------------- .../monitoring-external-prometheus.md | 14 ++- docs/partials/monitoring/_overview-prom.mdx | 4 +- sidebars.js | 9 +- 5 files changed, 95 insertions(+), 87 deletions(-) create mode 100644 docs/enterprise/monitoring-access-dashboards.mdx diff --git a/docs/enterprise/monitoring-access-dashboards.mdx b/docs/enterprise/monitoring-access-dashboards.mdx new file mode 100644 index 0000000000..969794cddd --- /dev/null +++ b/docs/enterprise/monitoring-access-dashboards.mdx @@ -0,0 +1,66 @@ +# Accessing Dashboards Using Port Forwarding + +This topic includes information about how to access Prometheus, Grafana, and Alertmanager in Replicated KOTS existing cluster and Replicated kURL installations. + +For information about how to configure Prometheus monitoring in existing cluster installations, see [Configuring Prometheus Monitoring in Existing Cluster KOTS Installations](monitoring-applications). + +## Overview + +The Prometheus [expression browser](https://prometheus.io/docs/visualization/browser/), Grafana, and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. Prometheus Altertmanager is also included for alerting. You can access Prometheus, Grafana, and Alertmanager dashboards using `kubectl port-forward`. + +:::note +You can also expose these pods on NodePorts or behind an ingress controller. This is an advanced use case. For information about exposing the pods on NodePorts, see [NodePorts](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/node-ports.md) in the kube-prometheus GitHub repository. For information about exposing the pods behind an ingress controller, see [Expose via Ingress](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/exposing-prometheus-alertmanager-grafana-ingress.md) in the kube-prometheus GitHub repository. +::: + +## Access Prometheus + +To access the Prometheus dashboard: + +1. Run the following command to port forward the Prometheus service: + + ```bash + kubectl --namespace monitoring port-forward svc/prometheus-k8s 9090 + ``` + +1. Access the dashboard at http://localhost:9090. + +## Access Grafana + +Users can access the Grafana dashboard by logging in using a default username and password. For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). For information about constructing Prometheus queries, see [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. + +To access the Grafana dashboard: + +1. Run the following command to port forward the Grafana service: + + ```bash + kubectl --namespace monitoring port-forward deployment/grafana 3000 + ``` +1. Access the dashboard at http://localhost:3000. +1. Log in to Grafana: + * **Existing cluster**: Use the default Grafana username and password: `admin:admin`. + * **kURL cluster**: The Grafana password is randomly generated by kURL and is displayed on the command line after kURL provisions the cluster. To log in, use this password generated by kURL and the username `admin`. + + To retrieve the password, run the following kubectl command: + + ``` + kubectl get secret -n monitoring grafana-admin -o jsonpath="{.data.admin-password}" | base64 -d + ``` + +## Access Alertmanager + +Alerting with Prometheus has two phases: + +* Phase 1: Alerting rules in Prometheus servers send alerts to an Alertmanager. +* Phase 2: The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. + +For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. + +To access the Alertmanager dashboard: + +1. Run the following command to port forward the Alertmanager service: + + ``` + kubectl --namespace monitoring port-forward svc/prometheus-alertmanager 9093 + ``` + +1. Access the dashboard at http://localhost:9093. \ No newline at end of file diff --git a/docs/enterprise/monitoring-applications.mdx b/docs/enterprise/monitoring-applications.mdx index e0b21dfce3..37dc4e1242 100644 --- a/docs/enterprise/monitoring-applications.mdx +++ b/docs/enterprise/monitoring-applications.mdx @@ -1,23 +1,22 @@ import OverviewProm from "../partials/monitoring/_overview-prom.mdx" -import LimitationEc from "../partials/monitoring/_limitation-ec.mdx" -# Monitoring Applications with Prometheus +# Configuring Prometheus Monitoring in Existing Cluster KOTS Installations This topic describes how to monitor applications and clusters with Prometheus in existing cluster installations with Replicated KOTS. -For information about consuming Prometheus metrics externally in Replicated kURL installations, see [Consuming Prometheus Metrics Externally](monitoring-external-prometheus). +For information about how to access Prometheus, Grafana, and Alertmanager, see [Accessing Dashboards Using Port Forwarding](/enterprise/monitoring-access-dashboards). + +For information about consuming Prometheus metrics externally in kURL installations, see [Consuming Prometheus Metrics Externally](monitoring-external-prometheus). ## Overview -To configure Prometheus monitoring for applications installed with KOTS in an existing cluster, you can connect the Admin Console to the endpoint of an instance of Prometheus installed in the cluster. - -## Limitation +## Configure Prometheus Monitoring - +For existing cluster installations with KOTS, users can install Prometheus in the cluster and then connect the Admin Console to the Prometheus endpoint to enable monitoring. -## Install Prometheus in the Cluster {#configure-existing} +### Step 1: Install Prometheus in the Cluster {#configure-existing} Replicated recommends that you use CoreOS's Kube-Prometheus distribution for installing and configuring highly available Prometheus on an existing cluster. For more information, see the [kube-prometheus](https://github.com/coreos/kube-prometheus) GitHub repository. @@ -40,7 +39,7 @@ To install Prometheus using the recommended Kube-Prometheus distribution: For more information about advanced Kube-Prometheus configuration options, see [Customizing Kube-Prometheus](https://github.com/coreos/kube-prometheus#customizing-kube-prometheus) in the kube-prometheus GitHub repository. -## Connect to a Prometheus Endpoint +### Step 2: Connect to a Prometheus Endpoint To view graphs on the Admin Console dashboard, provide the address of a Prometheus instance installed in the cluster. @@ -51,74 +50,4 @@ To connect the Admin Console to a Prometheus endpoint: ![Configuring Prometheus](/images/kotsadm-dashboard-configureprometheus.png) - Graphs appear on the dashboard shortly after saving the address. - -## Access the Dashboards Using Port Forwarding - -You can access Prometheus, Grafana, and Alertmanager dashboards using `kubectl port-forward` after you install the manifests. - -You can also expose these pods on NodePorts or behind an ingress controller. This is an advanced use case. For information about exposing the pods on NodePorts, see [NodePorts](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/node-ports.md) in the kube-prometheus GitHub repository. For information about exposing the pods behind an ingress controller, see [Expose via Ingress](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/exposing-prometheus-alertmanager-grafana-ingress.md) in the kube-prometheus GitHub repository. - -### Access Prometheus - -To access the Prometheus dashboard: - -1. Run the following command to port forward the Prometheus service: - - ```bash - kubectl --namespace monitoring port-forward svc/prometheus-k8s 9090 - ``` - -1. Access the dashboard at http://localhost:9090. - -### Access Grafana - -To access the Grafana dashboard: - -1. Run the following command to port forward the Grafana service: - - ```bash - kubectl --namespace monitoring port-forward deployment/grafana 3000 - ``` -1. Access the dashboard at http://localhost:3000. -1. Log in to Grafana: - * **Existing cluster**: Use the default Grafana username and password: `admin:admin`. - * **kURL cluster**: The Grafana password is randomly generated by kURL and is displayed on the command line after kURL provisions the cluster. To log in, use this password generated by kURL and the username `admin`. - - To retrieve the password, run the following kubectl command: - - ``` - kubectl get secret -n monitoring grafana-admin -o jsonpath="{.data.admin-password}" | base64 -d - ``` - -### Access Alertmanager - -To access the Alertmanager dashboard: - -1. Run the following command to port forward the Alertmanager service: - - ``` - kubectl --namespace monitoring port-forward svc/prometheus-alertmanager 9093 - ``` - -1. Access the dashboard at http://localhost:9093. - -## About Visualizing Metrics with Grafana - -In addition to the Prometheus Expression Browser, Grafana and some preconfigured dashboards are included with Kube-Prometheus for advanced visualization. - -For information about configuring Grafana, see the [Grafana documentation](https://grafana.com/docs/). - -For information about constructing Prometheus queries, see the [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation. - -For information about the Prometheus Expression Browser, see [Expression Browser](https://prometheus.io/docs/visualization/browser/) in the Prometheus documentation. - - -## About Alerting with Prometheus - -Alerting with Prometheus has two phases: - -1. Alerting rules in Prometheus servers send alerts to an Alertmanager. -1. The Alertmanager then manages those alerts, including silencing, inhibition, aggregation, and sending out notifications through methods such as email, on-call notification systems, and chat platforms. - -For more information about configuring Alertmanager, see [Configuration](https://prometheus.io/docs/alerting/configuration/) in the Prometheus documentation. \ No newline at end of file + Graphs appear on the dashboard shortly after saving the address. \ No newline at end of file diff --git a/docs/enterprise/monitoring-external-prometheus.md b/docs/enterprise/monitoring-external-prometheus.md index c0df4456d5..a996c411c3 100644 --- a/docs/enterprise/monitoring-external-prometheus.md +++ b/docs/enterprise/monitoring-external-prometheus.md @@ -1,12 +1,18 @@ +import OverviewProm from "../partials/monitoring/_overview-prom.mdx" + # Consuming Prometheus Metrics Externally This topic describes how to consume Prometheus metrics in Replicated kURL clusters from a monitoring service that is outside the cluster. -## About the Prometheus NodePort Service +For information about how to access Prometheus, Grafana, and Alertmanager, see [Accessing Dashboards Using Port Forwarding](/enterprise/monitoring-access-dashboards). -By default, Prometheus is included in kURL clusters as a NodePort service named `prometheus-k8s` in the `monitoring` namespace. The `prometheus-k8s` service is exposed on the IP address for each node in the cluster at port 30900. +## Overview -For more information about NodePort services, see [Type NodePort](https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport) in _Services_ in the Kubernetes documentation. + + +For kURL installations, if the [kURL Prometheus add-on](https://kurl.sh/docs/add-ons/prometheus) is included in the kURL installer spec, then the Prometheus monitoring system is installed alongside the application. No additional configuration is required to collect metrics and view any default and custom graphs on the Admin Console dashboard. + +Prometheus is deployed in kURL clusters as a NodePort service named `prometheus-k8s` in the `monitoring` namespace. The `prometheus-k8s` service is exposed on the IP address for each node in the cluster at port 30900. You can run the following command to view the `prometheus-k8s` service in your cluster: @@ -21,6 +27,8 @@ prometheus-k8s NodePort 10.96.2.229 9090:30900/TCP 5hr ``` As shown in the example above, port 9090 on the `prometheus-k8s` service maps to port 30900 on each of the nodes. +For more information about NodePort services, see [Type NodePort](https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport) in _Services_ in the Kubernetes documentation. + ## Prerequisite Before you can consume Prometheus metrics in kURL clusters externally, ensure that firewall rules on all nodes in the cluster allow inbound TCP traffic on port 30900. diff --git a/docs/partials/monitoring/_overview-prom.mdx b/docs/partials/monitoring/_overview-prom.mdx index 398ad6e4cc..ea75499d08 100644 --- a/docs/partials/monitoring/_overview-prom.mdx +++ b/docs/partials/monitoring/_overview-prom.mdx @@ -12,6 +12,4 @@ The following screenshot shows an example of the **Monitoring** section on the A Graphs on the Admin Console dashboard -[View a larger version of this image](/images/kotsadm-dashboard-graph.png) - -For existing cluster installations with KOTS, users can install Prometheus in the cluster and then connect the Admin Console to the Prometheus endpoint to enable monitoring. \ No newline at end of file +[View a larger version of this image](/images/kotsadm-dashboard-graph.png) \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index b68cd8ad93..33afac42e2 100644 --- a/sidebars.js +++ b/sidebars.js @@ -437,7 +437,14 @@ const sidebars = { 'enterprise/auth-configuring-rbac', ], }, - 'enterprise/monitoring-applications', + { + type: 'category', + label: 'Monitoring Applications with Prometheus', + items: [ + 'enterprise/monitoring-applications', + 'enterprise/monitoring-access-dashboards', + ], + }, 'enterprise/status-viewing-details', 'enterprise/delete-admin-console', { From 45896e40120f3374f20d98024194e800ad4c24e7 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Wed, 29 Jan 2025 15:25:30 -0700 Subject: [PATCH 4/4] add prereq for accessing dashboards --- docs/enterprise/monitoring-access-dashboards.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/enterprise/monitoring-access-dashboards.mdx b/docs/enterprise/monitoring-access-dashboards.mdx index 969794cddd..8538e74185 100644 --- a/docs/enterprise/monitoring-access-dashboards.mdx +++ b/docs/enterprise/monitoring-access-dashboards.mdx @@ -12,6 +12,10 @@ The Prometheus [expression browser](https://prometheus.io/docs/visualization/bro You can also expose these pods on NodePorts or behind an ingress controller. This is an advanced use case. For information about exposing the pods on NodePorts, see [NodePorts](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/node-ports.md) in the kube-prometheus GitHub repository. For information about exposing the pods behind an ingress controller, see [Expose via Ingress](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizations/exposing-prometheus-alertmanager-grafana-ingress.md) in the kube-prometheus GitHub repository. ::: +## Prerequisite + +For existing cluster KOTS installations, first install Prometheus in the cluster and configure monitoring. See [Configuring Prometheus Monitoring in Existing Cluster KOTS Installations](monitoring-applications) + ## Access Prometheus To access the Prometheus dashboard: