Logs
The host's journal.
| Operation | Kind | HTTP |
|---|---|---|
logs.read | call | GET /v1/logs |
logs.follow | stream | GET /v1/logs |
logs.read
Journal entries.
Host level only. Through rookery serve it needs the role view.
Arguments
| Name | Where | Required | Description |
|---|---|---|---|
unit | query | no | Only this unit. |
since | query | no | A cursor from an earlier entry, or a time. |
limit | query | no | Most entries; default 100. |
Result
LogEntry[]
{
"id": 1,
"op": "logs.read",
"args": {
"since": "VALUE"
}
}{
"id": 1,
"result": [
{
"cursor": "s=4f2a…",
"message": "text",
"priority": 0,
"time": "2026-11-12T09:30:00Z",
"unit": "rookeryd.service"
}
]
}logs.follow
Journal entries, then what is logged.
Host level only. A stream, as a subscription on the portal or a WebSocket of its own. It resumes from since. Through rookery serve it needs the role view.
Arguments
| Name | Where | Required | Description |
|---|---|---|---|
unit | query | no | Only this unit. |
since | query | no | A cursor from an earlier entry, or a time journalctl understands. |
Frames from the server
| Frame | Kind | Description |
|---|---|---|
entry | JSON | One journal entry. Example: {"cursor":"s=…","message":"Server listening on 0.0.0.0 port 22.","priority":6,"time":"2026-11-12T10:00:00Z","unit":"ssh.service"} |
{
"id": 1,
"op": "logs.follow",
"args": {
"since": "VALUE"
}
}{
"id": 1,
"result": {
"open": true
}
}
{
"sub": 1,
"data": {
"cursor": "s=…",
"message": "Server listening on 0.0.0.0 port 22.",
"priority": 6,
"time": "2026-11-12T10:00:00Z",
"unit": "ssh.service"
}
}End the subscription with {"sub": 1, "end": true}.
Types
The named types used on this page.
LogEntry
| Field | Type | Description |
|---|---|---|
cursor | string | Give it back as since to go on from here. |
message | string | |
priority | integer | |
time | string | |
unit | string |