Ingress Traffic Monitoring with Prometheus
Using Higress Console’s Built-in Monitoring Suite
Higress Console includes a built-in monitoring suite based on Prometheus + Grafana, though it’s not installed by default. To enable this monitoring suite during Helm installation, add the --set global.o11y.enabled=true
parameter to your Helm install command:
helm repo add higress.io https://higress.io/helm-chartshelm install higress -n higress-system higress.io/higress --create-namespace --render-subchart-notes --set global.o11y.enabled=true
Note: When installing on a standard Kubernetes cluster (without the
global.local=true
parameter), the monitoring system’s PersistentVolumeClaim defaults to using theReadWriteMany
access mode. If your Kubernetes cluster doesn’t support this access mode, you can add the--set global.pvc.rwxSupported=false
parameter to switch toReadWriteOnce
access mode:
helm repo add higress.io https://higress.io/helm-chartshelm install higress -n higress-system higress.io/higress --create-namespace --render-subchart-notes --set global.o11y.enabled=true --set global.pvc.rwxSupported=false
After installation is complete, access the Higress Console in your browser and click on the “Monitoring Dashboard” in the left navigation menu. The built-in monitoring dashboard will be displayed on the right side of the page.
Using an Independently Deployed Monitoring Suite
Both the data plane and control plane components of Higress expose a series of metrics through their APIs. You can monitor Higress’s internal operations by configuring Prometheus to collect these metrics and setting up dashboards in Grafana.
To get started, open Higress Console in your browser and navigate to the “Monitoring Dashboard” page in the left navigation menu. If the built-in monitoring suite isn’t installed, the page will display an external dashboard URL configuration page along with setup instructions for external systems.
Follow the instructions at the bottom of the page to update your Prometheus and Grafana configurations. Then, enter the URL of your Grafana dashboard in the input field at the top and save. The page will refresh automatically, and the configured external monitoring dashboard will appear on the right side.
To update the monitoring dashboard URL later, simply click the “Reconfigure” button in the top-left corner of the page. helm repo add higress.io https://higress.io/helm-charts helm install higress -n higress-system higress.io/higress —create-namespace —render-subchart-notes —set global.o11y.enabled=true —set global.pvc.rwxSupported=false
After installation, open Higress Console in your browser, and click "Dashboard" on the left navigation area. The built-in dashboard will be displayed on the right.

## Use a Standalone Monitor Suite
Both the data and control planes of Higress expose a set of metrics via API. To monitor them, you just need to add probe configurations into Prometheus and configure a dashboard in Grafana.
Before starting the configuration, please open Higress Console in your browser and switch to "Dashboard" from the left navigation area. The external dashboard configuration page and related notes will be displayed on the right.

Update the configurations of Prometheus and Grafana following the notes. Then put the Grafana dashboard into the textbox above and save. The page will reload automatically and your dashboard will be shown on the right.

If you'd like to update the dashboard URL, you can click the "Reconfigure" button on the top left corner.