Tutorial: Konfigurieren von Apache Ambari-E-Mail-Benachrichtigungen in Azure HDInsight

In diesem Tutorial konfigurieren Sie E-Mail-Benachrichtigungen in Apache Ambari am Beispiel von SendGrid. Apache Ambari vereinfacht die Verwaltung und Überwachung eines HDInsight-Clusters durch die Bereitstellung einer leicht zu bedienenden Webbenutzeroberfläche und REST-API. Ambari ist in HDInsight-Clustern enthalten und wird verwendet, um das Cluster zu überwachen und Änderungen an der Konfiguration vorzunehmen. SendGrid ist ein kostenloser cloudbasierter E-Mail-Dienst, der zuverlässige transaktionale E-Mail-Übermittlung, Skalierbarkeit und Echtzeitanalysen mit flexiblen APIs bietet, die die benutzerdefinierte Integration erleichtern. Kunden von Azure können monatlich 25.000 kostenlose E-Mails freischalten.

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

• SendGrid-E-Mail-Konto. Anweisungen finden Sie unter Senden von E-Mails in Azure mit SendGrid.
• Einen HDInsight-Cluster Weitere Informationen finden Sie unter Erstellen von Apache Hadoop-Clustern im Azure-Portal.

Abrufen eines SendGrid-API-Schlüssels

1. Navigieren Sie im Azure-Portal zu Ihrer SendGrid-Ressource.

2. Klicken Sie auf der Seite Übersicht auf SaaS-Konto auf der Website des Herausgebers öffnen, um die SendGrid-Webseite für Ihr Konto aufzurufen.

   

3. Wechseln Sie im linken Menü zu Einstellungen",und wählen Sie dann API-Schlüssel aus.

   

4. Um einen API-Schlüssel zu erstellen, wählen Sie API-Schlüssel erstellen aus. Kopieren Sie den API-Schlüssel als SMTP-Kennwort, um ihn später zu verwenden.

   

Konfigurieren einer Ambari-E-Mail-Benachrichtigung

1. Navigieren Sie in einem Webbrowser zu https://CLUSTERNAME.azurehdinsight.net/#/main/alerts, wobei CLUSTERNAME der Name Ihres Clusters ist.

2. Wählen Sie im Dropdownmenü Aktionen den Eintrag Manage Notifications (Benachrichtigungen verwalten) aus.

3. Wählen Sie im Fenster Manage Alert Notifications (Warnungsbenachrichtigungen verwalten) das Symbol + aus.

   

4. Geben Sie im Dialogfenster Create Alert Notification (Warnungsbenachrichtigung erstellen) die folgenden Informationen an:

   Eigenschaft	Beschreibung
   Name	Geben Sie einen Namen für die Benachrichtigung ein.
   Gruppen	Nehmen Sie die Konfiguration nach Bedarf vor.
   Severity	Nehmen Sie die Konfiguration nach Bedarf vor.
   Beschreibung	Optional.
   Methode	Übernehmen Sie die Option EMAIL.
   Email To (E-Mail an)	Geben Sie E-Mail-Adressen getrennt durch Kommata ein, an die Benachrichtigungen gesendet werden sollen.
   SMTP-Server	smtp.sendgrid.net
   SMTP-Port	Verwenden Sie 25 oder 587 für unverschlüsselte TLS-Verbindungen (Transport Layer Security).
   Email From (E-Mail von)	Geben Sie eine E-Mail-Adresse an. Die Adresse muss nicht echt sein.
   Authentifizierung verwenden	Aktiviere dieses Kontrollkästchen.
   Benutzername	Verwenden Sie apikey direkt, wenn Sie SendGrid verwenden.
   Kennwort	Geben Sie das Kennwort an, das Sie kopiert haben, als Sie den SendGrid-API-Schlüssel in Azure erstellt haben.
   Kennwortbestätigung	Geben Sie das Kennwort erneut ein.
   Start TLS (TLS starten)	Aktiviere dieses Kontrollkästchen.

   

5. Wählen Sie Speichern aus, um zum Bereich Manage Alert Notifications (Warnungsbenachrichtigungen verwalten) zurückzukehren.

6. Wählen Sie im Fenster Manage Alert Notifications (Warnungsbenachrichtigungen verwalten) die Option Schließen aus.

Häufig gestellte Fragen

In diesem Abschnitt wird ein Problem beschrieben, das möglicherweise auftritt.

Kein geeigneter Protokollfehler, wenn die Option „Start TLS“ aktiviert ist

Wenn Sie Start TLS (TLS starten) auf der Seite Create Alert Notification (Warnungsbenachrichtigung erstellen) auswählen und im Ambari-Serverprotokoll die Ausnahme No appropriate protocolerhalten:

1. Wechseln Sie zur Benutzeroberfläche von Apache Ambari.
2. Navigieren Sie zu Alerts>ManageNotifications>Edit (Edit Notification) (Warnungen > ManageNotifications > Bearbeiten (Benachrichtigung bearbeiten)).
3. Wählen Sie Add Property (Eigenschaft hinzufügen) aus.
4. Fügen Sie die neue Eigenschaft mail.smtp.ssl.protocol mit dem Wert TLSv1.2 hinzu.

Zugehöriger Inhalt

In diesem Tutorial haben Sie gelernt, wie Sie E-Mail-Benachrichtigungen in Apache Ambari mithilfe von SendGrid konfigurieren. Weitere Informationen zu Ambari finden Sie in den folgenden Artikeln:

• Verwalten von HDInsight-Clustern mithilfe der Apache Ambari-Webbenutzeroberfläche
• Erstellen einer Warnungsbenachrichtigung