liveBook · Manning

Audit trail

As explained in Kargo in Action

An audit trail is a chronological record of actions, decisions, identities, and evidence that permits operational activity to be verified.

A delivery audit trail makes each advancement of an artifact verifiable. Kargo persists each Promotion as a queryable Kubernetes resource, rather than leaving teams to reconstruct advancement from scripts or tribal knowledge. section 1.0 section 3.2.4

A Promotion records:

  • The Stage and Freight being advanced. section 3.2.4
  • Its phase, timestamps, and freight collection, which show what was promoted, when, and how long it took. section 3.2.4
  • The results of promotion-template steps, including command output and errors. section 3.2.4

Verify an advancement

After a Promotion completes, inspect its status to confirm the outcome and timing and identify the Freight. If it failed, kubectl describe promotion <name> shows which step failed and what it produced. section 3.2.4

Listing 3.5 The same Promotion after it has run to completion
apiVersion: kargo.akuity.io/v1alpha1
kind: Promotion
metadata:
  name: dev-x7g2k                                     # #1
  namespace: demo
spec:
  stage: dev
  freight: 7b2f9a8e3c1d5f4a6b8e9c0d2f1a5b7c
status:
  phase: Succeeded                                    # #2
  startTime: "2026-05-25T14:22:01Z"                   # #3
  finishTime: "2026-05-25T14:22:28Z"
  freightCollection:                                  # #4
    freight:
      demo-app:
        name: 7b2f9a8e3c1d5f4a6b8e9c0d2f1a5b7c

A completed Promotion manifest shows the recorded phase, timestamps, and Freight collection. section 3.2.4

How Kargo in Action covers it

How deep it goes
Explains the Promotion resource, its status fields, and step-level failure evidence.
Examples
Uses a completed dev Promotion to show its Freight, phase, and timestamps.
What you can do after
Diagnose promotion failures by inspecting step results with kubectl describe promotion.
How it connects
Links promotion to CI, CD, Kubernetes resources, and GitOps agents.

Also explained in

Compare how 5 books explain audit trail →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Kargo in Action. The section links point to the parts of the book it draws on.