HelipodDocs

Logs and metrics

What a running service prints, and how much CPU, memory and network it uses.

Runtime logs

GET/containers/services/{serviceId}/logs
Recent output of the running service, newest first.
Query
sinceHow far back: 15m, 1h, 6h, 1d ... (default 1h; limited by your plan's log retention)
filterOnly lines containing this text (up to 200 characters)
limit1 to 1000 lines (default 200)
curl "https://api.helipod.io/api/containers/services/$SERVICE/logs?since=30m&filter=error&limit=100" \
  -H "Authorization: Bearer hel_your_key"
{
  "success": true,
  "data": [
    { "time": "2026-10-16T09:31:12.481Z", "replica": 1, "stream": "stderr", "message": "Error: connect ECONNREFUSED" },
    { "time": "2026-10-16T09:31:10.002Z", "replica": 2, "stream": "stdout", "message": "GET /health 200 2ms" }
  ]
}

replica numbers the copies of the service (1, 2, ...) within the response.

Metrics

GET/containers/services/{serviceId}/metrics
CPU, memory and network over time, plus current values.

since: 5m, 15m, 30m, 1h (default), 3h, 6h, 1d or 7d.

{
  "success": true,
  "data": {
    "cpu": { "unit": "cores", "points": [[1760605800000, 0.031], [1760605860000, 0.042]] },
    "memory": { "unit": "MB", "points": [[1760605800000, 182.4], [1760605860000, 185.1]] },
    "networkIn": { "unit": "KB/s", "points": [[1760605800000, 3.2]] },
    "networkOut": { "unit": "KB/s", "points": [[1760605800000, 12.8]] },
    "current": { "cpuCores": 0.042, "memoryMb": 185.1, "memoryLimitMb": 512, "restarts": 0, "uptimeSeconds": 86400 }
  }
}

Each point is [timestamp in milliseconds, value].

On this page