J'ai vu des ingénieurs parcourir six heures jusqu'à un site distant, pour découvrir qu'une carte SIM $2 avait expiré. Ce déplacement unique a coûté plus cher que la caméra elle-même.
Notre micrologiciel PTB fournit un système de journalisation de diagnostic à trois niveaux qui enregistre les données du signal cellulaire, l'état du battement de cœur du protocole et les événements de récupération du chien de garde. Ces journaux vous permettent de déterminer si une déconnexion provient de l'opérateur, de l'environnement du signal ou du module matériel, le tout sans visiter le site.
Journaux réseau du micrologiciel de caméra PTZ pour le diagnostic à distance
Pour les intégrateurs B2B gérant des dizaines, voire des centaines de caméras distantes, les journaux réseau sont le seul outil qui réduit les coûts de maintenance sur le terrain. Ci-dessous, je détaille exactement ce que notre micrologiciel enregistre, comment y accéder et ce qu'il faut exiger de tout fournisseur de PTZ avant de signer un bon de commande.
Table des matières
Puis-je voir la raison exacte d'une déconnexion 4G (par exemple, erreur de carte SIM vs défaillance de l'antenne) ?
Lorsqu'une caméra 4G est hors ligne, mon téléphone commence à sonner. Le client veut des réponses. “ Est-ce la carte SIM ? L'antenne ? La caméra ? ” Sans les bons journaux, je ne fais que deviner.
Oui. Notre micrologiciel enregistre trois catégories distinctes de données cellulaires — métriques du signal RF, codes de rejet de l'opérateur et historique des transferts de cellule — afin que vous puissiez déterminer en quelques secondes si le problème est une carte SIM morte, une antenne congestionnée ou un modem défaillant.
Journaux de raison de déconnexion 4G : erreur de carte SIM vs défaillance de l'antenne
Couche 1 : Journaux de connectivité cellulaire en temps réel
Le micrologiciel capture chaque interaction entre le modem 4G et la station de base. Chaque entrée correspond à une commande AT spécifique commande AT3 réponse. Voici ce qui est enregistré :
- Indicateurs de qualité du signal : Le journal stocke RSRP1 (Puissance du signal de référence reçu), RSRQ2 (Qualité du signal de référence reçu) et RSSI à intervalles réguliers. Si le RSRQ reste inférieur à -15 dB pendant plus de deux minutes, le système signale automatiquement un “ Avertissement d'interférence environnementale ”.
- ID de cellule et PCI : Le journal suit la tour à laquelle la caméra se connecte. Si vous voyez l'ID de cellule changer toutes les quelques secondes, c'est un effet de ping-pong4. classique. Cela signifie que deux tours se disputent la connexion. La solution consiste généralement à verrouiller le modem sur une bande de fréquences spécifique.
- Statut d'enregistrement du réseau : Le journal montre le parcours complet de
RechercheàEnregistré, y compris tous les codes de rejet. Par exemple, Cause 19 : ESM_FAILURE5 signifie presque toujours que la carte SIM n'a plus de crédit ou que l'APN est incorrect.
Couche 2 : Codes d'erreur de l'opérateur qui vous évitent un déplacement
C'est là que réside la vraie valeur. Au lieu de vous rendre sur le site, vous lisez le code de rejet et savez exactement ce qui s'est passé.
| Code de rejet | Signification | Solution typique |
|---|---|---|
| Cause 3 : MS illégal | La carte SIM est bloquée par l'opérateur | Appelez l'opérateur pour la réactiver |
| Cause 6 : ME illégal | L'IMEI du modem est mis sur liste noire | Remplacez le modem ou contactez l'opérateur |
| Cause 11 : PLMN non autorisé | La carte SIM n'est pas autorisée pour ce réseau | Passez à un opérateur pris en charge |
| Cause 19 : Échec ESM | APN rejeté ou la carte SIM n'a pas de forfait de données | Corrigez les paramètres APN ou rechargez la carte SIM |
| Cause 22 : Congestion | La tour est surchargée | Attendez, ou verrouillez sur une bande moins fréquentée |
J'ai vu des intégrateurs perdre des journées entières à dépanner une “ caméra morte ” qui s'est avérée être Cause 19. La carte SIM avait épuisé ses données. Une vérification des journaux de cinq secondes l'aurait résolu.
Couche 3 : Quand le problème est le matériel
Si le pilote du modem plante, le journal du noyau (dmesg)6 capture la dernière instruction d'erreur. Notre équipe d'ingénierie peut lire ce journal à distance et envoyer un correctif firmware. Vous n'avez pas besoin de renvoyer la caméra en Chine. Vous n'avez pas besoin d'ouvrir le boîtier. Le journal nous indique exactement quelle fonction a échoué et pourquoi.
Cette approche à trois couches signifie que vous n'avez jamais à deviner. Problème de SIM, problème de tour, ou problème matériel — le journal vous indique lequel, à chaque fois.
Les journaux sont-ils accessibles via l'interface graphique Web même si la connexion P2P est instable ?
J'ai été dans des situations où le tunnel P2P ne cesse de tomber. La caméra est à moitié en ligne. Je peux la pinger parfois, mais le relais cloud est peu fiable. Puis-je toujours récupérer les journaux ?
Oui. Notre interface Web stocke les 500 dernières entrées de journal localement sur la caméra. Si vous pouvez atteindre l'appareil via n'importe quel chemin IP — réseau local, VPN, ou même une brève fenêtre P2P — vous pouvez visualiser et exporter le package de diagnostic complet sans connexion cloud stable.
Accès aux journaux de l'interface graphique Web connexion P2P instable
Pourquoi le stockage local est important
De nombreuses caméras bon marché stockent les journaux uniquement dans la RAM. Lorsque l'appareil redémarre, tout disparaît. Notre firmware écrit les journaux dans un stockage non volatile7. Même après une panne de courant ou un redémarrage déclenché par un watchdog, les journaux survivent. Ceci est crucial pour les sites distants où vous pourriez ne pas vérifier la caméra pendant des jours ou des semaines.
Trois façons de récupérer les journaux
Nous avons conçu plusieurs méthodes d'accès car aucune méthode unique ne fonctionne dans toutes les situations :
- Vue directe de l'interface Web : Ouvrez la page de gestion de la caméra, allez dans “ Maintenance du système ” et parcourez les 500 dernières entrées de journal en temps réel. Vous pouvez filtrer par catégorie — réseau, système ou alarme.
- Exportation en un clic : Téléchargez un package
.tar.gzqui contient les journaux réseau, la configuration système et les statistiques d'exécution. Ce fichier est suffisamment petit pour être transféré même sur une liaison 4G lente ou instable. - Récupération à distance VMS : Si vous utilisez notre plateforme de gestion, vous pouvez récupérer le journal “ Last Will ” d'un appareil qui est déjà hors ligne. La plateforme met en cache le dernier rapport d'état que la caméra a envoyé avant de se déconnecter. Ce rapport comprend le niveau de batterie, la force du signal et le code d'erreur final.
Que faire si l'interface Web est complètement inaccessible ?
Si la caméra est complètement hors ligne et que vous ne pouvez pas y accéder par un chemin IP, les journaux sont toujours en sécurité sur l'appareil. La prochaine fois que la caméra sera de nouveau en ligne — que ce soit par un cycle d'alimentation, un échange de carte SIM ou une récupération de signal — vous pourrez récupérer immédiatement les journaux stockés. Rien n'est perdu.
| Méthode d'accès | Connexion stable requise ? | Profondeur des journaux | Meilleur pour |
|---|---|---|---|
| Interface utilisateur Web | Un bref accès suffit | 500 dernières entrées | Vérifications rapides lors d'une connectivité intermittente |
| .Exportation .tar.gz | Un bref accès suffit | Package de diagnostic complet | Envoi à l'ingénierie pour une analyse approfondie |
| Récupération à distance VMS | Non (utilise des données mises en cache) | Dernier rapport d'état | Appareils hors ligne auxquels vous ne pouvez pas du tout accéder |
Pour les intégrateurs comme David Miller qui gèrent des sites dans plusieurs États, cette flexibilité n'est pas une option. C'est une exigence de base. Si votre fournisseur de caméra actuel ne peut pas vous fournir les journaux lorsque la connexion est mauvaise, les journaux sont inutiles au moment où vous en avez le plus besoin.
Jusqu'où remontent les journaux de connexion avant d'être écrasés par le système ?
J'ai eu besoin un jour de retracer un schéma de déconnexions nocturnes qui se produisaient depuis deux semaines. La caméra ne conservait que trois jours de journaux. J'ai dû recommencer avec une nouvelle fenêtre de surveillance. Cela m'a coûté deux semaines supplémentaires.
Notre micrologiciel conserve les 500 dernières entrées de journal structurées dans le stockage local. Pour une conservation à long terme, vous pouvez configurer la redirection Syslog8 vers un serveur externe, qui stocke un historique illimité et vous permet de rechercher des mois de données pour identifier des schémas récurrents.
Période de conservation des journaux de connexion avant écrasement
Comprendre le tampon local de 500 entrées
La limite de 500 entrées est un choix de conception délibéré. Les caméras PTZ ont un stockage flash limité, et une écriture trop agressive réduit la durée de vie de la puce de stockage. Cinq cents entrées couvrent généralement 3 à 7 jours de fonctionnement normal, en fonction de l'activité de l'environnement réseau. Dans un déploiement stable, où la caméra se connecte une fois et reste connectée, 500 entrées peuvent couvrir plusieurs semaines. Dans un environnement bruyant avec des transferts et des reconnexions fréquents, le tampon peut se remplir en 2 à 3 jours.
Syslog : La bonne réponse pour l'historique à long terme
Si vous avez besoin de semaines ou de mois d'historique de journaux, le stockage local n'est pas l'outil approprié. L'outil approprié est Syslog. Voici comment cela fonctionne :
- Vous configurez un serveur Syslog sur votre backend. Les options gratuites incluent rsyslog sous Linux ou Kiwi Syslog sous Windows.
- Dans l'interface Web de la caméra, vous entrez l'adresse IP et le port du serveur Syslog.
- Vous choisissez le niveau de journalisation : Info, Warning, Error ou Debug.
- À partir de ce moment, chaque entrée de journal est envoyée à votre serveur en temps réel. Le serveur stocke tout. Il n'y a pas de limite d'écrasement.
Quel niveau de journalisation devriez-vous utiliser ?
- Info : Journalise tout, y compris les mises à jour de statut de routine. Bon pour les tests de déploiement initiaux. Génère beaucoup de données.
- Warning : Journalise la dégradation du signal, la latence élevée et les événements proches du seuil. Bon pour la surveillance continue.
- Error : Journalise uniquement les échecs — déconnexions, échecs d'activation PDP, réinitialisations watchdog. Bon pour les environnements de production où vous ne souhaitez voir que les problèmes.
- Debug : Journalise les échanges de commandes AT brutes et les détails au niveau du protocole. Utilisez ceci uniquement lors du dépannage actif d'un problème spécifique. Désactivez-le une fois terminé.
Pour la plupart des déploiements B2B, je recommande de régler le niveau Syslog sur Avertissement pour le fonctionnement quotidien et de passer à Débogage uniquement lorsqu'une caméra spécifique présente des problèmes répétés. Cela vous donne des mois d'historique utile sans inonder votre serveur de bruit.
La caméra peut-elle m'envoyer automatiquement un “ rapport de diagnostic ” après un crash critique ?
Je ne veux pas vérifier les journaux manuellement tous les jours. Je veux que la caméra me dise quand quelque chose ne va pas. Est-ce possible ?
Notre firmware prend en charge les alertes automatisées via la plateforme VMS. Lorsqu'une réinitialisation du watchdog, un crash du modem ou une défaillance répétée du heartbeat se produit, le système peut envoyer une notification qui inclut la raison du redémarrage, les dernières lectures du signal et le code d'erreur — vous savez ainsi ce qui s'est passé avant même de vous connecter.
Rapport de diagnostic automatique par e-mail après un crash de caméra
Comment fonctionnent le Watchdog et le Journal de récupération
Le watchdog est un minuteur au niveau matériel. Si le processeur principal ou la pile réseau cesse de répondre pendant une période définie, le watchdog coupe l'alimentation et force un redémarrage complet. Chaque fois que cela se produit, le firmware écrit une entrée de journal de récupération qui comprend :
- Raison du redémarrage : S'agissait-il d'un redémarrage manuel, d'une mise à jour du firmware ou d'une mise hors tension forcée par le watchdog en raison d'un délai d'attente réseau ?
- État avant le crash : La dernière intensité de signal connue, l'adresse IP et la durée de la connexion avant le crash.
- Trace d'erreur du noyau : Si le pilote du modem 4G a planté, le journal dmesg capture la fonction exacte et l'adresse mémoire où la défaillance s'est produite.
Transformer les journaux en alertes
La caméra elle-même n'envoie pas d'e-mails directement. Au lieu de cela, le flux d'alertes fonctionne comme suit :
- La caméra écrit le journal de crash dans le stockage local.
- Lorsque la caméra se reconnecte, elle envoie le journal de crash à la plateforme VMS.
- La plateforme VMS analyse le journal et déclenche une règle d'alerte que vous avez configurée — e-mail, SMS, webhook ou notification push.
- Vous recevez un résumé qui dit, par exemple : “ La caméra Site-14 a redémarré à 03h22. Raison : Délai d'attente du Watchdog. Dernier RSRP : -108 dBm. Dernière erreur : Échec d'activation PDP. ”
Pourquoi c'est important pour les sites sans personnel
Pour les caméras solaires dans les fermes, les chantiers de construction ou les couloirs routiers, personne ne surveille le flux en direct à 3 heures du matin. La caméra doit être capable de récupérer par elle-même, puis de signaler ce qui s'est passé. Notre système de surveillance gère la récupération. Le système de journalisation gère le signalement. Ensemble, ils vous donnent la confiance que la caméra est auto-réparatrice et que vous serez informé de chaque incident le lendemain matin.
| Type d'événement | Données enregistrées | Déclencheur d'alerte |
|---|---|---|
| Redémarrage matériel du chien de garde | Raison du redémarrage, signal pré-crash, temps de fonctionnement avant le crash | Oui — envoyé au VMS lors de la reconnexion |
| Crash du pilote du modem | Trace dmesg du noyau, dernière réponse de commande AT | Oui — marqué comme critique |
| Délai d'attente du battement de cœur (3x) | Horodatages d'échec d'ACK MQTT/WebSocket | Oui — déclenche la reconstruction du lien et l'alerte |
| Échec d'activation PDP | Configuration APN, code de rejet de l'opérateur | Oui — enregistré et signalé |
| Redémarrage manuel | ID utilisateur, horodatage | Non — informatif uniquement |
Si votre fournisseur PTZ actuel ne peut pas vous dire pourquoi une caméra a redémarré sur un site distant, vous naviguez à l'aveugle. Vous continuerez à envoyer des camions vers des sites où un simple rechargement de SIM ou une correction APN aurait résolu le problème en cinq minutes.
Conclusion
Les journaux réseau détaillés ne sont pas un luxe. Ils font la différence entre une réparation à distance de cinq minutes et une intervention sur site de 500 $. Exigez-les avant d'acheter.
1. Le RSRP (Reference Signal Received Power) est une métrique clé de la qualité du signal LTE utilisée pour mesurer la force du signal de référence d'une antenne relais. ︎↩︎ 2. Le RSRQ (Reference Signal Received Quality) indique la qualité du signal reçu, les valeurs basses (par exemple, inférieures à -15 dB) signalant souvent une interférence. ︎↩︎ 3. Les commandes AT sont utilisées pour communiquer avec les modems ; les réponses aux commandes AT sont capturées par le firmware pour enregistrer les interactions cellulaires. ︎↩︎ 4. L'effet ping-pong se produit lorsqu'un appareil mobile bascule rapidement entre deux antennes, provoquant souvent une instabilité de la connexion. ︎↩︎ 5. L'échec ESM (Cause 19) indique un problème avec la gestion de session EPS, souvent dû à un APN incorrect ou à un forfait de données expiré. ︎↩︎ 6. La commande dmesg affiche les messages du tampon circulaire du noyau, essentiels pour diagnostiquer les plantages de pilotes matériels. ︎↩︎ 7. La mémoire non volatile conserve les données après une perte de courant, garantissant que les journaux survivent aux redémarrages. ︎↩︎ 8. Syslog est un protocole standard pour envoyer des messages de journal à un serveur distant, permettant une rétention illimitée des journaux. ︎↩︎