Konfigurieren von SMTP-Einstellungen
In diesem Leitfaden erfahren Sie, wie Sie SMTP-Einstellungen konfigurieren, um E-Mail-Benachrichtigungen in Azure Managed Grafana zu generieren. Benachrichtigungen benachrichtigen Benutzer, wenn einige bestimmte Szenarien auf einem Grafana-Dashboard auftreten.
SMTP-Einstellungen können über die Azure-Portal und die Azure CLI in einer vorhandenen Azure Managed Grafana-Instanz aktiviert werden. Das Aktivieren von SMTP-Einstellungen beim Erstellen einer neuen Instanz wird derzeit nicht unterstützt.
Voraussetzungen
Um die Schritte in diesem Leitfaden auszuführen, müssen Sie folgendes haben:
- Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
- Eine Azure Managed Grafana-Instanz im Standardplan. Wenn Sie noch keine haben, erstellen Sie eine neue Instanz.
- Ein SMTP-Server. Wenn Sie noch keins haben, sollten Sie die Verwendung der E-Mail-API von Twilio SendGrid für Azure in Betracht ziehen.
Aktivieren und Konfigurieren von SMTP-Einstellungen
Führen Sie die folgenden Schritte aus, um SMTP-Einstellungen zu aktivieren, E-Mail-Benachrichtigungen zu aktivieren und einen E-Mail-Kontaktpunkt in Azure Managed Grafana zu konfigurieren.
Öffnen Sie in der Azure-Portal Ihre Grafana-Instanz, und wählen Sie unter Einstellungen "Konfiguration" aus.
Wählen Sie die Registerkarte "E-Mail Einstellungen" aus.
Schalten Sie SMTP-Einstellungen ein, sodass "Aktivieren" angezeigt wird.
SMTP-Einstellungen werden angezeigt. Füllen Sie das Formular mit der folgenden Konfiguration aus:
Parameter Beispiel BESCHREIBUNG Host test.sendgrid.net:587 Geben Sie den SMTP-Serverhostnamen mit Port ein. User Admin Geben Sie den Namen des Benutzers der SMTP-Authentifizierung ein. Kennwort Kennwort Geben Sie das Kennwort der SMTP-Authentifizierung ein. Wenn das Kennwort "#" oder ";" enthält, wird es in dreifache Anführungszeichen eingeschlossen. Absenderadresse user@domain.com Geben Sie die E-Mail-Adresse ein, die beim Senden von E-Mails verwendet wird. Absendername Azure Managed Grafana Notification Geben Sie den Namen ein, der beim Senden von E-Mails verwendet wird. Der Standardwert ist "Azure Managed Grafana Notification", wenn der Parameter nicht angegeben oder leer ist. Überprüfen überspringen Deaktivieren Diese Einstellung steuert, ob ein Client die Zertifikatkette und den Hostnamen des Servers überprüft. Wenn "Überprüfen überspringen" aktiviert ist, akzeptiert der Client ein vom Server und einem beliebigen Hostnamen in diesem Zertifikat angezeigtes Zertifikat. In diesem Modus ist TLS anfällig für Computer-in-the-Middle-Angriffe, es sei denn, die benutzerdefinierte Überprüfung wird verwendet. Der Standardwert ist "Deaktivieren" (deaktiviert). Weitere Informationen. StartTLS-Richtlinie OpportunisticStartTLS Es gibt drei Optionen. Weitere Informationen. - OpportunisticStartTLS bedeutet, dass SMTP-Transaktionen verschlüsselt werden, wenn STARTTLS vom SMTP-Server unterstützt wird. Andernfalls werden Nachrichten im Klaren gesendet. Dies ist die Standardeinstellung.
- MandatoryStartTLS bedeutet, dass SMTP-Transaktionen verschlüsselt werden müssen. SMTP-Transaktionen werden abgebrochen, es sei denn, STARTTLS wird vom SMTP-Server unterstützt.
- NoStartTLS bedeutet, dass die Verschlüsselung deaktiviert ist und Nachrichten im Klaren gesendet werden.
Wählen Sie " Speichern" aus, um die SMTP-Einstellungen zu speichern. Das Aktualisieren kann einige Minuten dauern.
Sobald der Vorgang abgeschlossen ist, wird die Meldung "Die Auswahl wird aktualisiert. Update erfolgreich" wird in den Azure-Benachrichtigungen angezeigt. Auf der Seite "Übersicht" wird der Bereitstellungsstatus der Instanz auf "Aktualisieren" und dann nach Abschluss des Updates erfolgreich ausgeführt.
Tipp
Hier sind einige Tipps zum ordnungsgemäßen Konfigurieren von SMTP:
- Wenn Sie ein Geschäfts-E-Mail-Konto wie Office 365 verwenden, müssen Sie sich möglicherweise an Ihren E-Mail-Administrator wenden, um SMTP AUTH zu aktivieren (z . B. enable-smtp-auth-for-specific-mailboxes). Anschließend sollten Sie in der Lage sein, ein App-Kennwort zu erstellen und als SMTP-Kennworteinstellung zu verwenden.
- Wenn Sie ein persönliches E-Mail-Konto wie Outlook oder Gmail verwenden, sollten Sie ein App-Kennwort erstellen und als SMTP-Kennworteinstellung verwenden. Beachten Sie, dass Ihr Konto für E-Mail-Benachrichtigungen nicht funktioniert, wenn es mit mehrstufiger Authentifizierung konfiguriert ist.
- Es wird empfohlen, die SMTP-Konfigurationen so zu überprüfen, dass sie wie erwartet funktionieren, bevor Sie sie auf Ihren verwalteten Grafana-Arbeitsbereich anwenden. Sie können z. B. ein Open Source-Tool wie Swaks (Swiss Army Knife for SMTP) verwenden, um eine Test-E-Mail mithilfe der SMTP-Konfigurationen zu senden, indem Sie den folgenden Befehl in einem Terminalfenster ausführen:
# 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@contoso.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
Konfigurieren von Grafana-Kontaktpunkten und Senden einer Test-E-Mail
Das Konfigurieren von Grafana-Kontaktpunkten erfolgt im Grafana-Portal:
Wählen Sie in Ihrem Azure Managed Grafana-Arbeitsbereich in der Übersicht die Endpunkt-URL aus.
Wechseln Sie zu Benachrichtigungskontaktpunkten>.
Wählen Sie "Neuer Kontaktpunkt " oder "Kontaktpunkt bearbeiten" aus, um einen vorhandenen Kontaktpunkt zu aktualisieren.
Fügen Sie den Namen und den Kontaktpunkttyp hinzu, oder aktualisieren Sie diesen.
Geben Sie unter "Adressen" eine Ziel-E-Mail ein, und wählen Sie "Testen" aus.
Wählen Sie "Testbenachrichtigung senden" aus, um die Benachrichtigung mit der vordefinierten Testnachricht zu senden, oder wählen Sie "Benutzerdefiniert" aus, um die Nachricht zuerst zu bearbeiten.
Es wird eine Benachrichtigung "Gesendete Testbenachrichtigung" angezeigt, was bedeutet, dass die E-Mail-Einrichtung erfolgreich konfiguriert wurde. Die Test-E-Mail wurde an die angegebene E-Mail-Adresse gesendet. Wenn eine Fehlkonfiguration vorliegt, wird stattdessen eine Fehlermeldung angezeigt.
Deaktivieren von SMTP-Einstellungen
Führen Sie die folgenden Schritte aus, um SMTP-Einstellungen zu deaktivieren.
- Wechseln Sie im Azure-Portal zu > "Konfigurations-E-Mail-Einstellungen", und deaktivieren Sie die SMTP-Einstellungen, sodass "Deaktivieren" angezeigt wird.
- Wählen Sie " Speichern" aus, um die Azure Managed Grafana-Instanz zu überprüfen und zu starten.
Hinweis
Wenn benutzer SMTP-Einstellungen deaktivieren, werden alle SMTP-Anmeldeinformationen aus dem Back-End entfernt. Azure Managed Grafana speichert keine SMTP-Anmeldeinformationen, wenn sie deaktiviert sind.
Grafana alarmiert Fehlermeldungen
Im Grafana-Portal finden Sie eine Liste aller Grafana-Warnungsfehlermeldungen, die in Warnungsbenachrichtigungen >aufgetreten sind.
Im Folgenden finden Sie einige häufig auftretende Fehlermeldungen:
- "Fehler bei der Authentifizierung: Die bereitgestellte Autorisierungserteilung ist ungültig, abgelaufen oder widerrufen". Grafana konnte keine Verbindung mit dem SMTP-Server herstellen. Überprüfen Sie, ob das in den SMTP-Einstellungen in der Azure-Portal eingegebene Kennwort korrekt ist.
- "Fehler beim Senden der Testbenachrichtigung: SMTP nicht konfiguriert". SMTP ist deaktiviert. Öffnen Sie die Azure Managed Grafana-Instanz in der Azure-Portal, und aktivieren Sie SMTP-Einstellungen.
Nächste Schritte
In dieser Anleitung haben Sie erfahren, wie Sie Grafana SMTP-Einstellungen konfigurieren. Informationen zum Erstellen von Berichten und E-Mails an Empfänger finden Sie unter "Erstellen von Dashboards".