Page History

Emplacement et organisation des fichiers de logs

Les fichiers de logs des démons Shinken sont placés dans /var/log/shinken.

Chaque instance de démon Shinken possède dans ce dossier son fichier de log.

Par défaut, les démons présents dans l'installation Shinken possèdent les fichiers de logs suivants:

• arbiterd.log
• schedulerd.log
• receiverd.log
• reactionnerd.log
• pollerd.log
• brokerd.log
• synchronizerd.log

Lorsque d'autres démons sont ajoutés sur la même machine, les fichiers de logs sont nommés de la façon suivante:

<TYPE_DEMON>d-<ID_DEMON>.log

Par exemple, un scheduler supplémentaire avec l'id 1 aura le fichier de log suivant:

• /var/log/shinken/schedulerd-1.log

Logs de debug

Les démons Shinken peuvent être démarrés en mode debug pour avoir des logs plus verbeux.

Plusieurs commandes permettent de redémarrer les démons en mode debug:

• Redémarrer tous les démons en mode debug (option -d)

  Code Block
  service shinken -d restart

  
  

• Redémarrer tous les démons d'un type en mode debug.

  Code Block
  service shinken-<type_demon> -d restart

  "<type_demon>" correspond au type du démon à redémarrer, et est une valeur parmis les suivantes: arbiter, scheduler, poller, broker, reactionner, receiver, synchronizer.
  Par exemple, pour un Scheduler, la commande est la suivante:

  Code Block
  service shinken-scheduler -d restart

  
  

• Redémarrer une seule instance de démon en mode debug.

  Code Block
  service shinken-<type_demon> -d --id <id_demon> restart

  L'id du démon peut être trouvée à l'aide de la commande shinken-daemons-list.

Un démon démarré en mode debug envoie ses logs dans un fichier différent, placé dans /var/log/shinken et nommé comme suivant:

<type_demon>d-<id_demon>.debug.log

Pour un scheduler avec l'id 2, le fichier de log en mode debug correspondant est le suivant:

• /var/log/shinken/schedulerd-3.debug.log

Réglage du niveau de log par défaut

Dans les fichiers de logs Shinken, chaque entrée possède une des 4 priorités suivantes:

• DEBUG
• INFO
• WARNING
• CRITICAL

A l'installation, ou lorsqu'un nouveau démon est créé, le niveau de log par défaut est INFO.

Ce niveau de log par défaut peut être modifié dans le fichier .ini du démon concerné, via le paramètre log_level:

 # accepted log level values= DEBUG,INFO,WARNING,ERROR,CRITICAL
 log_level=INFO

Chaque instance de démon possède un fichier .ini placé dans /etc/shinken/daemons. Ce fichier est nommé selon le type de démon et son id:

<type_demon>d-<id_demon>.ini

Comme pour les fichiers de logs, les démons préinstallés n'ont pas l'id dans le nom du fichier .ini (pour rester compatible avec les anciennes versions). Les fichiers .ini par défaut sont donc les suivants:

• pollerd.ini
• brokerd.ini
• schedulerd.ini
• reactionnerd.ini
• receiverd.ini

Le Synchronizer et l'Arbiter sont des démons centraux avec des roles particuliers par rapport aux autres démons. Ils ont pour particularité d'avoir des fichiers .ini différents des autres démons:

• Arbiter: /etc/shinken/shinken.cfg
• Synchronizer: /etc/shinken/synchronizer.cfg

Si le paramètre log_level n'est pas présent dans ces fichiers, il faudra l'ajouter dans les fichiers de surcharge:

• Arbiter: /etc/shinken-user/configuration/daemons/arbiters/arbiter_cfg_overload.cfg
• Synchronizer: /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg

Agrégation des logs

Les logs de tous les démons sont agrégés dans 2 fichiers:

• /var/log/shinken/shinken.log: Les logs présents dans le fichier sont les mêmes que ceux contenus dans l'ensemble des fichiers de logs de tous les démons, rassemblés.
• /var/log/shinken/nagios-export.log: Agrégation des fichiers de logs contenant seulement les données utiles à la supervision (alertes de résultats de checks par exemple). Ne contient pas les avertissements et autres messages propres à Shinken. Ce fichier est utile notamment pour les outils externes qui se basent sur les logs de Shinken.

Dans ces fichiers de logs agrégés, les logs de Debug ne sont pas présents, pour éviter une surcharge inutile.

Cette agrégation est effectuée par le module Simple-log activé par défaut sur le Broker.

Rotation des logs

Rotation des logs des démons

Les fichiers de logs des démons contiennent seulement les logs de la journée en cours. A chaque nouvelle journée, les démons vident leur fichier de logs après avoir sauvegardé son contenu dans un fichier de sauvegarde.

Chaque fichier de sauvegarde correspond alors à une journée de logs. Pour ne pas consommer trop d'espace disque, seulement les 5 derniers fichiers sont conservés (cette durée de 5 jours n'est pas paramétrable à l'heure actuelle).

Voici l'exemple de l'état du dossier /var/log/shinken après plusieurs jours en activité:

Rotation des logs agrégés

Les logs agrégés ont un comportement différent au niveau de leur archivage puisqu'ils ne sont pas gérés par les démons mais par le module Simple-log.

Ces fichiers sont sauvegardés dans le dossier /var/log/shinken/archives, toujours en organisant les logs en placant une journée par fichier.

A la différence des fichiers de logs des démons ou seulement les 5 dernières journées sont conservées, les logs agrégés ne sont pas supprimés.

Informations utiles contenues dans les logs

Chaque démon a un rôle particulier. Par conséquent, chaque fichier de logs possède des informations particulières sur la supervision. Cette section liste les informations utiles qui peuvent être trouvées dans chaque fichier de log.

Arbiter

Dans les logs de l'Arbiter, on trouve l'ensemble des données relatives à l'ensemble de l'architecture de Shinken: l'état des démons et les détails concernant l'envoi de la configuration aux autres démons. Ce fichier est très utile dans le cas d'une architecture haute disponible, utilisant des spares. On peut y trouver quel démon est tombé, quel démon est passé en Spare et à quelle heure.

Broker

Ce fichier contient entre autres les informations liées à la gestion des données. Le broker est utilisé pour consommer les données de supervision récupérées par le Scheduler, et donc contiendra des informations supplémentaires sur la connexion entre les démons en cas d'erreur:

• Schedulers
• Poller
• Reactionners
• Receivers

C'est principalement dans ce fichier qu'on trouvera aussi les informations liées à l'interface de Visualisation.

Poller

Le poller est chargé d'éxecuter les vérifications des checks et des hôtes. On utilise souvent ce fichier pour déterminer pourquoi un check ou un hôte n'a pas son statut à jour.

En cas d'erreur d'une commande (syntaxe invalide, script introuvable), des informations pourront être trouvées dans les logs du Poller.

Aussi, on y trouvera des informations supplémentaires lorsque le démon n'arrive pas à communiquer avec le Scheduler.

Reactionner

Le reactionner est lui chargé d'exécuter les commandes de notifications et de gestionnaires d’événements. On utilise les logs du Reactionner pour avoir plus d'informations sur l'exécution d'une notification ou d'un gestionnaire d’événement en cas d'erreur.

Receiver

Dans les logs du Receiver, on trouve les événements liés aux checks passifs.

Scheduler

Le Scheduler ordonnance l'exécution des checks et des commandes. On trouve dans ce fichier l'ensemble des retours de checks, le déclenchement de l'envoi de notifications et des gestionnaires d'événements:

Synchronizer

On trouve dans ce fichier les alertes et messages concernant l'interface de Configuration