DAdagucloud
dag-runs

Retrieve log for a specific step in a DAG-run

Changed on

Fetches the log for an individual step in a DAG-run

get/dag-runs/{name}/{dagRunId}/steps/{stepName}/log

Request

  • Base URL
    http://localhost/api/v1
  • Auth
    • HTTP bearer
    • or HTTP basic
    • or none

Path parameters

namestring regex required

Name of the DAG

name of the DAG

dagRunIdstring required

Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.

Example:latest

ID of the DAG-run or 'latest' to get the most recent DAG-run

stepNamestring required

name of the step

Query parameters

remoteNodestring

name of the remote node

tailinteger

Number of lines to return from the end of the file

headinteger

Number of lines to return from the beginning of the file

offsetinteger

Line number to start reading from (1-based)

limitinteger

Maximum number of lines to return

stream'stdout' | 'stderr' string

Whether to return stdout or stderr logs

Response

A successful response

contentstring required

Log content

lineCountinteger

Number of lines returned

totalLinesinteger

Total number of lines in the log file

hasMoreboolean

Whether there are more lines available

isEstimateboolean

Whether the line count is an estimate

Changes

  • v1c87bb3f91e6eRevision changes
    • warning

      for the query request parameter head, the max was set to 10000.00

    • warning

      for the query request parameter tail, the max was set to 10000.00

  • v175b8e91aaf57Revision changes
    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new human_task_resume_failed enum value to the response property for the response status

    • warning

      added the new human_task_resume_failed enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status