> ## Documentation Index > Fetch the complete documentation index at: https://docs.deployerp.com/llms.txt > Use this file to discover all available pages before exploring further. # Server Monitoring > Real-time monitoring and alerting for your Odoo servers ## Overview deployERP provides comprehensive monitoring capabilities to ensure your Odoo servers operate at peak performance. Monitor resources, track metrics, and receive alerts for critical events. ## Monitoring Dashboard Access real-time server metrics from your dashboard: Navigate to **Servers → \[Server Name] → Monitoring** to view detailed metrics ### Key Metrics Processor utilization percentage RAM usage and available memory Read/write operations and latency Bandwidth usage and connections ## Metrics Collection ### System Metrics deployERP collects comprehensive system metrics: | Metric | Description | Collection Interval | Retention | | --------------- | -------------------------------- | ------------------- | --------- | | CPU Usage | Overall and per-core utilization | 30 seconds | 30 days | | Memory Usage | RAM, swap, and cache statistics | 30 seconds | 30 days | | Disk Usage | Space utilization and I/O stats | 60 seconds | 30 days | | Network Traffic | Inbound/outbound bandwidth | 30 seconds | 30 days | | Process Count | Active processes and threads | 60 seconds | 7 days | | Load Average | 1, 5, and 15-minute averages | 30 seconds | 30 days | ### Application Metrics Odoo-specific monitoring: | Metric | Description | Collection Interval | Retention | | ---------------- | --------------------------------- | ------------------- | --------- | | HTTP Requests | Request rate and response times | 10 seconds | 7 days | | Database Queries | Query count and execution time | 30 seconds | 7 days | | Worker Status | Active, idle, and blocked workers | 30 seconds | 7 days | | Cache Hit Rate | Redis cache performance | 60 seconds | 7 days | | Error Rate | Application errors and warnings | Real-time | 30 days | | Active Users | Concurrent user sessions | 60 seconds | 7 days | ## Real-Time Monitoring ### Live Metrics View Monitor your server in real-time: ```bash theme={null} # View live metrics via CLI deployerp server monitor srv_abc123 --live # Output ┌─────────────────────────────────────────────┐ │ Server: production-eu-1 │ │ Status: Running | Uptime: 45d 12h 30m │ ├─────────────────────────────────────────────┤ │ CPU: [████████░░░░░░░░░░] 42.5% │ │ Memory: [██████████████░░░░] 73.2% (11.7GB)│ │ Disk: [████████████░░░░░░] 61.0% (195GB) │ │ Network: ↓ 125 Mbps ↑ 45 Mbps │ └─────────────────────────────────────────────┘ ``` ### Metric Visualization View trends and patterns: Line graphs showing metric changes over time * Customizable time ranges * Multiple metric overlay * Zoom and pan capabilities Visual representation of resource usage * CPU core utilization * Memory allocation patterns * Disk I/O hotspots Real-time status indicators * Current utilization levels * Threshold warnings * Peak usage markers ## Alert Configuration ### Creating Alerts Set up custom alerts for critical metrics: Choose the metric to monitor Set warning and critical levels Specify how long before triggering Choose notification channels ### Alert Types Trigger when metrics exceed limits ```yaml theme={null} cpu_high: metric: cpu_usage condition: ">" threshold: 80 duration: 5m ``` Detect unusual patterns ```yaml theme={null} traffic_spike: metric: network_in condition: anomaly sensitivity: high window: 1h ``` Monitor service uptime ```yaml theme={null} service_down: check: http_status endpoint: /web/health expected: 200 interval: 60s ``` Combine multiple conditions ```yaml theme={null} high_load: conditions: - cpu_usage > 70 - memory_usage > 80 - response_time > 500ms ``` ### Common Alert Rules ```yaml theme={null} # High CPU usage - name: "High CPU Usage" metric: system.cpu.usage condition: ">" threshold: 85 duration: 5m severity: warning # Memory pressure - name: "Memory Pressure" metric: system.memory.usage condition: ">" threshold: 90 duration: 3m severity: critical # Disk space low - name: "Low Disk Space" metric: system.disk.usage condition: ">" threshold: 85 duration: 10m severity: warning # Database connections - name: "Database Connection Pool" metric: postgresql.connections.active condition: ">" threshold: 80 duration: 2m severity: warning # Response time - name: "Slow Response Time" metric: odoo.http.response_time condition: ">" threshold: 1000 # milliseconds duration: 5m severity: warning ``` ## Notification Channels ### Email Notifications Configure email alerts: ```json theme={null} { "channel": "email", "addresses": ["ops@company.com", "admin@company.com"], "settings": { "include_graphs": true, "include_logs": false, "batch_window": "5m" } } ``` ### Slack Integration Send alerts to Slack: ```json theme={null} { "channel": "slack", "webhook_url": "https://hooks.slack.com/services/xxx", "settings": { "channel": "#alerts", "username": "deployERP Bot", "icon_emoji": ":warning:", "mention_users": ["@oncall"] } } ``` ### Webhook Notifications Custom webhook integration: ```json theme={null} { "channel": "webhook", "url": "https://your-app.com/webhooks/alerts", "method": "POST", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "retry": { "attempts": 3, "backoff": "exponential" } } ``` ## Performance Analysis ### Resource Utilization Reports Generate detailed performance reports: ``` Daily Performance Summary - 2024-01-15 ===================================== CPU Usage: - Average: 45.2% - Peak: 78.5% at 14:30 - 95th percentile: 62.0% Memory Usage: - Average: 8.3 GB (51.9%) - Peak: 12.1 GB (75.6%) - Swap used: 0 GB Disk I/O: - Read: 1.2 TB - Write: 450 GB - Average latency: 2.3ms Network: - Inbound: 850 GB - Outbound: 1.1 TB - Peak throughput: 180 Mbps ``` Analyze patterns over the week: * Peak usage times * Resource consumption trends * Capacity planning insights * Optimization opportunities Long-term analysis: * Growth trends * Seasonal patterns * Capacity forecasting * Cost optimization ### Query Performance Monitor database performance: ```sql theme={null} -- Top slow queries SELECT query, calls, mean_time, total_time FROM pg_stat_statements ORDER BY mean_time DESC LIMIT 10; -- Connection statistics SELECT datname, numbackends, xact_commit, xact_rollback FROM pg_stat_database; ``` ## Auto-Healing ### Automatic Recovery Actions deployERP automatically responds to common issues: | Condition | Auto-Healing Action | Notification | | ----------------- | ----------------------------- | ------------ | | Service down | Restart service | Alert sent | | High memory usage | Clear caches, restart workers | Warning sent | | Disk space low | Clean logs, temp files | Alert sent | | Database locks | Kill blocking queries | Alert sent | | Worker deadlock | Restart affected workers | Warning sent | | Network issues | Reset connections | Alert sent | ### Configuring Auto-Healing ```yaml theme={null} auto_healing: enabled: true rules: - name: "Restart on crash" trigger: service_down action: restart_service max_attempts: 3 cooldown: 5m - name: "Memory cleanup" trigger: memory_usage > 85% actions: - clear_cache - restart_workers cooldown: 15m - name: "Disk cleanup" trigger: disk_usage > 80% actions: - rotate_logs - clean_temp_files cooldown: 1h ``` ## Log Management ### Log Collection Centralized log collection: | Log Type | Location | Retention | Searchable | | --------------- | ---------------------- | --------- | ---------- | | Odoo logs | `/var/log/odoo/` | 30 days | Yes | | PostgreSQL logs | `/var/log/postgresql/` | 30 days | Yes | | Nginx logs | `/var/log/nginx/` | 7 days | Yes | | System logs | `/var/log/syslog` | 7 days | Yes | | deployERP agent | `/var/log/deployerp/` | 30 days | Yes | ### Log Analysis Search and analyze logs: ```bash theme={null} # Search Odoo logs deployerp logs search --instance=production --query="ERROR" --last=1h # Tail logs in real-time deployerp logs tail --instance=production --filter="sale.order" # Export logs deployerp logs export --instance=production --from=2024-01-01 --to=2024-01-15 ``` ## Custom Metrics ### Defining Custom Metrics Create business-specific metrics: ```python theme={null} # Custom metric example { "name": "daily_orders", "type": "gauge", "query": "SELECT COUNT(*) FROM sale_order WHERE date >= CURRENT_DATE", "interval": "5m", "labels": { "app": "odoo", "module": "sales" } } ``` ### Metric Export Export metrics to external systems: ```yaml theme={null} prometheus: enabled: true port: 9090 path: /metrics ``` ```yaml theme={null} datadog: enabled: true api_key: "YOUR_KEY" site: "datadoghq.com" ``` ```yaml theme={null} newrelic: enabled: true license_key: "YOUR_KEY" ``` ```yaml theme={null} cloudwatch: enabled: true region: "us-east-1" namespace: "deployERP" ``` ## Monitoring Best Practices * Base thresholds on historical data * Consider business hours vs off-hours * Account for seasonal variations * Review and adjust regularly * Prioritize critical alerts * Use appropriate severity levels * Implement alert suppression * Group related alerts * Track application-specific KPIs * Monitor user experience metrics * Correlate technical and business metrics * Create custom dashboards * Weekly performance reviews * Monthly capacity planning * Quarterly optimization assessments * Annual architecture reviews ## Troubleshooting ### Common Monitoring Issues | Issue | Cause | Solution | | ---------------- | -------------------- | ----------------------- | | Missing metrics | Agent down | Restart deployERP agent | | Delayed alerts | Network issues | Check connectivity | | False positives | Incorrect thresholds | Adjust alert rules | | High cardinality | Too many labels | Reduce metric labels | ### Monitoring Commands ```bash theme={null} # Check agent status systemctl status deployerp-agent # Test metric collection deployerp-agent test # Verify connectivity deployerp-agent ping # Debug mode deployerp-agent run --debug ``` ## Related Documentation * [Alert Configuration](/servers/alerts) * [Performance Tuning](/guides/performance) * [Log Analysis](/advanced/logging) * [Capacity Planning](/guides/capacity-planning)