Skip to content

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. 1

    Navigate to a Site

    In your dashboard, click on "Sites" and select the site you want to inspect.
  2. 2

    Open Logs

    Click the "Logs" tab. You'll see a real-time log stream by default.
    Sproobo logs viewer
    View real-time logs for your site.
  3. 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. 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.

Next Steps