Skip to content
下载《AI 应用 & AI Agent 开发新范式》电子书 了解构建 AI Agent 和 MCP Server 的一线实践Know more

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:

Terminal window
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

Note: When installing on a standard Kubernetes cluster (without the global.local=true parameter), the monitoring system’s PersistentVolumeClaim defaults to using the ReadWriteMany access mode. If your Kubernetes cluster doesn’t support this access mode, you can add the --set global.pvc.rwxSupported=false parameter to switch to ReadWriteOnce access mode:

Terminal window
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 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.

image

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.

image

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.

image

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.
![image](/img/user/prometheus/en-us/builtin.png)
## 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.
![image](/img/user/prometheus/en-us/external-before.png)
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.
![image](/img/user/prometheus/en-us/external-after.png)
If you'd like to update the dashboard URL, you can click the "Reconfigure" button on the top left corner.