Notifications et journaux

Les journaux et les notifications informent les utilisateurs des diverses actions qui interviennent dans le système et des erreurs qui ont pu se produire. VoiceCheck et VoiceConsole gèrent les journaux système et fournissent des notifications dans l'interface utilisateur.

  • Les notifications sont des messages que l'application envoie pour alerter les utilisateurs de divers événements. Ces messages peuvent être consultés dans la page Notifications. Les notifications critiques s'affichent également dans une bannière de couleur en haut de l'interface au moment où elles se produisent. Le système peut être configuré pour envoyer les notifications critiques par e-mail à certains utilisateurs.

  • Lorsque vous reconnaissez cette notification, vous vous engagez à la résoudre. Les autres utilisateurs peuvent voir qui a reconnu la notification et quand.
  • Les journaux suivent les activités des utilisateurs dans l'application. Ils sont utiles pour analyser les situations ou les problèmes inattendus. Vous pouvez consulter la liste des journaux générés par l'application dans la page Journaux et enregistrer un journal sous forme de fichier ZIP (compressé).

Journaux de serveur

Apache Tomcat génère deux types de journaux qui s'affichent dans la page Journaux. Dans la plupart des cas, vous n'avez pas besoin de référencer ces journaux.

Les journaux spécifiques de Vocollect sont précédés de « Vocollect », « VoiceCheck » ou « VoiceConsole ». Ces journaux sont généralement référencés pour le dépannage. Ils sont créés à l'aide de log4j. Les sites suivants vous en apprendront plus sur log4j :

  • http://logging.apache.org/log4j/2.x/
  • http://www.developer.com/open/article.php/3097221

Voir le Guide de mise en œuvre Vocollect de VoiceConsole pour des détails sur les fichiers journaux VoiceConsole.

Journal VoiceCheck

Ce journal est nommé selon la convention d'appellation suivante :

VoiceCheck.log.n

où n est le numéro du journal. Le journal le plus récent n'affiche aucune valeur pour n, le journal le plus récent suivant affiche la valeur 1 pour n, etc.

Le journal VoiceCheck contient toutes les informations consignées conformément au niveau de journalisation défini dans le fichier de configuration log4j. Ce niveau est défini par défaut sur INFO. Autrement dit, il enregistre toutes les informations de niveau INFO ou plus critique.

Journal d'erreurs VoiceCheck

Ce journal est un sous-ensemble du journal Vocollect. Il contient toutes les informations consignées de niveau ERREUR ou plus critique. Ce journal est nommé selon la convention d'appellation suivante :

VoiceCheck.err.n

où n est le numéro du journal.

Niveaux de journalisation

Les journaux peuvent être configurés pour enregistrer les activités à l'un des niveaux suivants, TRACE étant le moins critique et FATAL le plus critique :

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • FATAL

Les fichiers de configuration de la journalisation définissent le niveau de journalisation et la taille maximale des journaux. Il existe deux fichiers de configuration de la journalisation, un pour le journal Vocollect et le journal d'erreurs, et un autre pour le journal proxy.

  • Le fichier de configuration de la journalisation pour le journal Vocollect et le journal d'erreurs de Vocollect se trouve à l'emplacement suivant : <chemin d'installation>\Vocollect\apache-tomcat-<version>\webapps\VoiceCheck\WEB-INF\classes\log4j.properties

Modification du niveau de journalisation d'un fichier journal

Pour changer le niveau de journalisation de l'un de ces fichiers, modifiez la propriété threshold et la catégorie racine. Exemples de paramètres affectés pour chaque fichier de configuration de la journalisation :

Journal Vocollect et journal d'erreurs
  • log4j.rootCategory=WARN,voc

Ce paramètre spécifie que ces journaux rapportent toutes les informations de niveau WARN ou supérieur. Pour visualiser les informations de niveau inférieur des fichiers journaux, vous devez modifier WARN pour définir un niveau de journalisation inférieur.

  • log4j.appender.voc.Threshold=INFO
    log4j.logger.com.vocollect=INFO,voc_err

Ces paramètres spécifient le niveau de journalisation du journal Vocollect. Il est défini sur INFO. Pour journaliser des informations à un niveau différent dans ce fichier, vous devez modifier ces deux paramètres.

  • log4j.appender.voc_err.Threshold=ERROR

Ce paramètre spécifie le niveau de journalisation du journal d'erreurs Vocollect. Il journalise les informations de niveau ERROR.

Modification de la taille maximale d'un fichier journal

Pour modifier la taille maximale d'un fichier journal, modifiez la propriété maxFileSize. Un exemple est présenté ci-dessous :

  • log4j.appender.voc.MaxFileSize=4MB

Vous pouvez également modifier le nombre de fichiers de report (fichiers avec une extension .n) en changeant ce paramètre :

  • log4j.appender.voc.MaxBackupIndex=30

Journaux de terminal

Vous pouvez activer l'enregistrement des périphériques dans l'interface utilisateur VoiceConsole pour résoudre les problèmes et saisir les journaux pour l'assistance technique.

  1. Dans VoiceConsole, sélectionnez Gestion des terminaux > Terminaux.
  2. Sélectionnez un ou plusieurs terminaux dans le tableau.
  3. Cliquez sur le lien d'action Gestion des terminaux >  Activer la journalisation pour les terminaux sélectionnés.
  4. Une fois les problèmes saisis, cliquez sur le nom du terminal pour afficher les propriétés du terminal.
  5. Exportez le fichier journal à partir de la page Afficher le terminal.
  6. Enregistrez le fichier et envoyez-le au support technique avec les informations pertinentes sur l'environnement :
    • Modèles de terminal et de casque
    • Versions logicielles Vocollect utilisées pour VoiceCatalyst MI, VoiceConsole et VoiceCheck
    • Date/heure de la première émission
    • Fréquence de l'apparition du problème
    • Impacts du problème
    • Changements récents dans l'environnement Solution de maintenance et d'inspection vocale Honeywell

Journaux des terminaux de capture

Le moyen le plus rapide de saisir les journaux des terminaux pour un problème spécifique consiste à prononcer la commande « Signaler un problème Talkman » lorsque le problème se produit. Le système répond en envoyant un instantané du fichier journal à VoiceConsole. Le journal peut ensuite être exporté et envoyé au support technique.

Pour signaler un problème dans Android, dites « j'ai besoin d'aide » depuis n'importe quel point de l'application et sélectionnez Signaler un problème.

Le fait de signaler un problème envoie les journaux de votre terminal au serveur. Ces fichiers comprennent :

Journaux de l'application M&I : tous les fichiers présents dans le répertoire /sdcard/Vocollect/logs. Les sous-répertoires ne sont pas inclus.

Journaux Android : tous les fichiers présents dans le répertoire /storage/IPSM/logger.

Le répertoire /storage/IPSM/logger est uniquement disponible si la journalisation du terminal est activée. Activez la journalisation du terminal dans le menu Paramètres du terminal Android.

Afficher les journaux de terminal

Ouvrez l'onglet Administration et sélectionnez Journaux dans la barre de navigation.

Dans la liste Actions du journal de la barre de navigation, vous pouvez Afficher les journaux de serveur, Afficher les journaux de terminal ou Enregistrer au format ZIP.

Un clic sur les journaux de serveur ou de terminal active la liste Afficher les journaux. À partir de là, vous pouvez cliquer sur le nom d'un journal pour l'afficher.