Udostępnij za pośrednictwem

Konfigurowanie ustawień protokołu SMTP

  • Artykuł

Z tego przewodnika dowiesz się, jak skonfigurować ustawienia protokołu SMTP (Simple Mail Transfer Protocol) w celu generowania alertów e-mail w usłudze Azure Managed Grafana. Powiadomienia ostrzegają użytkowników, gdy wystąpią niektóre scenariusze na pulpicie nawigacyjnym narzędzia Grafana.

Ustawienia SMTP można włączyć w istniejącym wystąpieniu usługi Azure Managed Grafana za pośrednictwem witryny Azure Portal i interfejsu wiersza polecenia platformy Azure. Włączanie ustawień SMTP podczas tworzenia nowego wystąpienia nie jest obecnie obsługiwane.

Wymagania wstępne

Aby wykonać kroki opisane w tym przewodniku, musisz mieć następujące elementy:

Włączanie i konfigurowanie ustawień protokołu SMTP

Wykonaj następujące kroki, aby aktywować ustawienia PROTOKOŁU SMTP, włączyć powiadomienia e-mail i skonfigurować punkt kontaktowy poczty e-mail w usłudze Azure Managed Grafana.

  1. W witrynie Azure Portal otwórz wystąpienie narzędzia Grafana i w obszarze Ustawienia wybierz pozycję Konfiguracja.

  2. Wybierz kartę Ustawienia poczty e-mail. Zrzut ekranu przedstawiający platformę Azure. Wybieranie karty Ustawienia SMTP.

  3. Przełącz ustawienia SMTP w pozycji , aby było wyświetlane ustawienie Włącz.

  4. Wyświetlane są ustawienia SMTP. Wypełnij formularz następującymi konfiguracjami:

    Parametr Przykład opis
    Host test.sendgrid.net:587 Wprowadź nazwę hosta serwera SMTP z portem.
    User administrator Wprowadź nazwę użytkownika uwierzytelniania SMTP.
    Hasło hasło Wprowadź hasło uwierzytelniania SMTP. Jeśli hasło zawiera ciąg "#" lub ";" zawija je w cudzysłowy potrójne.
    Z adresu user@domain.com Wprowadź adres e-mail używany podczas wysyłania wiadomości e-mail.
    Od nazwy Powiadomienie usługi Azure Managed Grafana Wprowadź nazwę używaną podczas wysyłania wiadomości e-mail. Wartość domyślna to "Azure Managed Grafana Notification", jeśli parametr nie jest podany lub pusty.
    Pomiń weryfikację Wyłącz To ustawienie określa, czy klient weryfikuje łańcuch certyfikatów serwera i nazwę hosta. Jeśli pozycja Pomiń weryfikację jest włączona, klient akceptuje dowolny certyfikat przedstawiony przez serwer i dowolną nazwę hosta w tym certyfikacie. W tym trybie protokół TLS jest podatny na ataki typu machine-in-the-middle, chyba że jest używana weryfikacja niestandardowa. Wartość domyślna to Disable (wyłączone). Więcej informacji.
    Zasady StartTLS OporportunisticStartTLS Dostępne są trzy opcje. Więcej informacji.
    • OpportunisticStartTLS oznacza, że transakcje SMTP są szyfrowane, jeśli system STARTTLS jest obsługiwany przez serwer SMTP. W przeciwnym razie komunikaty są wysyłane w przejrzysty sposób. Jest to ustawienie domyślne.
    • ObowiązkoweStartTLS oznacza, że transakcje SMTP muszą być szyfrowane. Transakcje SMTP są przerywane, chyba że system STARTTLS jest obsługiwany przez serwer SMTP.
    • NoStartTLS oznacza, że szyfrowanie jest wyłączone, a komunikaty są wysyłane w przejrzysty sposób.

  5. Wybierz pozycję Zapisz , aby zapisać ustawienia SMTP. Aktualizowanie może potrwać kilka minut.

    Zrzut ekranu przedstawiający platformę Azure. Karta Ustawienia poczty e-mail z nowymi danymi.

  6. Po zakończeniu procesu zostanie wyświetlony komunikat "Aktualizowanie wyborów. Aktualizacja powiodła się" zostanie wyświetlona w obszarze Powiadomienia platformy Azure. Na stronie Przegląd stan aprowizacji wystąpienia zmieni się na Aktualizowanie, a następnie po zakończeniu aktualizacji powodzenie.

Napiwek

