curl
curl -sS "https://gateway.orbit/api/v1/agent/log-streams" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81'
{
"data": [
{
"id": "<string>",
"lines": 500,
"source": {
"type": "laravel",
"path": "<string>",
"unit": "<string>",
"container": "<string>",
"process_id": 123
}
}
],
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Node callbacks
List the live log streams the agent reads
The orbit-agent on a managed Node calls this endpoint to learn which logs to read for live log streams: when it joins its log channel, after each log-streams.changed event, and every 15 seconds while it reads a stream. The Gateway identifies the Node from the WireGuard address and the agent’s bearer secret, and lists at most 16 open streams whose source is on that Node, each with its ID, lines, and one laravel, journal, or docker source that the Gateway resolved from its own records.
GET
/
api
/
v1
/
agent
/
log-streams
curl
curl -sS "https://gateway.orbit/api/v1/agent/log-streams" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81'
{
"data": [
{
"id": "<string>",
"lines": 500,
"source": {
"type": "laravel",
"path": "<string>",
"unit": "<string>",
"container": "<string>",
"process_id": 123
}
}
],
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}