Features
Monitoring
Overview

Monitoring

OEC.sh provides real-time monitoring to help you track server health, environment performance, and receive alerts when issues arise.

What Monitoring Shows

The monitoring system tracks key metrics across your infrastructure:

Server Metrics

  • CPU usage percentage
  • Memory (RAM) usage and availability
  • Disk space utilization
  • Network traffic (KB/s combined receive and transmit)

Container Health

  • Running status of Odoo and database containers
  • CPU and memory usage per container
  • Network I/O per container
  • Container restart counts

Database Replica Health (Odoo 18/19 only)

  • Replication status (online, lagging, offline, error)
  • Data lag in bytes and seconds

Viewing Server Metrics

To check your server health:

  1. Navigate to Servers in the left sidebar
  2. Select a server from the list
  3. Click the Metrics tab
  4. View current CPU, memory, and disk usage

The metrics panel displays:

  • Current values with percentage indicators
  • Health status badge (healthy, warning, critical)
  • Container list with individual resource usage

Health Status Thresholds

StatusCPUMemoryDisk
HealthyBelow 70%Below 70%Below 80%
Warning70-85%70-85%80-90%
CriticalAbove 85%Above 85%Above 90%

Viewing Environment Health

To monitor a specific environment:

  1. Go to Environments and select your environment
  2. Click on the Monitoring tab
  3. Review container status and resource usage

Note: The Monitoring tab is only available when the environment is running and a server is assigned.

The environment view shows:

  • Odoo container CPU and memory usage
  • Database container performance
  • Container status (running, stopped, restarting)
  • Network I/O statistics

Metrics refresh automatically every 30 seconds.

Understanding Alerts

OEC.sh generates alerts when metrics exceed thresholds:

Alert Types

  • High CPU: Server CPU consistently above threshold
  • High Memory: Memory usage approaching limits
  • Low Disk Space: Disk running out of storage
  • Container Down: A container has stopped unexpectedly
  • Server Unreachable: Cannot connect to server

Alert Severities

  • Info: Informational notice, no action needed
  • Warning: Review within hours, may need attention
  • Critical: Immediate action required

Receiving Alerts

Alerts appear in multiple places:

  1. Real-time notifications in the dashboard
  2. Email notifications (if configured)
  3. Alert history in the server monitoring panel

Where to Find Monitoring

What to MonitorWhere to Find It
Server metricsServers > Select server > Metrics tab
Environment healthEnvironments > Select environment > Monitoring tab
Active alertsDashboard notifications or dedicated Alerts page
Replica healthEnvironments > Settings tab > Database section

Database Replica Monitoring

For environments with PostgreSQL read replicas (Odoo 18 and 19 only):

  1. Go to your environment details page
  2. Click the Settings tab
  3. Find the Database section
  4. The Read Replica Status widget shows:
    • Online: Replica is healthy and synchronized
    • Lagging: Replica is behind primary database
    • Offline: Replica is not streaming data
    • Error: Health check failed (see error message for details)

Lag Metrics Displayed

  • Lag (Bytes): Amount of WAL data not yet replicated
  • Lag (Time): How far behind the replica is in seconds
  • Last Checked: When the health check last ran

Lag Thresholds

  • Warning: Over 50MB or 15 seconds behind
  • Critical: Over 100MB or 30 seconds behind

Real-Time Updates

The monitoring dashboard updates automatically without refreshing the page:

  • Server metrics refresh every 30 seconds
  • Charts refresh every 60 seconds
  • Instant alert notifications when issues occur
  • Deployment progress updates in real-time

If you notice updates are not appearing, refresh the page to reconnect to the live stream.

What's Next?

OverviewOverview