Execution Statuses

Every report run passes through a sequence of statuses. The status reflects the current state of the execution process — from being queued to the final result.

Full list of statuses

Draft

The report has just been created and has never been run. The configuration is saved, but no execution has taken place. The run list is empty.

Pending

The run has been queued and is waiting for resources to free up. Possible reasons for waiting: other reports are running (parallel-run limit), waiting for the connection to become available, scheduler delay (up to 60 seconds). The Pending status usually doesn't last longer than 2-3 minutes.

Running

The report is active: data is being extracted from the source, processed, and written to the output sheet.

Execution stages:

1. Fetch — requesting data from the source API
2. Transform — processing, filtering, sorting
3. Load — writing to the output sheet
4. Finalize — finalization, metadata updates

Completed

The report ran without errors. All data was extracted and written. This is the target status for working reports. Signs of Completed: all requested rows were written, there are no warnings (or they aren't critical), the output sheet contains up-to-date data.

Partial

The report finished with part of the data. Some metrics or rows may have failed to load. Typical causes: partial unavailability of the source API, a timeout while fetching part of the data, some metrics not being supported for the selected entity, the row limit being exceeded so data was truncated. The logs of a Partial run always include warnings describing which data wasn't received.

Failed

The report finished with an error. Data wasn't written, or was written only partially. Typical causes: authentication error (expired token), source API unavailability (503, timeout), invalid configuration (incompatible metrics/dimensions), an error writing to the output sheet (no permissions, sheet deleted), an internal data-processing error. The logs of a Failed run contain the error stack for diagnostics.

Cancelled

The run was manually cancelled by the user before completion. Partially written data may remain in the output sheet (depends on the write mode). Cancellation is only possible at the Pending and Running stages. A completed run (Completed, Partial, Failed) cannot be cancelled.

Status transition diagram

Draft --> Pending --> Running --> Completed
                       |    |--> Partial
                       |    |--> Failed
                       |--> Cancelled

How to verify

• Open the report page > the Execution tab
• The current status is shown with a color indicator:
  • Gray — Draft, Cancelled
  • Blue — Pending
  • Orange — Running
  • Green — Completed
  • Yellow — Partial
  • Red — Failed
• Click a run to view details and logs

Related articles

• Manual Run — how to run
• Automatic Runs — automatic runs
• Progress — tracking stages
• Cancelling a Run — how to cancel
• Run History — analyzing statuses