Skip to main content
Learn how to check what metrics are available for monitoring your service using Prometheus, and find out which of the available metrics are particularly worth monitoring and why.

​
About the Prometheus integration

The Prometheus integration allows you to monitor your Aiven services and understand the resource usage. Using this integration, you can track non-service-specific system metrics that provide insights into infrastructure performance. To start using Prometheus for monitoring metrics, configure the Prometheus integration and set up the Prometheus server.

​
Get a list of available service metrics

To discover the metrics available for your services, make an HTTP GET request to your Prometheus service endpoint.
1

Collect connection information

Once your Prometheus integration is configured, collect the following details from Aiven Console:
  1. Navigate to the Overview page of your service
  2. Go to the Connection information section
  3. Open the Prometheus tab
  4. Copy:
    • Prometheus URL
    • Username
    • Password
2

Request metrics snapshot

Make a request to get a snapshot of your metrics:
Replace USERNAME, PASSWORD, and PROMETHEUS_URL with your service values.
3

Review available metrics

The output provides a full list of metrics available for your service.

​
Key system metrics

​
CPU usage metrics

CPU usage metrics help determine if the CPU is constantly being maxed out.

​
High-level CPU usage

For a single CPU service, get an overview with:
A process with a nice value larger than 0 is categorized as cpu_usage_nice, which is not included in cpu_usage_user.

​
CPU I/O wait monitoring

Monitor cpu_usage_iowait{cpu="cpu-total"} to detect I/O bottlenecks. A high value indicates that the service node is working on something I/O intensive.For example, if cpu_usage_iowait{cpu="cpu-total"} equals 40, the CPU is idle waiting for disk or network I/O operations for 40% of the time.

​
CPU metrics reference

These metrics are generated from the Telegraf CPU plugin:

​
Disk usage metrics

Monitoring disk usage ensures that applications or processes don’t fail due to insufficient disk storage.
Consider monitoring disk_used_percent and disk_free to prevent storage-related issues.

​
Disk metrics reference

​
Memory usage metrics

Memory consumption metrics are essential to ensure the performance of your service.
Consider monitoring mem_available (in bytes) or mem_available_percent, as this represents the estimated amount of memory available for applications without swapping.

​
Key memory metrics

  • mem_available - Available memory for applications (bytes)
  • mem_available_percent - Available memory as a percentage
  • mem_total - Total system memory
  • mem_used - Used memory
  • mem_free - Free memory
  • mem_cached - Cached memory
  • mem_buffered - Buffered memory

​
Network usage metrics

Monitoring the network provides visibility of your network utilization and traffic, allowing you to act immediately in case of network issues.
It may be worth monitoring the number of established TCP sessions available in the netstat_tcp_established metric.

​
Key network metrics

  • netstat_tcp_established - Number of established TCP connections
  • net_bytes_sent - Bytes sent over the network
  • net_bytes_recv - Bytes received from the network
  • net_packets_sent - Packets sent over the network
  • net_packets_recv - Packets received from the network
  • net_err_in - Inbound network errors
  • net_err_out - Outbound network errors

​
Monitoring best practices

​
Alerting thresholds

Consider setting alerts for:
  • CPU usage - Alert when 100 - cpu_usage_idle > 80% for extended periods
  • CPU I/O wait - Alert when cpu_usage_iowait > 30% consistently
  • Disk usage - Alert when disk_used_percent > 85%
  • Memory available - Alert when mem_available_percent < 15%
  • TCP connections - Alert on unusual changes in netstat_tcp_established

​
Query examples

​
Visualization recommendations

For effective monitoring dashboards:
  1. Overview panel - Display CPU, memory, disk, and network at a glance
  2. CPU breakdown - Show user, system, and I/O wait separately
  3. Disk trends - Plot usage over time to predict capacity needs
  4. Memory pressure - Track available memory and swap usage
  5. Network traffic - Monitor bytes sent/received and error rates

​
Troubleshooting

​
No metrics appearing

  • Verify the Prometheus integration is enabled on your service
  • Check credentials (username and password) are correct
  • Confirm the Prometheus URL is accessible
  • Allow a few minutes for initial metrics to populate

​
Incomplete metrics

  • Some metrics may not be available for all service types
  • Check service logs for any integration errors
  • Verify the Prometheus server is configured correctly

​
High cardinality warnings

  • Limit the number of unique label combinations
  • Use Prometheus recording rules for frequently queried metrics
  • Consider adjusting retention policies