Zarządzanie miejscami docelowymi powiadomień

Na tej stronie przedstawiono sposób tworzenia i konfigurowania miejsc docelowych powiadomień dla obszaru roboczego.

Powiadomienia systemowe to komunikaty informujące o tym, kiedy w przepływie pracy wystąpi zdarzenie uruchomienia (rozpoczęcie, powodzenie i niepowodzenie). Domyślnie powiadomienia są wysyłane na adresy e-mail użytkowników, ale administratorzy mogą konfigurować alternatywne miejsca powiadomień za pomocą webhooków lub aplikacji Databricks Genie dla Slacka i Microsoft Teams (Beta). Dzięki temu można tworzyć integracje sterowane zdarzeniami z Azure Databricks.

Administratorzy mogą również skonfigurować miejsca docelowe powiadomień w celu odbierania żądań dostępu od użytkowników obszaru roboczego, takich jak żądania uprawnień w obiektach katalogu Unity.

Aby zarządzać miejscami docelowymi powiadomień, musisz być administratorem obszaru roboczego Azure Databricks. Po skonfigurowaniu miejsca docelowego jest on dostępny dla wszystkich użytkowników.

Wymagania dotyczące sieci

W przypadku miejsc docelowych opartych na webhookach odbierający punkt końcowy musi spełniać następujące wymagania:

• Azure Databricks wymusza użycie protokołu HTTPS na potrzeby zabezpieczeń. Miejsce docelowe powiadomień musi używać certyfikatów Secure Sockets Layer (SSL) podpisanych przez zaufany urząd certyfikacji.
• Miejsce docelowe powiadomień musi dodać zarówno płaszczyznę sterowania obszaru roboczego, jak i wychodzące adresy IP płaszczyzny danych do listy dozwolonych:

  • Aby uzyskać informacje o adresach IP aplikacji internetowej płaszczyzny sterowania, zobacz IP adresy i domeny dla usług i zasobów Azure Databricks.

  • Informacje o wychodzących adresach IP płaszczyzny danych można znaleźć w pliku ip-ranges.json, publikowanym przez Azure Databricks. Wyszukaj plik, aby znaleźć region płaszczyzny danych obszaru roboczego i dopisz do listy dozwolonych odpowiednie adresy IP wychodzące w stosie sieciowym.

    Azure Databricks może aktualizować wychodzące adresy IP tak często, jak raz na 30 dni. Zaktualizowane adresy IP stają się aktywne dopiero po 60 dniach od publikacji, dlatego przed zamknięciem okna aktywacji przejrzyj plik regularnie i zaktualizuj listę dozwolonych.

    Aby śledzić zmiany między wydaniami, zapisz kolejne wersje pliku JSON i porównaj timestampSeconds wartość. Filtruj wpisy, w których:

    • Pole service to Databricks
    • Pole platform to azure
    • Pole type to outbound

Tworzenie nowego miejsca docelowego powiadomień

Aby skonfigurować nowe miejsce docelowe powiadomień

1. Kliknij swoją nazwę użytkownika na górnym pasku obszaru roboczego i wybierz pozycję Ustawienia z listy rozwijanej.
2. W sekcji Administrator obszaru roboczego kliknij kartę Powiadomienia.
3. Kliknij przycisk Zarządzaj.
4. Kliknij pozycję +Dodaj miejsce docelowe.
5. Wybierz typ miejsca docelowego. Obecnie obsługiwane są następujące miejsca docelowe:
   • Email
   • Slack
   • Webhook, z opcjonalną autoryzacją OAuth (Beta)
   • Microsoft Teams
   • PagerDuty
6. Skonfiguruj lokalizację docelową na podstawie typu.
7. Kliknij pozycję Utwórz.

Ładunki danych webhooka

Usługa, która wysyła powiadomienie, definiuje ładunek webhooka. Informacje o ładunkach danych wysyłanych przez zadania znajdziesz w HTTP webhook payloads. O ładunku, który powiadomienia SQL Databricks wysyłają po zmianie stanu, zobacz SQL alert webhook payload.

Użyj różnych poświadczeń dla każdego miejsca docelowego

Konfiguracja miejsca docelowego jest bezpiecznie przechowywana w sposób zaszyfrowany w obszarze roboczym Azure Databricks. W przypadku miejsc, gdzie trzeba podać adres URL lub dane uwierzytelniające, Azure Databricks zaleca używanie różnych danych uwierzytelniających dla każdego skonfigurowanego miejsca. Ogranicza to skutki naruszenia punktu końcowego strony trzeciej. Są to:

• Slack z użyciem webhooka: URL, na który wysyłane jest powiadomienie.
• Microsoft Teams za pomocą webhooka: adres URL, na który wysyłane jest powiadomienie.
• PagerDuty: klucz integracji używany do unikatowego kierowania powiadomień do usługi PagerDuty.
• Webhook: nazwa użytkownika i hasło do uwierzytelniania HTTP Basic lub identyfikator klienta i sekret klienta do uwierzytelniania OAuth (Beta).

Użycie różnych tajemnic dla każdej skonfigurowanej lokalizacji umożliwia indywidualne cofnięcie dostępu do poszczególnych lokalizacji powiadomień bez wpływu na działanie wszystkich innych lokalizacji w obszarze roboczym Azure Databricks.

Uwierzytelnianie OAuth dla miejsc docelowych webhooków

Użyj danych uwierzytelniających klienta OAuth 2.0, aby wysyłać powiadomienia do punktu końcowego, który wymaga tokena dostępu. Azure Databricks pobiera token od Twojego dostawcy tożsamości i używa go do uwierzytelnienia żądania powiadomienia.

