Project Resources Monitoring

Overview

The monitoring page provides comprehensive real-time insights into your project’s resource consumption and container activity. You can track CPU, memory, and disk usage of your virtual machine, as well as view live Docker logs from your deployed containers.

Accessing Monitoring

  1. Navigate to your project’s details page
  2. Click on the “Monitoring” tab to access the monitoring dashboard
  3. The monitoring interface will load and begin displaying real-time data

Resource Usage Metrics

CPU Usage

The CPU usage section displays how much processing power your project is consuming:

  • Percentage Ring Chart: Shows current CPU utilization as a percentage (e.g., 3.2%)
  • Historical Graph: Displays CPU usage trends over time with a timeline
  • Real-time Updates: Data refreshes automatically to show current CPU load

CPU Monitoring

Monitor CPU spikes to identify performance bottlenecks or resource-intensive operations in your application.

Memory Usage

Memory monitoring helps track your project’s RAM consumption:

  • Percentage Display: Shows current memory utilization (e.g., 16.1%)
  • Usage Graph: Displays memory consumption patterns over time
  • Memory Limits: Visual indicators show how close you are to memory limits

Disk Usage

Disk usage monitoring shows storage consumption on your virtual machine:

  • Storage Percentage: Current disk space utilization (e.g., 2.6%)
  • Usage Timeline: Historical disk usage patterns
  • Storage Trends: Track how disk usage changes over time

Visual Dashboard Features

Ring Charts

Each resource metric is displayed as an intuitive ring chart showing:

  • Current usage percentage
  • Large, easy-to-read percentage values

Historical Graphs

Below each ring chart, detailed histograms provide:

  • Time Series Data: Usage patterns over time
  • Real-time Updates: Continuous data refresh

Docker Logs

Live Log Viewing

The bottom section of the monitoring page displays real-time Docker logs:

  • Container Logs: Live output from your Docker containers
  • Real-time Streaming: Logs update automatically as new entries are generated
  • Multiple Containers: If your project uses multiple containers, logs from all containers are displayed

Log Features

  • Search Functionality: Search through logs to find specific entries or errors
  • Filtering Options: Filter logs by container, log level, or time period
  • Log Persistence: Historical logs are maintained for troubleshooting

Log Retention

Docker logs are retained for a specific period to help with debugging and monitoring. For long-term log storage, consider implementing external logging solutions.

Monitoring Best Practices

Resource Optimization

CPU Monitoring:

  • Watch for sustained high CPU usage (>80%)
  • Identify CPU-intensive processes from logs
  • Optimize code or scale resources if needed

Memory Management:

  • Monitor for gradual memory increases (potential memory leaks)
  • Monitor high memory usage (>85%)

Disk Usage:

  • Keep disk usage below 80% for optimal performance
  • Monitor disk growth patterns
  • Clean up unnecessary files and logs regularly

Performance Analysis

Use the monitoring data to:

  • Identify Bottlenecks: Correlate resource spikes with application logs
  • Optimize Performance: Adjust application configuration based on usage patterns
  • Debug Issues: Use logs and resource data together for troubleshooting

Real-time Updates

Automatic Refresh

The monitoring dashboard automatically updates:

  • Resource Metrics: CPU, memory, and disk data refresh every few seconds
  • Log Streaming: New log entries appear instantly
  • Graph Updates: Historical charts update with new data points
  • Status Indicators: Real-time status changes are reflected immediately

Data Accuracy

  • All metrics reflect the actual state of your virtual machine
  • Resource data comes directly from the host system
  • Docker logs are streamed live from container outputs
  • Minimal delay between actual events and dashboard display

Understanding the Interface

Interactive Elements

  • Hover Information: Hover over chart elements for detailed information
  • Time Selection: Select different time ranges for historical data
  • Log Search: Use the search functionality to find specific log entries

Resource Alerts

Keep an eye on resource usage patterns. Sustained high usage may indicate the need for optimization or resource scaling to maintain optimal performance.