Architecture
Dokploy’s monitoring system consists of two main components:- Server Monitoring: Tracks system-level metrics including CPU, memory, disk, and network usage for the host machine
- Container Monitoring: Collects metrics from Docker containers including CPU, memory, network I/O, and block I/O
Key Features
Real-Time Metrics Collection
Monitor critical system resources in real-time with customizable refresh rates:- CPU usage and core information
- Memory utilization and available RAM
- Disk usage and I/O operations
- Network traffic (input/output)
- Container-specific resource consumption
Threshold Alerts
Configure CPU and memory thresholds to receive notifications when resource usage exceeds defined limits. Alerts are sent through your configured notification channels.Data Retention
Control how long metrics are stored with configurable retention periods. The system automatically cleans up old metrics based on your settings to manage disk space efficiently.Service Filtering
Choose which containers to monitor using include/exclude lists. This allows you to focus on critical services and reduce monitoring overhead.Monitoring Types
Free Monitoring (Default)
The built-in free monitoring provides:- Real-time container metrics for Dokploy itself
- Basic CPU and memory graphs
- Network and disk I/O statistics
- Last 24 hours of data retention
Advanced Monitoring
Advanced monitoring offers:- Extended metrics history (configurable retention)
- Custom refresh rates
- Threshold-based alerting
- Container service filtering
- Multiple server monitoring support
- Integration with notification services
Metrics Collected
Server Metrics
| Metric | Description |
|---|---|
| CPU Usage | Percentage of CPU utilization across all cores |
| CPU Model | Processor model and specifications |
| CPU Cores | Number of logical and physical cores |
| Memory Used | RAM usage in percentage and GB |
| Memory Total | Total available RAM |
| Disk Usage | Percentage of disk space used |
| Disk Total | Total disk capacity |
| Network I/O | Incoming and outgoing network traffic |
| Uptime | System uptime in seconds |
Container Metrics
| Metric | Description |
|---|---|
| CPU | Percentage of CPU used by the container |
| Memory | RAM usage (used/total) and percentage |
| Network | Input/output network traffic with units |
| Block I/O | Read/write disk operations with units |
| Container ID | Unique container identifier |
| Container Name | Human-readable container name |
Getting Started
To begin monitoring your infrastructure:- Navigate to Settings > Monitoring in the Dokploy dashboard
- Configure your monitoring preferences (refresh rates, retention, thresholds)
- Set up notification integrations for alerts (optional)
- View real-time metrics in the Monitoring dashboard