Logs
The logs operations of the v1 API.
Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Cursor paginated: pass next_cursor back as cursor until it is null. While the build runs, has_more stays true and the cursor can be polled for new lines. Build log lines carry no timestamps.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidapp_id*stringThe application UUID
uuidbuild_id*stringThe build UUID
uuidcursor?|next_cursor of the previous page.
limit?|Lines per page, 1 to 5000 (default 500).
uint320 <= valueA page of build log lines
application/json- response
A page of a build's log lines, in order.
complete*booleanThe build has ended, so its log is final.
data*array<string>Complete lines, in order. A running build's unfinished last line is held back.
has_more*booleanMore lines follow, or the build is still running (poll next_cursor).
next_cursor?|Pass as cursor for the next page; null once the log is fully read.
curl 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/apps/00000000-0000-4000-8000-000000000002/builds/00000000-0000-4000-8000-000000000003/logs' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "complete": true, "data": [ "string" ], "has_more": true, "next_cursor": "string"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Cursor paginated: pass next_cursor back as cursor, with the same since and until, until has_more is false. Lines are kept for the cluster's log retention. There is no live tail on this API.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidapp_id*stringThe application UUID
uuidcursor?|next_cursor of the previous page.
limit?|Lines per page, 1 to 1000 (default 100).
uint320 <= valuepod?|Only lines of this pod.
since?|Start of the range (RFC 3339, inclusive). Default: an hour before until.
date-timeuntil?|End of the range (RFC 3339, exclusive). Default: now. Pass it when paging, so every page reads the same range. At most 31 days after since.
date-timeA page of log lines
application/json- response
A page of an app's log lines, oldest first.
data*array<>The lines, oldest first.
has_more*booleanMore lines in the range follow this page.
next_cursor?|Pass as cursor (with the same range) for the next page; null on the last page.
retained_from?|Lines older than this were removed (by ingest time, so approximate); null when the app lost none.
date-timeretained_reason?||Why lines before retained_from are gone; null with it.
curl 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/apps/00000000-0000-4000-8000-000000000002/logs' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "data": [ { "container": "string", "message": "string", "pod": "string", "severity": "string", "timestamp": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string", "retained_from": "2019-08-24T14:15:22Z", "retained_reason": "size"}