All 29 Sync & Health questions
More in Sync & Health
What does the diff view show and how do you use it? What does OutOfSync mean and what should you do about it? What is the Degraded health status? What is a dry-run sync? What is the difference between sync status and health status? What are sync options and give common examples? What is a selective sync and when is it useful? How do you configure automated sync with retry and backoff? What causes an Application to be perpetually OutOfSync and how do you fix it? How do notifications work for sync and health events?
Advertisement
ArgoCD › Sync & Health

How does ArgoCD determine the health of a resource?

Intermediate

Answer

ArgoCD has built-in health assessments for standard resources (Deployments ready replicas, Services, Ingress with load balancer, PVCs bound, etc.). For custom resources, it uses configurable Lua health check scripts. Health reflects operational readiness, distinct from whether the resource matches Git (sync).
# argocd-cm custom health for a CRD (Lua)
resource.customizations.health.example.com_MyKind: |
  hs = {}
  if obj.status.phase == "Running" then hs.status = "Healthy" end
  return hs
Real-world example A custom operator CRD gets a Lua health script so ArgoCD can report it Healthy only when its status is Ready.

Common follow-ups: Why do CRDs need custom health checks? | What determines Deployment health?

Applications Sync Waves & Hooks Sync & Health
All 29 Sync & Health questions