04 - Debug et analyse d erreur#

CONTEXTE
- Projet : [NOM_ET_ROLE_DU_PROJET_EN_UNE_PHRASE]
- Fichier concerne : @[CHEMIN/DU/FICHIER]
- Commande qui declenche le probleme : [COMMANDE_EXACTE]
- Environnement : [LOCAL / CI / PROD], [OS], [VERSION_LANGAGE], [VERSIONS_LIBS_CLES]
- Frequence : [SYSTEMATIQUE / INTERMITTENT / DEPUIS_TEL_CHANGEMENT]

CE QUE J ATTENDS
[DECRIS_LE_RESULTAT_ATTENDU_AVEC_UNE_VALEUR_CONCRETE]

CE QUE J OBTIENS
[COLLE_LA_SORTIE_OU_LA_STACK_TRACE_COMPLETE]

CE QUE J AI DEJA ESSAYE
1. [ESSAI_1] -> [RESULTAT]
2. [ESSAI_2] -> [RESULTAT]

CE QUE JE VEUX DE TOI
1. Les 3 causes les plus probables, classees par probabilite
2. Pour chacune : comment la confirmer ou l ecarter en une commande
3. Seulement apres, le correctif de la cause retenue
4. Attaque la cause racine, ne masque pas l erreur

Ne devine pas le contenu des fichiers : ouvre-les avant de repondre.

mon dag airflow plante, tu peux regarder ?

CONTEXTE
- Projet : pipeline d ingestion des commandes, Airflow 2.9, Python 3.11
- Fichier : @dags/ingest_orders.py
- Commande : airflow dags test ingest_orders 2026-09-20
- Environnement : prod, executor Celery, 4 workers
- Frequence : environ 1 run sur 5, toujours sur la tache load_to_postgres

CE QUE J ATTENDS
La tache load_to_postgres ecrit environ 120 000 lignes dans staging.orders
et se termine en success.

CE QUE J OBTIENS
[stack trace complete collee ici]
psycopg2.errors.UniqueViolation: duplicate key value violates unique
constraint "orders_pkey"
DETAIL:  Key (order_id)=(A-99182) already exists.

CE QUE J AI DEJA ESSAYE
1. Augmente le timeout de la tache -> aucun effet
2. Relance manuelle du meme run -> passe une fois sur deux
3. Verifie que l API source ne renvoie pas de doublons -> elle n en renvoie pas

CE QUE JE VEUX DE TOI
1. Les 3 causes les plus probables, classees par probabilite
2. Pour chacune, la requete SQL ou la commande qui permet de trancher
3. Seulement apres, le correctif de la cause retenue
4. Attaque la cause racine ; ne me propose pas un ON CONFLICT DO NOTHING
   comme solution definitive sans m expliquer ce qu on masque

Voici une stack trace. Analyse-la en 5 points :

1. La ligne EXACTE de MON code qui declenche l erreur (ignore les frames
   des librairies, sauf si le bug vient d un mauvais usage de l API)
2. Ce que signifie ce type d exception, en une phrase simple
3. Les valeurs qui devaient etre presentes a ce moment-la et qui ne l etaient
   probablement pas
4. Les 3 causes possibles, classees par probabilite
5. Pour chaque cause : la ligne de log ou l assertion a ajouter pour trancher

Ne propose pas encore de correctif.

STACK TRACE :
[COLLE_LA_STACK_TRACE_COMPLETE_SANS_LA_TRONQUER]

FICHIER CONCERNE : @[CHEMIN/DU/FICHIER]

# Garder seulement les erreurs et 5 lignes de contexte autour
grep -n -A 5 -B 5 -i "error\|exception\|traceback" app.log > extrait.log

# Compter les types d erreurs pour voir laquelle domine
grep -o "[A-Za-z]*Error" app.log | sort | uniq -c | sort -rn | head -20

# Isoler une fenetre de temps
sed -n '/2026-09-20 14:3/,/2026-09-20 14:4/p' app.log > fenetre.log

cat error.log | claude

claude -p "Analyze this log file" --output-format stream-json --verbose

Utilise un sous-agent pour analyser @[CHEMIN/DU/LOG]. Il doit me renvoyer
uniquement :
- le nombre d occurrences de chaque type d erreur
- la premiere et la derniere occurrence de l erreur [NOM_DE_L_ERREUR]
- les 10 lignes qui precedent la premiere occurrence
- une hypothese sur l evenement declencheur
Pas de log brut dans la reponse.

Log : @[CHEMIN/DU/LOG] (environ [NOMBRE] lignes)
Incident : [CE_QUI_S_EST_PASSE] le [DATE] vers [HEURE]

Analyse-le et renvoie UNIQUEMENT :
1. Une chronologie de l incident, heure par heure, en 10 lignes maximum
2. Le premier evenement anormal, avec son horodatage exact
3. Les erreurs en cascade qui en decoulent (distingue cause et consequence)
4. Ce qui se passait juste AVANT le premier evenement anormal
5. Les 3 hypotheses de cause racine, classees

Ne recopie pas de longs extraits de log : cite l horodatage et 1 ligne.

Bug intermittent : [DECRIS_LE_SYMPTOME]
Frequence observee : [X] fois sur [Y] executions
Ce qui est identique a chaque execution : [CODE / DONNEES / COMMANDE]
Ce qui varie : [HEURE / VOLUME / WORKER / ORDRE DES DONNEES / RIEN_DE_CONNU]
Fichier : @[CHEMIN]

Passe en revue, une par une, ces familles de causes, et dis pour chacune si
elle est plausible ici et comment la tester :

1. CONCURRENCE : deux processus qui ecrivent au meme endroit, verrou manquant
2. ORDRE NON DETERMINISTE : dictionnaire, set, resultat SQL sans ORDER BY,
   parallelisme
3. TEMPS : fuseau horaire, changement d heure, minuit, fin de mois, timeout
4. ETAT RESIDUEL : cache, fichier temporaire, connexion reutilisee, variable
   globale
5. REJEU PARTIEL : retry qui reprend une operation deja a moitie faite
6. DONNEES : une valeur rare dans le jeu de donnees (NULL, accent, valeur
   negative, chaine vide, doublon)
7. RESSOURCES : memoire, descripteurs de fichiers, pool de connexions sature

Termine par : le test ou le log a ajouter pour capturer l information
manquante au prochain incident.

Ne corrige rien encore. Propose-moi 3 facons differentes de regler
[LE_PROBLEME], avec pour chacune :
- en quoi elle consiste, en 2 lignes
- ce qu elle coute (complexite, performance, risque de regression)
- dans quel cas elle est le bon choix
Puis recommande-en une et explique pourquoi.

Applique l option [NUMERO]. Puis lance [COMMANDE_DE_TEST] et corrige jusqu a
ce que ca passe. Montre-moi la sortie de la commande, pas un resume.