1 h 45 (S7.1 : 1 h · S7.2 : 45 min)
M06 terminé (flotte-web-dev en 6.16.0, auto-sync)
Hexa Mobilité veut savoir AVANT ses clients quand flotte-web va mal
Degraded ou en échec de synchronisation1 h
| Sync | Health | Situation | Premier réflexe |
|---|---|---|---|
Synced |
Healthy |
Nominal | — |
OutOfSync |
Healthy |
Git ≠ cluster, service rendu | argocd app diff |
Synced |
Degraded |
Git appliqué, application en panne | Événements, journaux |
OutOfSync |
Degraded / Missing |
Synchronisation en échec ou en cours | Message d'opération |
Progressing : changement en cours (pods en démarrage, rollout)| Ressource | Healthy si |
Degraded si |
|---|---|---|
| Deployment | Réplicas à jour et disponibles | progressDeadlineSeconds dépassé |
Service LoadBalancer |
IP ou nom attribué | — |
| Job (hook) | Terminé avec succès | Échec (backoffLimit atteint) |
| PersistentVolumeClaim | Bound |
Lost |
resource.customizations.health.<groupe>_<type>)progressDeadlineSeconds court en dev (60 s) = panne visible vite
flowchart LR A["app get<br/>statuts"] --> B["Opération<br/>conditions"] B --> C["Ressource<br/>en cause"] C --> D["Événements<br/>Kubernetes"] D --> E["Journaux<br/>des pods"] C --> F["app diff<br/>si OutOfSync"]
| Question | Commande |
|---|---|
| Quel état, quelle opération ? | argocd app get flotte-web-dev |
| Quelles ressources gérées, orphelines ? | argocd app resources flotte-web-dev |
| Quel écart avec Git ? | argocd app diff flotte-web-dev |
| Que dit Kubernetes ? | kubectl get events -n flotte-dev --sort-by=.lastTimestamp |
| Que disent les pods ? | argocd app logs flotte-web-dev --kind Deployment --name flotte-web |
argocd app logs : soumis au RBAC logs (3.x) ; audit-claire et dev-alice autoriséesSynced mais Degraded : Git est appliqué, l'image n'existe pasSync Status: Synced to main (fe0af9e)
Health Status: Degraded
apps Deployment flotte-dev flotte-web Synced Degraded
Deployment "flotte-web" exceeded its progress deadlineWarning Failed pod/flotte-web-7d6589d6d8-jkb58
Failed to pull image "ghcr.io/stefanprodan/podinfo:6.99.0": rpc error: code = NotFoundProgressing jusqu'à l'échéance, puis DegradedOutOfSync : la synchronisation échoue à chaque tentativeRunning | one or more synchronization tasks completed unsuccessfully,
reason: error when patching "/dev/shm/3761042127": Deployment.apps "flotte-web"
is invalid: spec.template.spec.containers: Required value.
Retrying attempt #4 at 2026-11-08T13:13:08Z.containers: mal orthographié (containerz:), champ inconnu ignoré, champ obligatoire absentchamp inconnu = ignoré sans erreur ; seule l'absence d'un champ requis se voit
| Symptôme | Cause probable |
|---|---|
ComparisonError : authentication required |
Jeton du dépôt expiré |
ComparisonError : app path does not exist |
Chemin renommé dans Git |
OutOfSync permanent sans changement Git |
Champ modifié par un contrôleur (ignoreDifferences) |
Progressing sans fin |
Sondes en échec, progressDeadlineSeconds long |
Opération Running bloquée |
Hook en attente ou en échec (terminate-op) |
45 min
Notification = Trigger (quand) + Template (quoi) + Service (où) + Abonnement (qui)flowchart LR App["Application<br/>flotte-web-dev"] --> Ctrl["notifications-<br/>controller"] Ctrl --> Trig["Trigger<br/>flotte-degraded"] Trig --> Tpl["Template<br/>flotte-webhook"] Tpl --> Svc["Service<br/>webhook, Slack, mail"]
argocd-notifications-cm, secrets dans argocd-notifications-secretservice.webhook.flotte-alertes: |
url: http://alertes-receiver.flotte-ops.svc.cluster.local/argocd
headers: [{name: Content-Type, value: application/json}]
template.flotte-webhook: |
webhook:
flotte-alertes:
method: POST
body: |
{"application": "{{.app.metadata.name}}",
"health": "{{.app.status.health.status}}"}{{.app.metadata.name}}, {{.app.status.sync.revision}}trigger.flotte-degraded: |
- when: app.status.health.status == 'Degraded'
send: [flotte-webhook]metadata:
annotations:
notifications.argoproj.io/subscribe.flotte-degraded.flotte-alertes: ""subscribe.<trigger>.<service>: "<destinataire>"oncePer: app.status.sync.revision : une notification par révisionsubscriptions)CAT=https://raw.githubusercontent.com/argoproj/argo-cd/v3.6.1/notifications_catalog
kubectl apply -n argocd -f $CAT/install.yamlon-created, on-deleted, on-deployed, on-health-degraded, on-sync-failed, on-sync-running, on-sync-status-unknown, on-sync-succeededargocd-notifications-cm : l'appliquer AVANT ses propres cléstrigger maison nommé comme un trigger du catalogue = écrasé
/metrics| Service | Port | Métriques clés |
|---|---|---|
argocd-metrics (contrôleur) |
8082 | argocd_app_info, argocd_app_sync_total |
argocd-server-metrics |
8083 | Requêtes API et gRPC |
argocd-repo-server |
8084 | Durée de rendu, requêtes Git |
argocd_app_info{name="flotte-web-dev",project="flotte",health_status="Healthy",
sync_status="Synced",autosync_enabled="true",phase="Succeeded"} 1argocd_app_sync_status et argocd_app_health_status supprimées → argocd_app_info| Besoin | Requête PromQL |
|---|---|
| Applications en panne | argocd_app_info{health_status="Degraded"} |
| Applications en écart | argocd_app_info{sync_status="OutOfSync"} |
| Échecs de sync (1 h) | sum by (name) (increase(argocd_app_sync_total{phase="Failed"}[1h])) |
| Clusters injoignables | argocd_cluster_connection_status == 0 |
examples/dashboard.json du dépôt Argo CDfor: 10m), pas un état transitoireapp get → message d'opération → ressource → événements → journauxargocd_app_info (3.x), argocd_app_sync_totalSynced et Degraded. Où chercher en priorité ?argocd app diffSynced : Git est appliqué ; la panne est à l'exécution (événements, journaux).Degraded pour ArgoCD ?progressDeadlineSeconds est dépassé sans progressionprogressDeadlineSeconds sans progresser : Degraded.containers: est écrit containerz: dans un Deployment. Quel est l'effet ?containers rend le manifeste invalide.argocd app logs <APP>argocd app history <APP>argocd app resources <APP>argocd repo logsargocd app logs lit les journaux via l'API ArgoCD (RBAC logs).argocd_app_health_status depuis ArgoCD 3.0 ?argocd_app_reconcileargocd_app_info (label health_status)argocd_cluster_infoargocd_app_sync_totalargocd_app_info et son label health_status.notifications.argoproj.io/subscribe.<trigger>.<service>notifications.argoproj.io/subscribe.<trigger>.<service>.