ContainerStatuses

ContainerStatuses is a field of the PodStatus in Kubernetes that describes the state of each container running in a pod. It consists of an array of ContainerStatus objects, with one entry for each container defined in the pod's specification. The kubelet populates this list and the API server exposes it as part of the pod’s status, helping clients observe the lifecycle of individual containers within a pod.

Each ContainerStatus includes several key fields. The name identifies the container by the name given in the pod spec. The state field represents the current runtime state of the container and is described by a ContainerState, which can be Running, Waiting, or Terminated; only one of these is non-nil at a time. The lastTerminationState records the state of the container when it last terminated, if it has terminated before, and is useful for diagnosing restarts. The ready flag indicates whether the container is ready to accept traffic. RestartCount tracks how many times the container has been restarted. The image field shows the container image name, while imageID contains the exact image identifier, including a digest if available. The containerID is the runtime container identifier (for example, docker://<id>); it may be empty if the container has not yet started.

ContainerState details further differentiate between Waiting, Running, and Terminated conditions, providing additional metadata such as reason, message, StartedAt, FinishedAt, and ExitCode. ContainerStatuses thus enable detailed per-container visibility within a pod’s overall status, supporting debugging, monitoring, and lifecycle management.