DAdagucloud
dag-runs

Summarize DAG-run activity

Changed on

Lists the DAG-runs created in a time window, newest first, one page at a time. The first page also lists the DAGs whose latest run did not succeed, runs still in progress (including ones created before the window), queues with work, and the next scheduled runs. Without fromDate, the window is the last hours hours, aligned to a 96th of its length. To load older runs, pass the first page's from and to as fromDate and toDate, with nextCursor as cursor.

get/dag-run-activity

Request

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

Query parameters

remoteNodestring

name of the remote node

workspacestring

Workspace selector. For list and search APIs, use all, default, or a workspace name. Omitted means all.

fromDateinteger

Unix timestamp in seconds

Example:1672531199

start of the time range for filtering DAG-runs, as a Unix timestamp in seconds

toDateinteger

Unix timestamp in seconds

Example:1672531199

end of the time range for filtering DAG-runs, as a Unix timestamp in seconds

hoursinteger

Length of a window that ends now. Ignored when fromDate is set.

labelsstring

Only include runs of DAGs that have ALL these comma-separated labels

cursorstring

Opaque cursor for loading the next page of older DAG-runs

Response

A successful response

frominteger required

Window start as Unix seconds

tointeger required

Window end as Unix seconds

nextCursorstring

Opaque cursor for loading the next page of older runs

diskUsedPercentinteger

First page only: how full the data directory's disk is, in percent; set only when it is at least 90 and the caller may view system status

Changes

  • v1c265ee525530Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

  • v13f0be38e8956Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property to the response with the status