Configurer les paramètres SMTP

Dans ce guide, vous allez apprendre à configurer les paramètres SMTP pour générer des alertes par e-mail dans Azure Managed Grafana. Les notifications alertent les utilisateurs quand certains scénarios donnés se produisent sur un tableau de bord Grafana.

Les paramètres SMTP peuvent être activés sur une instance Azure Managed Grafana existante via les Portail Azure et Azure CLI. L’activation des paramètres SMTP lors de la création d’une nouvelle instance n’est actuellement pas prise en charge.

Prérequis

Pour suivre les étapes décrites dans ce guide, vous devez disposer des informations suivantes :

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Instance Azure Managed Grafana dans le plan Standard. Si vous n’en avez pas encore, créez une instance.
• Un serveur SMTP. Si vous n’en avez pas encore, vous pouvez envisager d’utiliser l’API de messagerie de Twilio SendGrid pour Azure.

Activer et configurer les paramètres SMTP

Suivez ces étapes pour activer les paramètres SMTP, activer Notifications par e-mail et configurer un point de contact de messagerie dans Azure Managed Grafana.

Portail

1. Dans le Portail Azure, ouvrez votre instance Grafana et, sous Paramètres, sélectionnez Configuration.

2. Sélectionnez l’onglet Courrier électronique Paramètres.

3. Activez la Paramètres SMTP pour que l’activation s’affiche.

4. Les paramètres SMTP s’affichent. Remplissez le formulaire avec la configuration suivante :

   Paramètre	Exemple	Description
   Host	test.sendgrid.net:587	Entrez le nom d’hôte du serveur SMTP avec le port.
   Utilisateur	admin	Entrez le nom de l’utilisateur de l’authentification SMTP.
   Mot de passe	mot de passe	Entrez le mot de passe de l’authentification SMTP. Si le mot de passe contient « # » ou « ; » encapsulez-le entre guillemets triples.
   Adresse d'expéditeur	user@domain.com	Entrez l’adresse e-mail utilisée lors de l’envoi d’e-mails.
   Nom de l’expéditeur	Azure Managed Grafana Notification	Entrez le nom utilisé lors de l’envoi d’e-mails. La valeur par défaut est « Notification Azure Managed Grafana » si le paramètre n’est pas donné ou vide.
   Ignorer la vérification	Désactiver	Ce paramètre contrôle si un client vérifie si la chaîne de certificats et le nom d’hôte du serveur sont vérifiés. Si Skip Verify is Enable, client accepte tout certificat présenté par le serveur et n’importe quel nom d’hôte dans ce certificat. Dans ce mode, TLS est susceptible d’attaquer l’ordinateur dans le milieu, sauf si la vérification personnalisée est utilisée. La valeur par défaut est Disable (désactivé). Informations complémentaires.
   Stratégie StartTLS	OpportunisticStartTLS	Il existe trois options. Informations complémentaires. OpportunisticStartTLS signifie que les transactions SMTP sont chiffrées si STARTTLS est pris en charge par le serveur SMTP. Sinon, les messages sont envoyés en clair. Il s’agit du paramètre par défaut. ObligatoireStartTLS signifie que les transactions SMTP doivent être chiffrées. Les transactions SMTP sont abandonnées, sauf si STARTTLS est pris en charge par le serveur SMTP. NoStartTLS signifie que le chiffrement est désactivé et que les messages sont envoyés en clair.

5. Sélectionnez Enregistrer pour enregistrer les paramètres SMTP. La mise à jour peut prendre quelques minutes.

   

6. Une fois le processus terminé, le message « Mise à jour des sélections. La mise à jour a réussi » s’affiche dans les notifications Azure. Dans la page Vue d’ensemble , l’état d’approvisionnement de l’instance devient Mise à jour, puis Réussi une fois la mise à jour terminée.

Azure CLI

1. L’extension CLI Azure Managed Grafana 1.1 ou ultérieure est nécessaire pour activer ou mettre à jour les paramètres SMTP. Pour mettre à jour votre extension, exécutez az extension update --name amg.

