Skip to main content
GET
/
v2
/
nodes
/
{id}
/
logs
Get node logs
curl --request GET \
  --url https://api.sfcompute.com/v2/nodes/{id}/logs \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "timestamp_realtime": 1738972800,
      "timestamp_monotonic_secs": 123,
      "timestamp_monotonic_nanos": 1,
      "seqnum": 1,
      "data": "SGVsbG8gV29ybGQK"
    }
  ]
}

Authorizations

Authorization
string
header
required

Create an API token using sf tokens create or at https://sfcompute.com/account/api-keys.

Path Parameters

id
string
required

A resource path like 'sfc:node:acme:prod:my-node' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.

Pattern: (node_[0-9a-zA-Z_-]{1,21})|(sfc:node:[a-zA-Z0-9._-]+(:[a-zA-Z0-9._-]+){1,3})
Example:

"node_k3R-nX9vLm7Qp2Yw5Jd8F"

Query Parameters

seqnum_before
integer<u-int64>

Return logs with seqnum less than or equal to this value.

Required range: x >= 0
seqnum_after
integer<u-int64>

Return logs with seqnum greater than or equal to this value.

Required range: x >= 0
realtime_timestamp_before
integer<int64>

Due to clock synchronization, some earlier log messages may have a realtime timestamp after this value. Unix timestamp.

Example:

1738972800

realtime_timestamp_after
integer<int64>

Due to clock synchronization, some later log messages may have a realtime timestamp before this value. Unix timestamp.

Example:

1738972800

sort_by
enum<string>
Available options:
seqnum,
-seqnum
limit
integer<u-int64>
default:100
Required range: 1 <= x <= 2500

Response

Log chunks.

object
string
default:list
required
read-only
Allowed value: "list"
data
object[]
required