Shinken¶

Convertit des évènements de supervision Shinken en évènements Canopsis.

Prérequis¶

Installez Shinken Entreprise 02.07.06 ou supérieur en suivant la documentation de l'éditeur.
Installez également la bibliothèque kombu soit avec pip soit en passant par le gestionnaire de paquets de votre distribution yum install python2-kombu/apt-get install python-kombu

Installation¶

Le module broker Canopsis sera bientôt présent de manière native dans la distribution Shinken Entreprise. Pour le moment notre support peut vous fournir les fichiers nécessaires.

Copiez le dossier broker-exporter-canopsis vers /var/lib/shinken/modules/

Puis copiez le fichier broker-exporter-canopsis.cfg vers /etc/shinken/modules/ et modifiez les droits du fichier avec la commande suivante :

chown shinken:shinken /etc/shinken/modules/broker-exporter-canopsis.cfg

Configuration¶

Éditez le fichier /etc/shinken/brokers/broker-master.cfg et ajoutez broker-exporter-canopsis à la liste des modules activés.

#======== Modules to enable for this daemon =========
    # Available:
    # - Simple-log            : save all logs into a common file
    # - WebUI                 : visualisation interface
    # - Graphite-Perfdata     : save all metrics into a graphite database
    # - sla                   : save sla into a database
    # - Livestatus            : TCP API to query element state, used by nagios external tools like NagVis or Thruk
    # - event-manager-writer  : save events for events manager (do not forget to activate the module in your webui to see data)
    modules                   Simple-log, WebUI, Graphite-Perfdata, sla, event-manager-writer, Livestatus, broker-exporter-canopsis

Personnalisez ensuite le contenu du fichier /etc/shinken/modules/broker-exporter-canopsis.cfg, par exemple :

    #======== Canopsis address =========
    # Canopsis host to connect to
    host                 192.168.0.123
    # rabbitmq port
    port                 5672
    # must be changed
    user                 cpsrabbit
    password             canopsis
    virtual_host         canopsis
    exchange_name        canopsis.events
    # need a unique identifier because there should be more than one shinken in canopsis
    identifier           shinken-1
    # maximum event stored in queue when connection with canopsis is lost
    maxqueuelength       50000
    # frequency (in seconds) on which the queue is saved for retention
    queue_dump_frequency 300

Le module broker vous permet la perte de connexion et la reconnexion avec le bus de messages Canopsis AMQP sans perte d'évènements. Vous pouvez modifier la valeur de maxqueuelength (le nombre maximal d'évènements à conserver en cas de perte de connexion) selon vos besoins.

Enfin redémarrez Shinken.

service shinken restart

Aucune configuration n'est nécessaire dans l'interface de Shinken, le connecteur enverra automatiquement les évènements vers Canopsis.

Dernière mise à jour: 2021-06-14