List logs
List logs matching the provided filters. Logs are paginated by start and end timestamps. There are more logs to fetch if hasMore is true in the response. Provide the nextStartTime and nextEndTime timestamps as the startTime and endTime query parameters to fetch the next page of logs.
You can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner.
Query parameters
The ID of the workspace to return logs for
Epoch/Unix timestamp of start of time range to return. Defaults to now() - 1 hour.
Epoch/Unix timestamp of end of time range to return. Defaults to now().
The direction to query logs for. Backward will return most recent logs first. Forward will start with the oldest logs in the time range.
Filter logs by their resource. A resource is the id of a server, cronjob, job, postgres, redis, or workflow.
Filter logs by the instance they were emitted from. An instance is the id of a specific running server.
Filter request logs by their host. Wildcards and regex are supported.
Filter request logs by their status code. Wildcards and regex are supported.
Filter request logs by their requests method. Wildcards and regex are supported.
Filter logs by their task(s)
Filter logs by their task run id(s)
Filter logs by their severity level. Wildcards and regex are supported.
Filter logs by their type. Types include app for application logs, request for request logs, and build for build logs. You can find the full set of types available for a query by using the GET /logs/values endpoint.
Filter by the text of the logs. Wildcards and regex are supported.
Filter request logs by their path. Wildcards and regex are supported.
Defaults to 20
The maximum number of items to return. For details, see Pagination.
Response
A collection of logs with pagination metadata