​
Monitoring

Uncloud provides built-in monitoring for all resources, powered by Prometheus and the Kubernetes Metrics Server.

​
Dashboard Overview

The main dashboard shows aggregate statistics: 
curl http://localhost:8080/api/v1/dashboard/stats

{
  "droplets": { "total": 5, "running": 4, "off": 1 },
  "apps": { "total": 12, "running": 10, "failed": 2 },
  "databases": { "total": 3, "running": 3 },
  "volumes": { "total": 8, "attached": 5, "available": 3 },
  "cpu_usage_percent": 35.2,
  "memory_usage_percent": 48.7
}

​
Droplet Metrics

Monitor CPU, memory, and disk I/O for individual VMs: 
curl http://localhost:8080/api/v1/droplets/dpl_your_id/metrics

{
  "cpu_usage_percent": 23.5,
  "memory_usage_bytes": 536870912,
  "memory_total_bytes": 2147483648,
  "disk_read_bytes": 1048576,
  "disk_write_bytes": 2097152
}

​
App Metrics

Monitor application resource usage: 
curl http://localhost:8080/api/v1/apps/app_your_id/metrics

{
  "cpu_usage_millicores": 250,
  "memory_usage_bytes": 134217728,
  "disk_usage_bytes": 52428800,
  "network_rx_bytes": 10485760,
  "network_tx_bytes": 5242880,
  "request_count": 15000,
  "error_rate": 0.02
}

​
Node Metrics

View cluster-wide resource usage: 
curl http://localhost:8080/api/v1/nodes

​
Kubernetes Events

Monitor real-time events for any resource: 
# Droplet events
curl http://localhost:8080/api/v1/droplets/dpl_your_id/events

# App events
curl http://localhost:8080/api/v1/apps/app_your_id/events

# Global events
curl http://localhost:8080/api/v1/events

​
Resource Quotas

Check usage against quotas: 
curl http://localhost:8080/api/v1/quotas

​
Alerting with Webhooks

Set up alerts for important events: 
# Alert on app failures
curl -X POST http://localhost:8080/api/v1/webhooks \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.slack.com/services/your-hook",
    "events": [
      "app.deploy.failed",
      "backup.failed",
      "droplet.error"
    ]
  }'

​
Prometheus Integration

Uncloud queries Prometheus for historical metrics. Configure the endpoint: 
export PROMETHEUS_URL=http://localhost:30090
Access Prometheus directly for custom queries and dashboards.

​
Frontend Dashboard

The web dashboard includes:
  • Real-time charts — CPU, memory, network, and disk usage over time
  • Resource overview — Count and status of all resources
  • Event timeline — Recent Kubernetes events
  • Health indicators — Quick status of all infrastructure components