2. Exécutez la commande az grafana update pour configurer les paramètres SMTP pour une instance Azure Managed Grafana donnée. Remplacez les espaces réservés par des informations de votre propre instance.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp enabled \
       --from-address <from-address> \
       --from-name <from-name> \
       --host "<host>" \
       --user <user> \
       --password "<password>" \
       --start-tls-policy <start-TLS-policy> \
       --skip-verify <true-or-false> \
   

   Paramètre	Exemple	Description
   --resource-group	my-resource-group	Entrez le nom du groupe de ressources de l’instance Azure Managed Grafana.
   --name	my-azure-managed-grafana	Entrez le nom de l’instance Azure Managed Grafana.
   --smtp	activé	Entrez activé pour désactiver les paramètres SMTP.
   --from-address	user@domain.com	Entrez l’adresse e-mail utilisée lors de l’envoi d’e-mails.
   --from-name	Azure Managed Grafana Notification	Entrez le nom utilisé lors de l’envoi d’e-mails. La valeur par défaut est « Notification Azure Managed Grafana » si le paramètre n’est pas donné ou vide.
   --host	test.sendgrid.net:587	Entrez le nom d’hôte du serveur SMTP avec le port.
   --user	admin	Entrez le nom de l’utilisateur de l’authentification SMTP.
   --password	mot de passe	Entrez le mot de passe de l’authentification SMTP. Si le mot de passe contient « # » ou « ; » encapsulez-le entre guillemets triples.
   --start-tls-policy	OpportunisticStartTLS	Paramètre StartTLSPolicy de la configuration SMTP. Il existe trois options. Informations complémentaires. OpportunisticStartTLS signifie que les transactions SMTP sont chiffrées si STARTTLS est pris en charge par le serveur SMTP. Sinon, les messages sont envoyés en clair. Il s’agit du paramètre par défaut. ObligatoireStartTLS signifie que les transactions SMTP doivent être chiffrées. Les transactions SMTP sont abandonnées, sauf si STARTTLS est pris en charge par le serveur SMTP. NoStartTLS signifie que le chiffrement est désactivé et que les messages sont envoyés en clair.
   --skip-verify	false	Ce paramètre contrôle si un client vérifie si la chaîne de certificats et le nom d’hôte du serveur sont vérifiés. Si --skip-verify a la valeur true, le client accepte tout certificat présenté par le serveur et tout nom d’hôte dans ce certificat. Dans ce mode, TLS est susceptible d’attaquer l’ordinateur dans le milieu, sauf si la vérification personnalisée est utilisée. La valeur par défaut est false. Informations complémentaires.

Conseil

Voici quelques conseils pour configurer correctement SMTP :

• Lorsque vous utilisez un compte de messagerie professionnel tel que Bureau 365, vous devrez peut-être contacter votre administrateur de messagerie pour activer l’authentification SMTP (par exemple, enable-smtp-auth-for-specific-mailboxes). Vous devez être en mesure de créer un mot de passe d’application par la suite et de l’utiliser comme paramètre de mot de passe SMTP.
• Lorsque vous utilisez un compte de messagerie personnel tel qu’Outlook ou Gmail, vous devez créer un mot de passe d’application et l’utiliser comme paramètre de mot de passe SMTP. Notez que votre compte ne fonctionnera pas pour la notification par e-mail s’il est configuré avec l’authentification multifacteur.
• Il est recommandé de vérifier que les configurations SMTP fonctionnent comme prévu avant de les appliquer à votre espace de travail Managed Grafana. Par exemple, vous pouvez utiliser un outil code source ouvert tel que swaks (Swiss Army Knife for SMTP) pour envoyer un e-mail de test à l’aide des configurations SMTP en exécutant la commande suivante dans une fenêtre de terminal :

  # fill in all the empty values for the following parameters
  host="" # SMTP host name with port separated by a ":", e.g. smtp.office365.com:587
  user="" # email address, e.g. team1@microsoft.com
  password="" # password
  fromAddress="" # source email address (usually the same as user above), e.g. team1@contoso.com
  toAddress="" # destination email address, e.g. team2@contoso.com
  ehlo="" # grafana endpoint, e.g. team1-ftbghja6ekeybng8.wcus.grafana.azure.com
  
  header="Subject:Test"
  body="Testing!"
  
  # test SMTP connection by sending an email
  swaks --auth -tls \
      --server $host \
      --auth-user $user \
      --auth-password $password \
      --from $fromAddress \
      --to $toAddress \
      --ehlo $ehlo \
      --header $header \
      --body $body
  

