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​
- Services
| Rule name | Description |
|---|---|
| App-Slack-Restapi-Services-Name | Discover services and monitor their status |
Métriques collectées​
- Count-channels
- Count-members
- Services
| Metric name | Description | Unit |
|---|---|---|
| channels.total.count | Number of channels | |
| channel_name#channel.members.count | Number of members in the channel |
| Metric name | Description | Unit |
|---|---|---|
| members.total.count | Number of users |
| Metric name | Description | Unit |
|---|---|---|
| slack.services.count | Number of services currently monitored | |
| status | Status of the service |
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.
| Service | API Token ? | Scope |
|---|---|---|
| count-channels | Yes | channels.read |
| count-members | Yes | users.read |
| services | No |
Installation​
- Online License
- Offline License
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Slack-Restapi
- Sur l'interface Web de Centreon, installer le Pack Slack depuis la page Configuration > Gestionnaire de connecteurs de supervision
1.Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Slack-Restapi
- Installer le RPM du Pack sur le serveur Centreon Central:
yum install centreon-pack-applications-slack-restapi
- 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
| Mandatory | Name | Description |
|---|---|---|
| SLACKAPITOKEN | Slack API Token | |
| SLACKAPIEXTRAOPTIONS | Any 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