Aller au contenu principal

Asterisk VoIP SNMP

Contenu du Pack

Modèles

Le Plugin Pack Centreon Asterisk VoIP SNMP apporte 1 modèle d'hôte :

  • App-VoIP-Asterisk-SNMP-custom

Il apporte le Modèle de Service suivant :

AliasModèle de serviceDescriptionDéfaut
Channel-UsageApp-Voip-Asterisk-SNMP-Channel-UsageContrôle le nombre d'appels et canaux en coursX

Métriques & statuts collectés

MétriqueUnité
calls.active.countcount
calls.processed.countcount
channels.active.countcount

Prérequis

Configuration SNMP

Afin de superviser le serveur Asterisk, le SNMP v2 ou v3 doit être configuré comme indiqué sur la documentation officielle.

Flux réseau

La communication doit être possible sur le port UDP 161 depuis le collecteur Centreon vers le serveur Asterisk supervisé.

Installation

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Asterisk :
yum install centreon-plugin-Applications-Voip-Asterisk-Snmp
  1. Sur l'interface Web de Centreon, installer le Plugin Pack Asterisk VoIP SNMP depuis la page Configuration > Packs de plugins.

Configuration

Hôte

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre serveur Asterisk.
  • Appliquez le Modèle d'Hôte App-VoIP-Asterisk-SNMP-custom.

Si vous utilisez SNMP en version 3, vous devez configurer les paramètres spécifiques associés via la macro SNMPEXTRAOPTIONS.

ObligatoireMacroDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

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 votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (su - centreon-engine) :

/usr/lib/centreon/plugins//centreon_asterisk_snmp.pl \
--plugin=apps::voip::asterisk::snmp::plugin \
--mode=channel-usage \
--hostname='10.0.0.1' \
--snmp-version='2c' \
--snmp-community='my-snmp-community' \
--warning-channels-active='' \
--critical-channels-active='' \
--warning-calls-active='100' \
--critical-calls-active='200' \
--warning-calls-count='' \
--critical-calls-count='' \
--use-new-perfdata

La commande devrait retourner un message de sortie similaire à :

OK: channels active: 54 calls active: 73 calls count: 746 | 'channels.active.count'=54;;;0; 'calls.active.count'=73;0:100;0:200;0; 'calls.processed.count'=746;;;0; 

Dans cet exemple, une alarme de type WARNING sera déclenchée si le nombre d'appels en cours est supérieur à 100 (--warning-calls-active='100'); l'alarme sera de type CRITICAL au-delà de 200 (--critical-calls-active='200').

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande :

/usr/lib/centreon/plugins//centreon_asterisk_snmp.pl \
--plugin=apps::voip::asterisk::snmp::plugin \
--mode=channel-usage \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande :

/usr/lib/centreon/plugins//centreon_asterisk_snmp.pl \
--plugin=apps::voip::asterisk::snmp::plugin \
--list-mode

Diagnostic des erreurs communes

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des Plugins Centreon.