Course contentsShow
← Cloud and Infrastructure
Lesson 1900 of 2,98940. ArgoCDFree lesson

Health Assessment

Configuring custom health checks and understanding built-in resource health logic.

Health Assessment

What you'll learn: How ArgoCD determines whether your deployed Kubernetes resources are truly healthy and ready for use.

The Problem with Basic Sync Status

Just because ArgoCD successfully applies your manifests doesn't mean your application is working. A Deployment might sync perfectly but have zero ready pods. ArgoCD's health assessment goes beyond sync status to check if resources are actually functioning.

Built-In Health Logic

ArgoCD includes intelligent health checks for common Kubernetes resources:

  • Deployments: Checks if desired replicas match available replicas
  • StatefulSets: Verifies ordered pod readiness
  • Services: Ensures endpoints exist
  • Ingress: Confirms rules are configured
  • PersistentVolumeClaims: Validates binding status

Each resource type has specific criteria. A Deployment isn't "Healthy" until status.availableReplicas equals spec.replicas and all pods pass readiness probes.

Health States

ArgoCD reports these health states:

  • Healthy: Resource is ready and functioning
  • Progressing: In transition (e.g., rolling update)
  • Degraded: Running but impaired (some pods down)
  • Suspended: Intentionally paused
  • Missing: Expected but not found
  • Unknown: Health cannot be determined

Custom Health Checks

For custom resources or special logic, you configure custom health assessments in ArgoCD's ConfigMap. This uses Lua scripts to define your own health logic based on resource status fields.

Think of it like a doctor's examination: sync status confirms the prescription was filled, but health assessment checks if the medicine is actually working.

Key Takeaway:
ArgoCD's health assessment evaluates whether synced resources are genuinely operational, using built-in logic for standard Kubernetes resources and supporting custom health checks for specialized workloads.