Monitor Portworx Clusters on Kubernetes
To ensure your storage infrastructure's health, performance, and reliability, it is crucial to monitor your Portworx cluster. The monitoring approach varies depending on your deployment environment. For most setups, Portworx's integrated Prometheus and Grafana deployment runs by default.
Monitoring your Portworx cluster in a Kubernetes environment involves leveraging technologies like Prometheus, Alertmanager, and Grafana. These tools help in collecting data, managing alerts, and visualizing metrics.
- Prometheus: Collects metrics, which are essential for Autopilot to identify and respond to conditions like storage capacity issues, enabling automatic PVC expansion and storage pool scaling.
- Alertmanager: Manages alerts, integrating with Autopilot for timely notifications about critical cluster conditions.
- Grafana: Visualizes data from Prometheus in an easy-to-understand format, aiding in quick decision-making for cluster management.
Each tool plays a vital role in ensuring efficient, automated monitoring and response within your cluster.
By default, Portworx deploys PX Prometheus for monitoring. Starting with Operator version 25.5.0, you can also use an external Prometheus instance.
Prerequisites
- Configure Prometheus. For more information, see Configure Prometheus.
- Configure Grafana. For more information, see Configure Grafana.
- Configure Alertmanager. For more information, see Configure Alertmanager.
Grafana dashboards for Portworx
Grafana offers several built-in dashboards for monitoring Portworx. These dashboards provide a real-time view of the system’s performance and status, helping you maintain optimal performance and quickly diagnose any issues.
Node Exporter dashboard
Log in to the Grafana UI, from Dashboards navigate to the Manage section, and select Portworx Performance Monitor. You can see the dashboards with (Node Exporter):

Etcd dashboard
The Etcd Dashboard provides metrics specific to the etcd component, which is critical for cluster coordination.

Key panels include:
- Disk Sync Duration: Tracks the latency of persisting etcd log entries to disk. High values (> 1s) may indicate issues with the KVDB disk metrics.
- Up: Monitors the health of KVDB nodes.
Portworx Cluster dashboard
This dashboard provides an overview of the cluster's storage and health.

Key panels include:
- Usage Meter: Displays the percentage of utilized storage compared to total capacity.
- Capacity Used: Shows the actual storage space used in the cluster.
- Nodes (total): Displays the number of nodes in the Portworx cluster.
- Storage Providers: Indicates how many storage nodes are currently online.
- Quorum: Tracks the quorum status of the cluster.
- Nodes online: Number of online nodes in the cluster (includes storage and storage-less).
- Avg. Cluster CPU: Monitors the average CPU usage across all nodes.
Portworx Node dashboard
The Node dashboard focuses on individual nodes in the cluster.

Key panels include:
- PWX Disk Usage: Monitors the Portworx storage space used per node.
- PWX Disk IO: Displays the time spent on disk read and write operations per node.
- PWX Disk Throughput: Shows the rate of total bytes read and written for each node.
- PWX Disk Latency: Provides the average time spent on read and write operations for each node.
Portworx Volume dashboard
The Volume dashboard provides insights into the performance and utilization of storage volumes within the cluster. It is divided into two main sections: All Volumes in the Cluster and Individual Volumes, offering a detailed view of both overall and per-volume metrics.

All Volumes in the Cluster
This section displays metrics aggregated across all volumes in the cluster, helping you track overall performance and identify any potential bottlenecks.
- Avg Read Latency (1m): Average time (in seconds) spent on completing read operations during the last minute for all volumes.
- Avg Write Latency (1m): Average time (in seconds) spent on completing write operations during the last minute for all volumes.
- Top n Volumes by Capacity: Lists the top n volumes in the cluster based on their storage capacity.
- Top n Volumes by IO Depth: Lists the top n volumes based on the number of I/O operations currently in progress.
Individual Volumes
This section provides metrics for each individual volume in the cluster, allowing for detailed monitoring of specific volume performance and usage.
- Replication Level (HA): Displays both the current and configured High Availability (HA) level for the volume.
- Avg Read Latency: Average time (in seconds) spent per successfully completed read operation for the volume.
- Avg Write Latency: Average time (in seconds) spent per successfully completed write operation for the volume.
- Volume Usage: Shows the total capacity and the used storage space for the volume.
- Volume Latency: Displays the average time (in seconds) spent per successfully completed read and write operations during the given interval.
- Volume IOPs: Number of successfully completed I/O operations per second for the volume.
- Volume IO Depth: Number of I/O operations currently in progress for the volume.
- Volume IO Throughput: Displays the number of bytes read and written per second for the volume.