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.

Portal

1. Öffnen Sie in der Azure-Portal Ihre Grafana-Instanz, und wählen Sie unter Einstellungen "Konfiguration" aus.

2. Wählen Sie die Registerkarte "E-Mail Einstellungen" aus.

3. Schalten Sie SMTP-Einstellungen ein, sodass "Aktivieren" angezeigt wird.

4. 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.

5. Wählen Sie " Speichern" aus, um die SMTP-Einstellungen zu speichern. Das Aktualisieren kann einige Minuten dauern.

   

6. 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.

Azure-Befehlszeilenschnittstelle

1. Azure Managed Grafana CLI Extension 1.1 oder höher ist erforderlich, um SMTP-Einstellungen zu aktivieren oder zu aktualisieren. Mit az extension update --name amg können Sie Ihre Erweiterung aktualisieren.

2. Führen Sie den Befehl "az grafana update " aus, um SMTP-Einstellungen für eine bestimmte Azure Managed Grafana-Instanz zu konfigurieren. Ersetzen Sie die Platzhalter durch Informationen aus Ihrer eigenen Instanz.

   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> \
   

   Parameter	Beispiel	BESCHREIBUNG
   --resource-group	my-resource-group	Geben Sie den Namen der Ressourcengruppe der Azure Managed Grafana-Instanz ein.
   --name	my-azure-managed-grafana	Geben Sie den Namen der Azure Managed Grafana-Instanz ein.
   --smtp	enabled	Geben Sie aktivierte SMTP-Einstellungen ein.
   --from-address	user@domain.com	Geben Sie die E-Mail-Adresse ein, die beim Senden von E-Mails verwendet wird.
   --from-name	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.
   --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.
   --password	Kennwort	Geben Sie das Kennwort der SMTP-Authentifizierung ein. Wenn das Kennwort "#" oder ";" enthält, wird es in dreifache Anführungszeichen eingeschlossen.
   --start-tls-policy	OpportunisticStartTLS	Die StartTLSPolicy-Einstellung der SMTP-Konfiguration. 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.
   --skip-verify	false	Diese Einstellung steuert, ob ein Client die Zertifikatkette und den Hostnamen des Servers überprüft. Wenn "-skip-verify" auf "true" festgelegt ist, akzeptiert der Client jedes vom Server und einem beliebigen Hostnamen in diesem Zertifikat angezeigte Zertifikat. In diesem Modus ist TLS anfällig für Computer-in-the-Middle-Angriffe, es sei denn, die benutzerdefinierte Überprüfung wird verwendet. Die Standardeinstellung lautet false. Weitere Informationen.

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@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
  

Konfigurieren von Grafana-Kontaktpunkten und Senden einer Test-E-Mail

Das Konfigurieren von Grafana-Kontaktpunkten erfolgt im Grafana-Portal:

1. Wählen Sie in Ihrem Azure Managed Grafana-Arbeitsbereich in der Übersicht die Endpunkt-URL aus.

2. Wechseln Sie zu Benachrichtigungskontaktpunkten>.

3. Wählen Sie "Neuer Kontaktpunkt " oder "Kontaktpunkt bearbeiten" aus, um einen vorhandenen Kontaktpunkt zu aktualisieren.

   

4. Fügen Sie den Namen und den Kontaktpunkttyp hinzu, oder aktualisieren Sie diesen.

5. Geben Sie unter "Adressen" eine Ziel-E-Mail ein, und wählen Sie "Testen" aus.

6. 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.

7. 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.

Portal

1. Wechseln Sie im Azure-Portal zu > "Konfigurations-E-Mail-Einstellungen", und deaktivieren Sie die SMTP-Einstellungen, sodass "Deaktivieren" angezeigt wird.
2. Wählen Sie " Speichern" aus, um die Azure Managed Grafana-Instanz zu überprüfen und zu starten.

Azure-Befehlszeilenschnittstelle

1. Azure Managed Grafana CLI Extension 1.1 oder höher ist erforderlich, um SMTP-Einstellungen zu deaktivieren. Mit az extension update --name amg können Sie Ihre Erweiterung aktualisieren.

2. Führen Sie den Befehl "az grafana update " aus, um SMTP-Einstellungen für eine bestimmte Azure Managed Grafana-Instanz zu konfigurieren. Ersetzen Sie die Platzhalter durch Informationen aus Ihrer eigenen Instanz.

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

   Parameter	Beispiel	BESCHREIBUNG
   --resource-group	my-resource-group	Geben Sie den Namen der Ressourcengruppe der Azure Managed Grafana-Instanz ein.
   --name	my-azure-managed-grafana	Geben Sie den Namen der Azure Managed Grafana-Instanz ein.
   --smtp	deaktiviert	Geben Sie zum Deaktivieren von SMTP-Einstellungen deaktiviert ein .

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".