Diagnostics

Diagnostics se trouve en bas de la barre latérale droite, à l’écart des autres entrées, avec un badge qui compte ce qu’il a à signaler. Le rouge indique des erreurs, l’orange des avertissements, et l’absence de badge signifie que rien ne s’est mal passé.

C’est un outil de créateur. Il n’apparaît jamais sur une carte publiée.

Ce qu’il enregistre

Quatre sortes d’événements :

• network, les requêtes que votre carte a faites pour récupérer tuiles, entités et styles ;
• MapLibre errors, levées par le moteur de rendu lui-même ;
• console warnings, les avertissements de la console ;
• runtime exceptions, les exceptions survenues à l’exécution.

Chaque enregistrement indique son niveau, sa catégorie, le message, sa provenance et, pour une requête réseau, le statut HTTP et l’URL débarrassée de ses paramètres de requête.

Le lire

Les compteurs en haut servent aussi de filtres : cliquez sur errors pour ne voir qu’elles, cliquez sur total pour revenir à l’ensemble.

Deux autres actions vous aident quand vous devez aller plus loin :

• Copy JSON copie tout le journal dans votre presse-papiers : c’est ce qu’il faut joindre si vous signalez un problème.
• Clear le vide, pour que vous puissiez retenter un import et ne voir que ce que cette tentative a produit.

Log all network requests enregistre aussi les requêtes réussies. Cette option est désactivée par défaut, parce que tout journaliser ralentit la carte, et elle n’est pas rétroactive : seules les requêtes faites après son activation apparaissent.

Quand l’ouvrir

Ouvrez Diagnostics quand quelque chose ne semble pas normal et que la carte ne dit rien : une couche qui reste vide, un fond de carte qui ne s’affiche jamais, une source d’imagerie qui fonctionnait hier.

Les réponses habituelles sont visibles ici. Une requête refusée signifie que le fournisseur bloque les navigateurs ; dans ce cas, ajouter le même service par le panneau Data peut le relayer. Une erreur 404 sur une tuile signifie que la source a été déplacée. Une erreur de style signifie que la couche s’est chargée mais n’a pas pu être dessinée comme demandé.

Vous pouvez aussi confier le problème : l’AI Assistant lit ces diagnostics, si bien que lui demander pourquoi une couche ne se charge pas lui donne les mêmes éléments que ceux que vous avez sous les yeux.