Metrics & Logs

Runsite collects resource and request metrics for every service, plus full container logs that you can pull on demand or stream live.

Web service metrics

Current metrics

GET /api/metrics?web_service_id={web_service_id}

Returns current CPU, memory and network usage for the service.

Metrics history

GET /api/metrics/history?web_service_id={web_service_id}&period=3600

Parameter	Type	Default	Description
period	int	3600	Time range in seconds (60–7200)

Application (request) metrics

GET /api/metrics/requests?period=3600

Returns HTTP request count, error rate and response time percentiles.

Parameter	Type	Default	Description
period	int	3600	Time range in seconds (60–86400)

Database metrics

Each managed database exposes the same metrics interface.

PostgreSQL

• GET /api/databases/{database_id}/metrics — current metrics
• GET /api/databases/{database_id}/metrics/history — historical metrics
• GET /api/databases/{database_id}/logs — server logs
• WS /api/databases/{database_id}/logs/stream — real-time log streaming

Redis

• GET /api/redis/{redis_id}/metrics — current metrics
• GET /api/redis/{redis_id}/metrics/history — historical metrics
• GET /api/redis/{redis_id}/logs — server logs
• WS /api/redis/{redis_id}/logs/stream — real-time log streaming

Log parameters

Parameter	Type	Default	Description
tail	int	100	Number of log lines (1–10000)
since	int	—	Time range in seconds (60–86400)

Streaming logs

Open a WebSocket to stream logs live from a running container or database. The connection sends a JSON message per log line:

{ "timestamp": "2026-04-30T10:00:00Z", "level": "info", "message": "..." }

Send a ping message every 30 seconds to keep the connection alive.