Twój dostawca tożsamości musi wspierać przyznanie danych uwierzytelniających klienta. Zarówno odbiorca końcowa, jak i tokenowa muszą korzystać z HTTPS.

Aby utworzyć miejsce docelowe webhooka OAuth:

1. W ustawieniach>Powiadomienia kliknij Zarządzaj, a następnie +Dodaj cel.
2. Wpisz nazwę i wybierz Webhook dla Type.
3. W trybie uwierzytelniania wybierz OAuth.
4. Wprowadź następujące wartości:
   • URL: Punkt końcowy, który otrzymuje powiadomienia.
   • Identyfikator klienta i klucz tajny klienta: Poświadczenia wydane przez twojego dostawcę tożsamości.
   • Token endpoint URL: endpoint, z którego Azure Databricks uzyskuje token dostępu (access token).
   • Zakresy i Odbiorcy: Wprowadź te opcjonalne wartości, jeśli wymaga tego twój dostawca tożsamości. Oddziel wiele zakresów przecinkami.
5. Kliknij pozycję Utwórz.

Identyfikator klienta, sekret klienta oraz URL punktu końcowego tokena są wymagane razem. OAuth nie może być łączony z uwierzytelnianiem HTTP Basic.

Aby zweryfikować konfigurację, otwórz trzykropkowe menu w miejscu docelowym i kliknij Test. Azure Databricks dobija token dostępu i wysyła przykładowe powiadomienie. Jeśli test się nie powiedzie, sprawdź dane uwierzytelniające, zakresy, odbiorcę, uprawnienia odbiorcy oraz dostęp sieciowy do obu punktów końcowych.

Miejsce docelowe Slack

Aby skonfigurować miejsce Slack oparte na webhookach, postępuj zgodnie z instrukcjami w sekcji Przychodzące webhooki dla Slacka. Wklej wygenerowany adres URL do miejsca docelowego powiadomień Azure Databricks. Aby zamiast tego użyć aplikacji Databricks Genie, zobacz sekcję Miejsca docelowe aplikacji Genie dla Slack i Microsoft Teams.

Miejsca docelowe aplikacji Genie w Slack i Microsoft Teams

Użyj aplikacji Databricks Genie, aby połączyć obszar roboczy Slacka lub dzierżawę Microsoft Teams z obszarem roboczym usługi Azure Databricks. Następnie wybierz dostępny kanał jako miejsce powiadomienia.

Możesz korzystać z aplikacji Genie destinations z następującymi funkcjami:

• Alerty SQL: Slack i Microsoft Teams.
• Wnioski o dostęp do katalogu Unity: Slack i Microsoft Teams.
• Powiadomienia o modelowaniu dla punktów końcowych: Slack.

Stwórz miejsce docelowe w aplikacji Genie

Przed utworzeniem miejsca docelowego aplikacji Genie musisz zainstalować aplikację Databricks Genie dla Slacka lub Microsoft Teams, połączyć ją ze swoim obszarem roboczym Azure Databricks i dodać ją do kanału otrzymującego powiadomienia. Szczegóły dotyczące instalacji aplikacji i kroków łączenia można znaleźć w Slacku lub Microsoft Teams.

Aby utworzyć miejsce docelowe aplikacji Genie:

1. W ustawieniach>Powiadomienia kliknij Zarządzaj, a następnie +Dodaj cel.

2. W trybie Typ wybierz Slack lub Microsoft Teams, a następnie wybierz Używając aplikacji Databricks.

3. Wprowadź nazwę miejsca docelowego.

4. Wybierz przestrzeń roboczą lub najemcę oraz kanał:

   • Dla Slacka wybierz Slack Workspace i Channel.
   • W Microsoft Teams wybierz Tenant i Channel. Selektor najemcy identyfikuje każdego najemcę na podstawie ostatnich sześciu znaków jego identyfikatora najemcy.

   Jeśli nie są podłączone żadne przestrzenie robocze Slack ani dzierżawcy Microsoft Teams, kliknij odpowiednio Połącz przestrzeń roboczą Slack lub Podłącz dzierżawcę Teams i dokończ konfigurację aplikacji Genie. Wróć do formularza docelowego i kliknij Odśwież. Jeśli właśnie dodałeś aplikację Genie do kanału, kliknij Reload channels , aby zaktualizować listę kanałów.

5. Kliknij pozycję Utwórz.

Miejsce docelowe PagerDuty

Aby skonfigurować miejsce docelowe PagerDuty:

1. W PagerDuty dodaj integrację do swojej usługi i wybierz typ integracji Events API V2 .
2. Skopiuj klucz integracyjny, który generuje PagerDuty dla integracji.
3. W Azure Databricks wklej klucz integracyjny do miejsca powiadomienia PagerDuty.

Dodaj webhook do zadania

Po skonfigurowaniu miejsc docelowych można do nich uzyskać dostęp w ustawieniach powiadomień zadania. Aby uzyskać więcej informacji, zobacz Dodawanie powiadomień dotyczących zadania.

Każde zadanie obsługuje maksymalnie trzy systemowe miejsca docelowe na typ zdarzenia. Podczas konfigurowania powiadomień o zadaniu adresy e-mail muszą zostać wprowadzone ręcznie.

Ograniczenia

Miejsca docelowe powiadomień mają obecnie następujące ograniczenia:

• Miejsca docelowe powiadomień e-mail mają limit 1300 znaków na długości adresu adresata.
• W przypadku niestandardowych ciał powiadomień, miejsca niebędące e-mailami, takie jak Slack i Microsoft Teams, nie obsługują formatowania HTML. Niektóre miejsca docelowe powiadomień obsługują markdown.
• W przypadku zadań miejsca docelowe wiadomości e-mail muszą być ustawiane ręcznie w ustawieniach zadania.