Le journal d'activité répond à la question que vous vous posez quand quelque chose ne va pas : que s'est-il passé, et que dois-je faire ? Il liste les événements notables de votre passerelle en phrases simples, avec la cause et un conseil pour chaque avertissement et chaque erreur.
Ouvrez-le depuis Journal, dans la section Système du menu.
Ce qu'il montre
| Catégorie | Exemples d'entrées |
|---|---|
| SMS | Un SMS n'a pas pu être envoyé après ses tentatives, avec la raison signalée par le téléphone |
| Appareils | Un téléphone a été appairé, s'est connecté, ne répond plus, a une batterie faible |
| Campagnes | Une campagne a démarré, a été mise en pause, a repris, a été annulée, est terminée (avec ou sans échecs) |
| Webhooks | Un webhook a été coupé après 100 livraisons échouées d'affilée |
| Automatisations | Une règle a répondu à quelqu'un, ou une réponse a été retenue et pourquoi |
| Sauvegardes | Une sauvegarde a été écrite, ou a échoué |
| Licence | Notre serveur de licences est injoignable, ou répond à nouveau |
| Sécurité | Une connexion, une tentative de connexion refusée et sa raison, un compte ou une clé API créé, révoqué, supprimé |
| Système | La passerelle a démarré, les réglages ont changé, un import de contacts est terminé, une erreur interne |
Les messages envoyés, reçus et remis un par un ne figurent pas dans le journal : ils noieraient les problèmes. Suivez-les dans la File d'attente et dans Conversations.
Le journal ne contient jamais le texte d'un message ni un numéro complet : les numéros y apparaissent
masqués (+261******89).
Lire une entrée
Chaque ligne affiche :
- le niveau, avec une icône et un mot (Information, Avertissement, Erreur), jamais une couleur seule ;
- quand, en temps relatif ; survolez-le pour l'heure exacte dans le fuseau de la plateforme ;
- la catégorie ;
- ce qui s'est passé, en une phrase, et sa cause.
Cliquez sur une ligne pour voir son détail : l'heure exacte et le code, Pourquoi : la cause, Que faire pour les avertissements et les erreurs, les paramètres bruts, et un lien vers l'écran concerné (Ouvrir la file d'attente, Ouvrir les appareils, Ouvrir les campagnes...).
SMS en échec : cause et conseil
Quand un téléphone signale pourquoi un SMS a échoué, le journal traduit la raison :
| Code | Cause | Que faire |
|---|---|---|
RADIO_OFF |
La radio mobile du téléphone est coupée (mode avion) | Désactivez le mode avion sur le téléphone |
NO_SERVICE |
La SIM ne captait pas le réseau | Placez le téléphone là où il capte mieux, ou vérifiez la SIM auprès de l'opérateur |
GENERIC_FAILURE |
L'opérateur a refusé le SMS, le plus souvent par manque de crédit | Vérifiez le crédit de la SIM ou son forfait SMS, puis relancez |
NULL_PDU |
Le téléphone n'a pas pu encoder le message | Relancez ; si l'échec se répète, redémarrez le téléphone |
DEVICE_OFFLINE |
Aucun téléphone n'était connecté pour l'envoyer | Reconnectez au moins un téléphone, puis relancez depuis la file d'attente |
MAX_ATTEMPTS_REACHED |
Toutes les tentatives autorisées ont échoué | Regardez les échecs précédents dans la file d'attente, corrigez la cause, relancez |
DEVICE_ERROR |
Le téléphone a signalé une erreur sans détail | Redémarrez l'application sur le téléphone, puis relancez |
DELIVERY_FAILED |
Le SMS est parti, mais l'opérateur signale qu'il n'a pas été remis | Vérifiez que le numéro est correct et en service |
PERMISSION_DENIED |
L'application n'a pas le droit d'envoyer des SMS sur ce téléphone | Ouvrez l'application et accordez l'autorisation SMS |
NO_SMS_MANAGER |
Ce téléphone ne sait pas envoyer de SMS | Utilisez un autre téléphone, ou vérifiez qu'une SIM est insérée |
INVALID_ARGUMENT |
Le téléphone a refusé le message comme mal formé | Vérifiez le numéro du destinataire, puis relancez |
ORDER_EXPIRED |
Le téléphone a reçu l'ordre trop tard pour l'envoyer | Vérifiez la connexion internet du téléphone, puis relancez |
Filtres
| Filtre | Valeurs | Effet |
|---|---|---|
| Gravité | Tout, Avertissements et erreurs, Erreurs seulement | Masque les niveaux moins graves |
| Catégorie | Tous, ou l'une des neuf catégories ci-dessus | Affiche une seule catégorie |
| Appareil | Tous, ou un téléphone | Affiche ce qui concerne ce téléphone |
| Rechercher | Texte libre, 100 caractères au plus, par exemple RADIO_OFF ou offline |
Cherche dans les codes et les paramètres, sans tenir compte des majuscules |
| Du, Au | Deux dates, lues dans le fuseau de la plateforme | Limite la période. Un début après la fin est signalé et n'est pas appliqué |
Effacer les filtres remet tout à zéro. En haut, les compteurs d'erreurs et d'avertissements des dernières 24 heures sont cliquables : un clic applique la gravité correspondante.
Actualiser automatiquement, activé par défaut, recharge le journal toutes les 15 secondes. Coupez-le pour lire tranquillement sans que les lignes bougent.
Logs techniques (Superadministrateur)
Le bouton Logs techniques ouvre un panneau latéral avec les dernières lignes de log brutes de la passerelle, celles dont votre développeur ou notre support a besoin pour diagnostiquer un problème :
- les 1 000 dernières lignes, gardées en mémoire seulement : elles sont perdues au redémarrage de la passerelle, contrairement au journal d'activité ;
- un filtre Niveau minimum (Débogage, Info, Avertissement, Erreur) et une actualisation toutes les 5 secondes ;
- Copier la ligne et Tout copier, pour coller dans un e-mail ou un ticket ;
- sur une entrée d'erreur interne, Voir la ligne technique ouvre le panneau sur la ligne correspondante.
Ces lignes ne contiennent jamais le texte d'un message, un numéro complet ni un secret, mais elles montrent des chemins internes et des messages d'erreur : c'est pourquoi seul le Superadministrateur les voit.
Les lignes capturées dépendent de GATEWAY_LOG_LEVEL (debug, info, warn ou error, info par
défaut) : à error, le panneau ne montre que les erreurs. Les mêmes lignes sont disponibles sur le
serveur avec sms-gateway logs.
Durée de conservation
Les entrées de plus de 30 jours sont supprimées automatiquement, une fois par heure. La durée est
lue au démarrage depuis GATEWAY_LOG_RETENTION_DAYS (1 à 3650 jours) : réglez-la dans le fichier
.env de l'installation, puis lancez sms-gateway restart (voir
Installation, les réglages modifiables).
Qui peut le voir
| Rôle | Journal d'activité | Logs techniques |
|---|---|---|
| Lecture seule | Non : l'écran explique que le rôle ne donne pas accès | Non |
| Opérateur | Oui | Non |
| Superadministrateur | Oui | Oui |
Par l'API
| Méthode | Chemin | Ce qu'il fait |
|---|---|---|
GET |
/api/v1/logs |
Les entrées. Filtres : minLevel, category, from, to, deviceId, search, limit, cursor |
GET |
/api/v1/logs/stats |
Erreurs et avertissements par catégorie sur les dernières hours heures (1 à 720, 24 par défaut) |
GET |
/api/v1/logs/technical |
Les lignes techniques. minLevel, afterSeq, limit (1 à 1000, 200 par défaut). Clé de portée admin |
Les deux premières demandent une clé de portée read au moins. Voir Clés API.
En cas de problème
| Ce que vous voyez | Pourquoi, et que faire |
|---|---|
| « Votre rôle ne donne pas accès au journal d'activité » | Votre compte est en Lecture seule. Demandez à un Superadministrateur |
| Le bouton Logs techniques n'apparaît pas | Seul un Superadministrateur le voit |
| Le panneau technique est presque vide | La passerelle a redémarré récemment, ou GATEWAY_LOG_LEVEL vaut error |
| Un événement d'il y a deux mois a disparu | Les entrées sont supprimées après la durée de conservation (30 jours par défaut) |
| « Notre serveur de licences est injoignable » | Rien à faire : la passerelle continue de fonctionner. Voir Licence |