Logs & Monitoring
How to view logs and monitor your sites and servers in Sproobo
Sproobo forwards logs from your servers to a central log store and displays them in the dashboard with live-tail and historical search.
How Logging Works
The Sproobo agent runs on every managed server and continuously tails:
- App logs — stdout and stderr from your Node.js or worker process (via PM2)
- nginx access logs — incoming HTTP requests
- nginx error logs — nginx errors and upstream failures
Logs are forwarded in real time to the Sproobo log store and are accessible per site in the dashboard.
Viewing Logs
- 1
Navigate to a Site
In your dashboard, click on "Sites" and select the site you want to inspect. - 2
Open Logs
Click the "Logs" tab. You'll see a real-time log stream by default.View real-time logs for your site. - 3
Filter and Search
Use the controls to narrow down what you see:- Log source: App stdout, app stderr, nginx access, nginx error
- Log level: Error, warning, info, debug
- Time range: Last hour, 24 hours, 7 days, or custom range
- Search: Full-text search across log lines
- 4
Live Tail
Toggle "Live" mode to stream new log lines as they arrive, with sub-second latency.
Monitoring Metrics
Server metrics are collected by the Sproobo agent every 10 seconds and displayed in the server detail page.
Available Metrics
- CPU Usage: Utilisation percentage over time
- Memory Usage: RAM used vs. total
- Disk Usage: Used disk space and I/O throughput
- Network Traffic: Inbound and outbound bytes per second
To view metrics, go to Servers → select your server → Metrics tab.
Log Retention
Log retention depends on your subscription plan:
Retention by Plan
- Forge: 3 days of log history
- Orbit: 14 days of log history
- Apex: 30 days of log history
Logs older than your plan's retention window are automatically removed.