flux trace

flux trace

trace an in-cluster object throughout the GitOps delivery pipeline


The trace command shows how an object is managed by Flux, from which source and revision it comes, and what’s the latest reconciliation status.'

flux trace [name] [flags]


  # Trace a Kubernetes Deployment
  flux trace my-app --kind=deployment --api-version=apps/v1 --namespace=apps

  # Trace a Kubernetes Pod
  flux trace redis-master-0 --kind=pod --api-version=v1 -n redis

  # Trace a Kubernetes global object
  flux trace redis --kind=namespace --api-version=v1

  # Trace a Kubernetes custom resource
  flux trace redis --kind=helmrelease --api-version=helm.toolkit.fluxcd.io/v2beta1 -n redis


      --api-version string   the Kubernetes object API version, e.g. 'apps/v1'
  -h, --help                 help for trace
      --kind string          the Kubernetes object kind, e.g. Deployment'

Options inherited from parent commands

      --context string      kubernetes context to use
      --kubeconfig string   absolute path to the kubeconfig file
  -n, --namespace string    the namespace scope for this operation (default "flux-system")
      --timeout duration    timeout for this operation (default 5m0s)
      --verbose             print generated objects


  • flux - Command line utility for assembling Kubernetes CD pipelines