Dépannage
Commencez par identifier la couche concernée : navigateur, API, pipeline, intégration, découpage ou emails. Conservez l'erreur exacte et l'identité typée avant toute modification de données.
Symptômes courants
| Symptôme | Vérifications |
|---|---|
| Aucune emprise ou aucun travail visible | Attributions, groupes métier, changements surveillés, filtres et zoom |
| Compteur supérieur à la carte/l'arbre | Limite détaillée, vue courante et recouvrements de groupes/règles |
| Heatmap vide | Résultat réseau/API, filtres et console ; CSP déployée si un worker est bloqué |
| Fond absent | URL/capacités, HTTPS, droits, projection et composition active |
| Suivi des vérifications indisponible | Erreur API et version SQL ; ne pas forcer la décision en base |
| Objet approuvé absent du référentiel | Racines/blocages et dernière exécution confirmée |
| Lot préparé mais service en échec | Erreur standard de l'exécuteur et résultat ; préparation ne signifie pas contrôle final réussi |
| Référentiel récent mais tronçons anciens | Activation du découpage, lot source et dernier résultat |
| Notification email absente | Adresse vérifiée, éligibilité, traitement et suivi SMTP |
| Droits insuffisants après mise à jour | Compte de service effectif, traversée des parents et ACL des fichiers remplacés |
Incident d'intégration
Collectez identifiant du lot, rapport, erreur standard et verification.json lorsqu'il existe. Indiquez la base cible et le mode sans fournir les identifiants secrets. Conservez les objets sous la forme type/id/version, pas un numéro seul.
Pour needs_review, préservez lot et preuves existants. Inspectez avant reprise ; ne répétez pas aveuglément l'append. Une dépendance en attente/refusée relève d'une décision métier ; un contexte incohérent ou une vérification en échec exige une analyse technique. Préservez le contexte historique plutôt que de le remplacer par un téléchargement OSM actuel.
Inspection des services
Ces commandes consultent l'état sans lancer d'append :
sudo systemctl status lbt-integration.service --no-pager
sudo systemctl cat lbt-integration.service
sudo journalctl -u lbt-integration.service --since '1 hour ago' --no-pager
sudo systemctl status lbt-segmentation.timer --no-pager
Un oneshot inactif après réussite est normal. Vérifiez les timers séparément. Consultez les surcharges effectives avant de supposer que les horaires et chemins du dépôt sont ceux réellement utilisés.
Signaler un problème reproductible
Fournissez version/commit, type de déploiement, action exacte, résultat attendu/obtenu, date/fuseau, état du service et diagnostics nettoyés. Pour une carte : zoom, emprise, filtres et erreur navigateur. Pour les données : type, identifiant et version.
Ne transmettez ni fichiers env, ni mots de passe de base, ni secrets SMTP, ni jetons email. Masquez adresses personnelles et URL internes dans les captures.