Poniżej przedstawiono kilka wskazówek dotyczących prawidłowego konfigurowania protokołu SMTP:

  • W przypadku korzystania z konta służbowego poczty e-mail, takiego jak usługa Office 365, może być konieczne skontaktowanie się z administratorem poczty e-mail w celu włączenia uwierzytelniania SMTP (na przykład enable-smtp-auth-for-specific-mailboxes). Następnie powinno być możliwe utworzenie hasła aplikacji i użycie go jako ustawienia hasła SMTP.
  • W przypadku korzystania z osobistego konta e-mail, takiego jak Outlook lub Gmail, należy utworzyć hasło aplikacji i użyć go jako ustawienia hasła SMTP. Pamiętaj, że Twoje konto nie będzie działać w przypadku powiadomienia e-mail, jeśli jest ono skonfigurowane przy użyciu uwierzytelniania wieloskładnikowego.
  • Zaleca się sprawdzenie, czy konfiguracje SMTP działają zgodnie z oczekiwaniami przed zastosowaniem ich do zarządzanego obszaru roboczego narzędzia Grafana. Na przykład możesz użyć narzędzia open source, takiego jak swaks (Swiss Army Knife for SMTP), aby wysłać testową wiadomość e-mail przy użyciu konfiguracji SMTP, uruchamiając następujące polecenie w oknie terminalu: 
    # 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

Konfigurowanie punktów kontaktowych narzędzia Grafana i wysyłanie testowej wiadomości e-mail

Konfigurowanie punktów kontaktowych narzędzia Grafana odbywa się w portalu Grafana:

  1. W obszarze roboczym Azure Managed Grafana w obszarze Przegląd wybierz adres URL punktu końcowego.

  2. Przejdź do pozycji Alerting Contact points (Punkty kontaktu z alertami>).

  3. Wybierz pozycję Nowy punkt kontaktu lub Edytuj punkt kontaktu, aby zaktualizować istniejący punkt kontaktowy.

    Zrzut ekranu przedstawiający platformę Grafana. Aktualizowanie punktów kontaktowych.

  4. Dodaj lub zaktualizuj nazwę i typ punktu kontaktu.

  5. Wprowadź docelową wiadomość e-mail w obszarze Adresy i wybierz pozycję Testuj.

  6. Wybierz pozycję Wyślij powiadomienie testowe, aby wysłać powiadomienie ze wstępnie zdefiniowanym komunikatem testowym lub wybierz pozycję Niestandardowy , aby najpierw edytować wiadomość.

  7. Zostanie wyświetlone powiadomienie "Wysłany alert testowy", co oznacza, że konfiguracja poczty e-mail została pomyślnie skonfigurowana. Testowa wiadomość e-mail została wysłana na podany adres e-mail. Jeśli występuje błędna konfiguracja, zostanie wyświetlony komunikat o błędzie.

Wyłączanie ustawień PROTOKOŁU SMTP

Aby wyłączyć ustawienia SMTP, wykonaj następujące kroki.

  1. W witrynie Azure Portal przejdź do pozycji Ustawienia konfiguracji > poczty e-mail i wyłącz ustawienia SMTP, aby było wyświetlane ustawienie Wyłącz.
  2. Wybierz pozycję Zapisz , aby zweryfikować i rozpocząć aktualizowanie wystąpienia usługi Azure Managed Grafana.

Uwaga

Gdy użytkownicy wyłączą ustawienia SMTP, wszystkie poświadczenia SMTP zostaną usunięte z zaplecza. Narzędzie Azure Managed Grafana nie będzie utrwalać poświadczeń SMTP po wyłączeniu.

Komunikaty o błędach alertów narzędzia Grafana

W portalu Grafana można znaleźć listę wszystkich komunikatów o błędach alertów Grafana, które wystąpiły w obszarze Powiadomienia alertów>.

Poniżej przedstawiono niektóre typowe komunikaty o błędach, które mogą wystąpić:

  • "Uwierzytelnianie nie powiodło się: podana autoryzacja jest nieprawidłowa, wygasła lub odwołana". Narzędzie Grafana nie może nawiązać połączenia z serwerem SMTP. Sprawdź, czy hasło wprowadzone w ustawieniach SMTP w witrynie Azure Portal jest poprawne.
  • "Nie można wysłać alertu testowego: nie skonfigurowano protokołu SMTP". Protokół SMTP jest wyłączony. Otwórz wystąpienie usługi Azure Managed Grafana w witrynie Azure Portal i włącz ustawienia SMTP.

Następne kroki

W tym przewodniku z instrukcjami przedstawiono sposób konfigurowania ustawień protokołu Grafana SMTP. Aby dowiedzieć się, jak tworzyć raporty i wysyłać je pocztą e-mail do adresatów, zobacz Tworzenie pulpitów nawigacyjnych.