Sign in

v1

latestOpenAPI 3.1.02026-07-17254060.5 KB
logs

Get service logs

Successful fetch previously-written logs from the given services, or request logs from the given services and follows them, in JSON lines format.

Example:

{"time":"2024-12-31T02:11:09.361Z","service":"svc1","message":" * Serving Flask app 'main'"}
{"time":"2024-12-31T02:11:09.361Z","service":"svc1","message":" * Debug mode: off"}
{"time":"2024-12-31T02:11:09.382Z","service":"svc1","message":" * Running on http://127.0.0.1:5000"}
get/v1/logs

Query parameters

servicesstring

Service name to filter logs by.

To get logs from multiple services, specify this parameter multiple times.

If not set, returns logs for all services.

follow'true' | 'false'

Whether to follow the logs (keep streaming new logs).

ninteger

Number of log entries to retrieve.

If follow is true, n is ignored.

If follow is false:

  • If n is -1, all available logs are returned (up to a server-defined limit).
  • If n is 0 or not specified, a server-defined default number of logs is returned. The default is currently 30.
  • If n is a positive integer, up to that many logs are returned.

Response

Service logs in JSON lines format.