Get service logs

GET/projects/{project_id}/services/{service_id}/logs

Fetch logs for a specific service. Returns up to 500 log entries in reverse chronological order. Supports cursor-based pagination via the cursor parameter and the lastCursor field in the response.

Recommended pagination: omit page (or pass page=0) and use the returned lastCursor value as the cursor parameter on subsequent requests to page through all available logs without hitting any result-window limits.

Legacy pagination: passing page > 0 without a cursor uses the older offset-based approach, which is limited to the first 10,000 log entries.

Path ParametersExpand Collapse

project_id: string

service_id: string

Query ParametersExpand Collapse

cursor: optional string

Opaque pagination cursor returned as lastCursor in a previous response. When provided, returns the next page of logs older than the cursor position. Takes precedence over the page parameter.

node: optional number

Specific service node to fetch logs from (for multi-node services).

page: optional number

Page number for pagination (0-based). When omitted or set to 0, cursor-based pagination is used automatically. Values greater than 0 use the legacy offset path (deprecated; prefer cursor pagination).

search: optional array of string

Full-text search terms to filter log lines. Repeat the parameter for multiple values (e.g. ?search=slow+query&search=ERROR). Only applies when using cursor-based pagination (page=0 or cursor provided).

severities: optional array of string

Severity levels to filter results. Repeat the parameter for multiple values (e.g. ?severities=ERROR&severities=WARNING). Only applies when using cursor-based pagination (page=0 or cursor provided).

since: optional string

Lower bound timestamp — fetch logs after this time (RFC3339 format). Only applies when using cursor-based pagination (page=0 or cursor provided).

formatdate-time

until: optional string

Upper bound timestamp — fetch logs before this time (RFC3339 format, e.g., 2024-01-15T10:00:00Z).

formatdate-time

ReturnsExpand Collapse

logs: array of string

Array of log message strings. Preserved for backwards compatibility.

entries: optional array of object { message, severity, timestamp }

Structured log entries with timestamp and severity metadata. Only present on the cursor-based path (page=0 or cursor provided). Entries are in the same order as logs and can be used in place of it by callers that need structured data.

message: string

Log message text.

severity: string

PostgreSQL severity level (e.g. LOG, WARNING, ERROR, FATAL).

timestamp: string

Timestamp of the log entry (RFC3339 format).

formatdate-time

lastCursor: optional string

Opaque cursor for the next page of results. Present when more log entries exist older than the last entry in this response. Pass this value as the cursor query parameter to retrieve the next page. Absent when there are no further results.

Get service logs

curl https://console.cloud.tigerdata.com/public/api/v1/projects/$PROJECT_ID/services/$SERVICE_ID/logs \
    -H "Authorization: Bearer $TIGER_CLOUD_API_KEY"

{
  "logs": [
    "string"
  ],
  "entries": [
    {
      "message": "database system is ready to accept connections",
      "severity": "LOG",
      "timestamp": "2025-01-15T09:30:00Z"
    }
  ],
  "lastCursor": "eyJ0cyI6IjIwMjUtMDEtMTVUMDk6MzA6MDBaIn0="
}

Returns Examples

{
  "logs": [
    "string"
  ],
  "entries": [
    {
      "message": "database system is ready to accept connections",
      "severity": "LOG",
      "timestamp": "2025-01-15T09:30:00Z"
    }
  ],
  "lastCursor": "eyJ0cyI6IjIwMjUtMDEtMTVUMDk6MzA6MDBaIn0="
}