Aller au contenu principal

Asterisk VoIP Server

Contenu du Pack​

Modèles​

Le connecteur de supervision 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 connecteur de supervision 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.