Aller au contenu principal

Slack

Contenu du connecteur de supervision​

Objets supervisés​

Le Pack Slack collecte les données pour:

  • Channels
  • Members
  • Services

Règles de découvertes​

Rule nameDescription
App-Slack-Restapi-Services-NameDiscover services and monitor their status

Métriques collectées​

Metric nameDescriptionUnit
channels.total.countNumber of channels
channel_name#channel.members.countNumber of members in the channel

Prérequis​

Le collecteur Centreon doit pouvoir joindre les serveurs Slack (slack.com) sur Internet sur le port TCP/443 (HTTPS). Il est possible de spécifier un proxy à utiliser le cas échéant.

ServiceAPI Token ?Scope
count-channelsYeschannels.read
count-membersYesusers.read
servicesNo

Installation​

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Slack-Restapi
  1. Sur l'interface Web de Centreon, installer le Pack Slack depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

  • Ajoutez un nouvel Hôte depuis la page Configuration > Hôtes
  • Complétez le champ "IP Address / DNS" en indiquant une IP localhost (par exemple 127.0.0.1)
  • Appliquez le Modèle d'Hôte App-Slack-Restapi-custom
MandatoryNameDescription
SLACKAPITOKENSlack API Token
SLACKAPIEXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

Par défaut, un Service de type "Global" sera déployé, supervisant l'ensemble des services Slack. Utilisez la fonctionnalité Service Discovery si vous souhaitez obtenir un Service par service Slack.

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis un collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_slack_restapi.pl \
--plugin='apps::slack::restapi::plugin' \
--mode=services \
--proxyurl='http://myproxy.mycompany.org:8080' \
--filter-name='Connections|Messaging' \
--warning-status='%{status} eq "active" and %{type} eq "incident"' \
--critical-status='%{status} eq "active" and %{type} eq "outage"' \
--verbose

La commande devrait retourner un message de sortie de la forme ci-dessous:

OK: All slack services are ok | 'slack.services.count'=2;;;0;
Service 'Connections' status is ok
Service 'Messaging' status is ok

Dans cet exemple, le Plugin récupère les statuts des services Slack (--plugin='apps::slack::restapi::plugin' --mode=services). On choisit ci-desus de n'afficher que le statut des services Connections et Messaging (--filter-name='Connections|Messaging').

Une alarme WARNING sera ainsi déclenchée si le statut d'un de ces services est signalée comme dégradée (--warning-status='%{status} eq "active" and %{type} eq "incident"'); l'alarme sera de type CRITICAL pour un service inaccessible (--critical-status='%{status} eq "active" and %{type} eq "outage"').

Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_slack_restapi.pl \
--plugin='apps::slack::restapi::plugin' \
--mode=services \
--help

Diagnostique​

Diagnostique des plugins