vManage : Configurer les notifications par e-mail d'alarme

Introduction

Ce document décrit comment configurer et envoyer des notifications par e-mail via vManage pour les événements qui se produisent sur le réseau.

Conditions préalables

Conditions requises

Cisco recommande que vous ayez connaissance de vManage et que vous vous assuriez qu'il doit être 18.3.0 et supérieur. 

Components Used

Ce document n'est pas limité à des versions de matériel et de logiciel spécifiques.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configuration

Ces étapes doivent être configurées afin d'activer les notifications par e-mail.

1. Modifiez les notifications par e-mail à partir de Administration > Settings. 

2. Configurez les notifications par e-mail à partir de Monitor > Alarms. 

Pour l'étape 1., à partir de vManage Dashboard, accédez à Administration > Settings > Email Notifications > Edit et configurez la section Enable Email Notifications. Voici un exemple de capture d'écran.

Vous pouvez sélectionner l'adresse De selon votre choix, mais le nom de domaine doit correspondre au serveur de messagerie. Par exemple, <..username..>@cisco.com et l’adresse de réponse sont noreply@cisco.com. Parce que, s'il y a une réponse, vManage ne sera pas capturé. Ce scénario est similaire aux e-mails générés automatiquement qui contiennent une adresse sans réponse.

Pour l'étape 2., cela inclut les sous-étapes telles que Gravité, Nom d'alarme, Liste de courriels et URL de connexion Web.

Exemples de captures d'écran :

  

Les Webhooks sont utilisés par un système externe afin d'informer le système local d'un événement ou d'une mise à jour donné. Ils sont comme des appels API

dans la direction opposée. Le POST HTTP peut être envoyé de vManage à n'importe quel service qui écoute ce message. Par exemple, lorsque vous configurez un webhook dans vManage qui touche un morceau de code « sans serveur » dans AWS, il déclenche un événement pour mettre en page un groupe de personnes dans l'organisation. Il existe plusieurs services en ligne auxquels vous pouvez vous connecter pour effectuer ces tâches. Reportez-vous à https://testwebhooks.com/.

Un autre exemple est de créer quelque chose dans slack afin de recevoir des webhooks vManage. Reportez-vous à https://api.slack.com/incoming-webhooks

Seuil de messagerie

Il existe un champ de seuil dans la page Notifications par e-mail. Accédez à Monitor> Alarms> Email Notifications.

Ce champ indique le nombre d'e-mails que vous souhaitez recevoir par minute. Par défaut, un maximum de 5 e-mails par minute. Lorsque les e-mails dépassent ce seuil, vous recevez le message tel qu'illustré dans l'image. Les e-mails ne seront pas envoyés pendant 5 minutes, puis le seuil commencera à nouveau.

Le reste du document capture l'utilisation des alertes par e-mail.

Journaux

Vérifiez les journaux vManage : /var/log/nms/vmanage-server.log

Vérification

Vérifiez via vManage-Dashboard. Naviguez jusqu'à Monitor > Audit Log comme indiqué dans l'image. 

Vérifier l'e-mail 

Dépannage

Cette section fournit des informations que vous pouvez utiliser pour dépanner votre configuration.

Vérifier le journal d'audit :

Actuellement, il y a un problème où vManage Audit-Log pourrait dire que le courrier électronique a peut-être été envoyé, mais en fait, le courrier électronique n'est pas reçu. Vous pouvez le vérifier à l'aide du fichier in/var/log/nms/vmanage-server.log comme indiqué dans l'image.

Le VIP-42227 est ouvert pour suivre ce problème. Il n'y a pas de plan à résoudre. 

Toutes les alertes par e-mail ne sont pas générées de manière cohérente :

Tout d'abord, cela dépend du nombre d'alarmes générées pour l'ensemble des événements. vManage tente de combiner des événements à une alarme s'ils sont liés. Sinon, il génère plusieurs alarmes en même temps. Pour chaque alarme générée et chaque règle, il y aura un e-mail. La notification par e-mail est liée aux alarmes, et non aux événements.

Deuxièmement, si dans la première règle, vous voyez qu'il y a plusieurs alarmes, il n'y a qu'un seul e-mail envoyé pour cette correspondance de règle. Si un client souhaite recevoir plusieurs e-mails pour chaque événement, le une règle individuelle doit être définie.

« Nom d'utilisateur et mot de passe non acceptés » dans vmanage-server.logs :

Comme le montre la capture d'écran, vous pouvez voir l'erreur « Nom d'utilisateur et Mot de passe non acceptés. En savoir plus à

535 5,7,8https://support.google.com/mail/?p=BadCredentials m92sm8305479qte.50 - gsmtp. » Malgré cela, il peut afficher dans le journal d'audit vManage que l'e-mail a effectivement été envoyé.

Par défaut, les comptes Gmail sont hautement sécurisés. Lorsque vous utilisez Gmail SMTP à partir d'un outil autre que Gmail, le courrier électronique est bloqué. Afin de tester ceci, procédez comme suit : 

1. Connectez-vous à Gmail.
2. Accédez à l'URL ashttps://www.google.com/settings/security/lesssecureapps.
3. Sélectionnez Activer.

Les notifications par e-mail doivent ensuite être reçues sur le compte e-mail spécifié. 

Échec de l'envoi des notifications par e-mail :

Dans certains cas, vous pouvez voir que le message généré est refusé par le serveur de messagerie. Cela peut être le cas si la configuration de compte déjà fournie est incorrecte ou si l'accès n'est pas accordé. Dans les journaux, vous pouvez voir ce message : SendAsDeniedException.

03-Dec-2018 15:46:37,177 CST ERROR [ts_vManage][EmailNotiUtil] (default task-84) |default| Sending email notification failed: 554 5.2.0 
STOREDRV.Submission.Exception:SendAsDeniedException.MapiExceptionSendAsDenied; Failed to process message due to a permanent exception
with message Cannot submit message.

Un autre exemple d'utilisation est que le nombre de messages électroniques que les utilisateurs peuvent envoyer par jour varie du serveur SMTP au serveur. Vous pouvez voir ce message de journal dans vManage :

"Sending email notification failed : com.sun.mail.smtp.SMTPSendFailedException: 550 5.4.5 Daily user sending quota exceeded."

Par exemple, il y a une limite s'il s'agit de Gmail: https://support.google.com/a/answer/166852.

Autres contrôles de validation

Autres journaux des erreurs

 L'e-mail sera envoyé à partir de vManage IP (Public-IP of VPN0 Transport Interface).