TOtower

Describe run logs

Changed on

Retrieves the logs associated with a particular run of an app.

get/apps/{name}/runs/{seq}/logs

Request

Path parameters

namestring required

The name of the app to get logs for.

seqinteger required

The sequence number of the run to get logs for.

Query parameters

start_atstring date-time

Deprecated: use attempt and offset to page through a run's logs. Fetch logs from this timestamp onwards (inclusive).

headinteger

Return only the first N log lines. Cannot be combined with tail.

tailinteger

Return only the last N log lines. Cannot be combined with head.

attemptinteger

Return only this attempt's log lines. Defaults to the run's latest attempt when offset is passed, including offset=0.

offsetinteger

Return the attempt's log lines from this line number onwards (inclusive). Line numbers start at 0 in each attempt. To page through an attempt, combine with head and pass the last returned line_num + 1.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/DescribeRunLogsResponse.json"
}

Changes

  • 3a048de275ceRevision changes
    • info

      added the new optional query request parameter attempt

    • info

      added the new optional query request parameter offset