Aller au contenu principal

Asterisk VoIP Server

Contenu du Pack

Modèles

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

  • App-VoIP-Asterisk-AMI-custom

Il apporte les Modèles de Service suivants :

AliasModèle de serviceDescriptionDéfaut
Channel-UsageApp-Voip-Asterisk-AMI-Channel-UsageContrôle le nombre d'appels et canaux en coursX
Dahdi-StatusApp-Voip-Asterisk-AMI-Dahdi-StatusContrôle le statut des lignes 'dahdi'
Sip-Peers-UsageApp-Voip-Asterisk-AMI-Sip-Peers-UsageContrôle le statut des lien SIPsX

Métriques & statuts collectés

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

Prérequis

Asterisk Manager Interface (AMI)

Pour récuper les métriques et statuts du serveur Asterisk, un utilisateur avec les droits de lecture doit être configurer dans le fichier /etc/asterisk/manager.conf file. Plus d'informations dans la documentation officielle.

Installation

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Asterisk :
yum install centreon-plugin-Applications-Voip-Asterisk-Ami
  1. Sur l'interface Web de Centreon, installer le Plugin Pack Asterisk VoIP Server 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-AMI-custom.
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireMacroDescription
ASTERISKAMIEXTRAOPTIONSToute option supplémentaire que vous souhaitez ajouter à chaque ligne de commande (par exemple, l'option --verbose)
XASTERISKAMIPASSWORDMot de passe de l'utilisateur de l'AMI
ASTERISKAMIPORTPort de l'AMI
XASTERISKAMIUSERNAMEUtilisateur de l'AMI

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_ami.pl \
--plugin=apps::voip::asterisk::ami::plugin \
--mode=channel-usage \
--ami-hostname='10.0.0.1' \
--ami-port='' \
--ami-username='' \
--ami-password='' \
--warning-channels-active='' \
--critical-channels-active='' \
--warning-calls-active='100' \
--critical-calls-active='200' \
--warning-calls-count='' \
--critical-calls-count='' \
--warning-extcalls-active='' \
--critical-extcalls-active='' \
--verbose \
--use-new-perfdata

La commande devrait retourner un message de sortie similaire à :

OK: channels active: 54 calls active: 73 external calls active: 5 calls count: 746 | 'channels.active.count'=54;;;0; 'calls.active.count'=73;0:100;0:200;0; 'extcalls.active.count'=5;;;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_ami.pl \
--plugin=apps::voip::asterisk::ami::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_ami.pl \
--plugin=apps::voip::asterisk::ami::plugin \
--list-mode

Diagnostic des erreurs communes

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