Run history and failures

Run Library retains the operational record for Terraform actions. Use it to understand status and evidence, not as a place to copy raw customer infrastructure into support notes.

Typical time

5–20 minutes

You need

Project access

Outcome

A diagnosed or retained run

Step 1: Filter Run Library

Use project, workspace, environment, type, status, date range, search, and cursor pagination. Summary cards show total, successful, failed, pending, and approval context for the selected project.

History 1 of 5 · Find the relevant Terraform runShow project-scoped filters and a synthetic page of Run Library.

Step 2: Read status and timeline

Open View details and confirm created, started, current/terminal state, duration, actor, runner profile, and parent run.

Active states include QUEUED, STARTING, RUNNING, and CANCEL_REQUESTED. Terminal states include SUCCEEDED, FAILED, LAUNCH_FAILED, STALE_FAILED, TIMED_OUT, and canceled variants.

History 2 of 5 · Read run status and timelineShow a synthetic failed run with safe timeline, stage, and user-facing summary.

Step 3: Inspect the relevant evidence

Depending on action, open:

• plan summary and resource filters;
• resource map and exact resource log filter;
• policy scan and OPA result;
• Review Request and guardrails;
• cost estimate;
• safe logs and step summaries; and
• safe JSON or downloadable safe logs where permitted.

Use the smallest evidence necessary for diagnosis. Never export Terraform state or sensitive plan data.

History 3 of 5 · Inspect safe run evidenceShow a synthetic resource map with generic mapped and unmapped entries.

Step 4: Recover safely

• Re-run repeats an allowed action with a new idempotent run.
• Cancel run requests cancellation for an active cancellable run.
• Fix source or workspace configuration first when the failure will repeat.
• Save a new revision and run a new plan when code changed.
• Recreate review and approval when plan evidence changed.

History 4 of 5 · Choose re-run or cancelShow a synthetic running-run menu before any re-run or cancellation is submitted.

Step 5: Archive or remove from normal history

Archive run removes the run from the active view according to allowed actions. Delete run removes it from normal Terraform run history after a confirmation.

Deleting a run does not delete Terraform state, cloud resources, audit records, or governed evidence. Specifically, the retained boundary covers:

• Terraform workspace files;
• Terraform state;
• cloud resources;
• audit records;
• provider connections;
• policy evidence; or
• cost evidence.

The action cannot be used to erase governed apply evidence.

History 5 of 5 · Review the non-destructive history confirmationShow the synthetic confirmation only; deletion was not submitted for this capture.

Check your result

Record the run’s terminal status, safe error code or summary, corrected cause, and whether a new revision, plan, review, or apply was required. Preserve the authoritative audit and evidence chain.

Common blockers

Re-run is unavailable

The backend action state does not allow rerun for this run or caller. Create the appropriate new action from the latest saved revision.

Resource map is unavailable

The run type, status, mapping data, or retained artifact may not support it. Use the safe run summary and logs without inferring missing resource evidence.

Deleting a run did not delete infrastructure

That is intentional. History deletion is not a Terraform destroy operation and never removes state or cloud resources.

Raw logs contain sensitive material

Do not paste them into documentation or tickets. Use bounded safe summaries and follow the approved incident process.