Travail avec les journaux

Les services backend de la plateforme Navixy collectent systématiquement des journaux lors de leur exécution. Ces journaux contiennent des entrées sur toutes les actions effectuées par les services Java, ainsi que sur les erreurs survenant pendant le fonctionnement de la plateforme. L'analyse des journaux fait partie intégrante du processus de dépannage.

Emplacement des journaux

Chacun des trois services backend Java dispose de ses propres journaux. Les répertoires par défaut sont les suivants :

Service	Linux	Windows
API-server	/home/java/api-server/log	C:\java\api-server\log
SMS-server	/home/java/sms-server/log	C:\java\sms-server\log
TCP-server	/home/java/tcp-server/log	C:\java\tcp-server\log

Les répertoires ci‑dessus sont les répertoires par défaut, mais sur certains serveurs les journaux peuvent être stockés dans un répertoire personnalisé à la demande du propriétaire de l'instance. Pour plus de détails, consultez le Service logs storage settings page.

Contenu des journaux

Journaux de l'API-server sont les premiers à analyser lorsqu'un problème affecte le fonctionnement de la plateforme dans son ensemble ou des fonctions individuelles. Si vous constatez qu'une requête API n'est pas exécutée (lors d'intégrations API ou dans les outils de développement du navigateur), recherchez dans le journal par l'en‑tête ou le contenu de cette requête. Si les problèmes concernent un appareil ou un groupe d'appareils spécifique, recherchez par IMEI ou ID de cet appareil.

Journaux du SMS-server doivent être vérifiés en cas de problèmes de messagerie. Cela concerne à la fois les messages SMS et les e‑mails (indépendamment du nom du service). Recherchez les problèmes par numéro de téléphone ou adresse e‑mail.

Journaux du TCP-server contiennent toutes les informations liées au fonctionnement des appareils, à la connexion réseau et aux vérifications de licence. Vous pouvez y effectuer une recherche par IMEI de l'appareil, adresse réseau ou tout autre paramètre lié au problème.

Si vous connaissez les circonstances dans lesquelles le problème survient, une bonne tactique consiste à le déclencher et à vérifier quelles entrées apparaissent dans les journaux. De cette façon, vous « attraperez » l'erreur au moment où elle se produit.

Outils utiles

Linux

Vous pouvez rechercher des valeurs spécifiques dans les journaux avec la commande grep Ainsi, vous verrez l(es) entrée(s) du journal contenant la valeur que vous recherchez. Exemple :

grep "12345678910" log.txt

Pour visualiser les nouvelles entrées de journal en temps réel, utilisez la commande tail Ceci est particulièrement utile lorsque vous avez la possibilité de déclencher les problèmes.

tail -f log.txt

Pour afficher l'intégralité du journal, utilisez l'éditeur de texte de votre choix, tel que nano ou vim.

Windows

Le Bloc‑notes standard de Windows est incapable de gérer les gros fichiers texte, n'essayez donc pas de l'utiliser pour consulter les journaux — il se bloquera. Utilisez plutôt un éditeur de texte avancé tiers.

Les éditeurs les plus populaires pour Windows sont :

• Notepad++

• Sublime Text

Ces éditeurs disposent de fonctions de recherche avancées et peuvent gérer de grands fichiers, ce qui les rend très utiles lors du travail avec des journaux sur de grandes instances.