Configurer les points de contact Grafana et envoyer un e-mail de test

La configuration des points de contact Grafana est effectuée dans le portail Grafana :

1. Dans votre espace de travail Azure Managed Grafana, dans Vue d’ensemble, sélectionnez l’URL du point de terminaison .

2. Accédez aux points de contact d’alerte>.

3. Sélectionnez Nouveau point de contact ou Modifier le point de contact pour mettre à jour un point de contact existant.

   

4. Ajoutez ou mettez à jour le type de point de contact et de nom.

5. Entrez un e-mail de destination sous Adresses, puis sélectionnez Test.

6. Sélectionnez Envoyer une notification de test pour envoyer la notification avec le message de test prédéfini ou sélectionnez Personnalisé pour commencer à modifier le message.

7. Une notification « Alerte de test envoyée » s’affiche, ce qui signifie que la configuration de l’e-mail a été correctement configurée. L’e-mail de test a été envoyé à l’adresse e-mail fournie. S’il existe une configuration incorrecte, un message d’erreur s’affiche à la place.

Désactiver les paramètres SMTP

Pour désactiver les paramètres SMTP, procédez comme suit.

Portail

1. Dans le Portail Azure, accédez à Configuration Email Paramètres et désactivez le Paramètres SMTP pour que La désactivation> s’affiche.
2. Sélectionnez Enregistrer pour valider et commencer à mettre à jour l’instance Azure Managed Grafana.

Azure CLI

1. L’extension CLI Azure Managed Grafana 1.1 ou ultérieure est nécessaire pour désactiver les paramètres SMTP. Pour mettre à jour votre extension, exécutez az extension update --name amg.

2. Exécutez la commande az grafana update pour configurer les paramètres SMTP pour une instance Azure Managed Grafana donnée. Remplacez les espaces réservés par des informations de votre propre instance.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp disabled
   

   Paramètre	Exemple	Description
   --resource-group	my-resource-group	Entrez le nom du groupe de ressources de l’instance Azure Managed Grafana.
   --name	my-azure-managed-grafana	Entrez le nom de l’instance Azure Managed Grafana.
   --smtp	disabled	Entrez désactivé pour désactiver les paramètres SMTP.

Remarque

Lorsqu’un utilisateur désactive les paramètres SMTP, toutes les informations d’identification SMTP sont supprimées du serveur principal. Azure Managed Grafana ne conserve pas les informations d’identification SMTP quand elle est désactivée.

Messages d’erreur d’alerte Grafana

Dans le portail Grafana, vous trouverez la liste de tous les messages d’erreur d’alerte Grafana qui se sont produits dans les notifications d’alerte>.

Voici quelques messages d’erreur courants que vous pouvez rencontrer :

• « Échec de l’authentification : l’octroi d’autorisation fourni n’est pas valide, expiré ou révoqué ». Grafana n’a pas pu se connecter au serveur SMTP. Vérifiez si le mot de passe entré dans les paramètres SMTP de l’Portail Azure est correct.
• « Échec de l’envoi d’une alerte de test : SMTP non configuré ». SMTP est désactivé. Ouvrez l’instance Azure Managed Grafana dans le Portail Azure et activez les paramètres SMTP.

Étapes suivantes

Dans ce guide pratique, vous avez appris à configurer les paramètres SMTP Grafana. Pour savoir comment créer des rapports et les envoyer par e-mail aux destinataires, consultez Créer des tableaux de bord.