Dodawanie wiadomości e-mail i powiadomień systemowych dotyczących zdarzeń zadań

  • Artykuł

Można monitorować przebiegi zadania i zadania, które są częścią tego zadania, konfigurując powiadomienia po uruchomieniu, pomyślnym zakończeniu, niepomyślnie lub jego czasie trwania przekracza skonfigurowany próg. Powiadomienia mogą być wysyłane na co najmniej jeden adres e-mail lub lokalizacje docelowe systemu, takie jak Slack, Microsoft Teams, PagerDuty lub dowolna usługa oparta na elementach webhook.

Konfigurowanie powiadomień systemowych

Uwaga

  • Dla każdego zadania lub zadania można skonfigurować maksymalnie trzy lokalizacje docelowe systemu dla każdego typu zdarzenia powiadomień.
  • Systemowe miejsca docelowe muszą być skonfigurowane przez administratora. Miejsca docelowe systemu można skonfigurować, wybierając opcję Utwórz nowe miejsce docelowe w oknie dialogowym Edytuj powiadomienia systemowe lub na stronie ustawień administratora.
  • Powiadomienia ustawione na poziomie zadania nie są wysyłane po ponownym pobraniu zadań, które zakończyły się niepowodzeniem. Aby otrzymywać powiadomienia o niepowodzeniu po każdym nieudanym zadaniu (w tym po każdej nieudanej próbie ponownej), użyj powiadomień o zadaniach. Aby dodać powiadomienia systemowe dotyczące przebiegów zadań, kliknij pozycję + Dodaj obok pozycji Powiadomienia w panelu zadań podczas dodawania lub edytowania zadania podrzędnego.
  • Zadanie, które zostało ukończone w Succeeded with failures stanie, jest uznawane za w stanie pomyślnym. Aby otrzymywać alerty dotyczące zadań zakończonych w tym stanie, należy wybrać pozycję Powodzenie podczas konfigurowania powiadomień.

Powiadomienia systemowe integrują się z popularnymi narzędziami powiadomień, w tym:

Aby dodać co najmniej jedno powiadomienie systemowe, gdy uruchomienia tego zadania mają zdarzenie z powiadomieniem, takie jak uruchomienie, ukończenie lub niepowodzenie zadania:

  1. W panelu Szczegóły zadania kliknij pozycję Edytuj powiadomienia.
  2. Kliknij pozycję Dodaj powiadomienie i wybierz lokalizację docelową systemu w polu Miejsce docelowe.
  3. W obszarze Wybierz miejsce docelowe systemu wybierz miejsce docelowe i kliknij pole wyboru dla każdego typu powiadomienia, które ma być wysyłane do tego miejsca docelowego.
  4. Aby dodać kolejne miejsce docelowe, kliknij ponownie pozycję Dodaj powiadomienie .
  5. Kliknij przycisk Potwierdź.

Ważne

Zawartość komunikatów slack i Microsoft Teams może ulec zmianie w przyszłych wersjach. Nie należy implementować klientów ani przetwarzania, które zależą od określonej zawartości lub formatowania tych komunikatów. Jeśli potrzebujesz określonego schematu lub formatowania powiadomień, usługa Azure Databricks zaleca skonfigurowanie elementu webhook zdefiniowanego przez użytkownika.

Konfigurowanie powiadomień e-mail

Uwaga

  • Powiadomienia ustawione na poziomie zadania nie są wysyłane po ponownym pobraniu zadań, które zakończyły się niepowodzeniem. Aby otrzymywać powiadomienia o niepowodzeniu po każdym nieudanym zadaniu (w tym po każdej nieudanej próbie ponownej), użyj powiadomień o zadaniach. Aby dodać powiadomienia e-mail dotyczące przebiegów zadań, kliknij pozycję + Dodaj obok pozycji Powiadomienia w panelu zadań podczas dodawania lub edytowania zadania zadania.
  • Zadanie, które zostało ukończone w Succeeded with failures stanie, jest uznawane za w stanie pomyślnym. Aby otrzymywać alerty dotyczące zadań zakończonych w tym stanie, należy wybrać pozycję Powodzenie podczas konfigurowania powiadomień.

Aby dodać co najmniej jeden adres e-mail, aby powiadomić o rozpoczęciu, zakończeniu lub niepodaniu tego zadania:

  1. W panelu Szczegóły zadania kliknij pozycję Edytuj powiadomienia.
  2. Kliknij pozycję Dodaj powiadomienie i wybierz pozycję Adres e-mail w polu Miejsce docelowe.
  3. Wprowadź adres e-mail i kliknij pole wyboru dla każdego typu powiadomienia do wysłania na ten adres.
  4. Aby wprowadzić inny adres e-mail powiadomienia, kliknij ponownie pozycję Dodaj powiadomienie .
  5. Kliknij przycisk Potwierdź.

Powiadomienia e-mail umożliwiają integrację z narzędziami, takimi jak Amazon SES i SNS.

Konfigurowanie powiadomień dla wolnych lub opóźnionych zadań

Jeśli skonfigurowano oczekiwany czas trwania zadania, możesz dodać wiadomość e-mail lub powiadomienie systemowe, jeśli zadanie przekroczy skonfigurowany czas trwania. Aby otrzymać powiadomienie o zadaniach przekraczających próg czasu trwania, kliknij pole wyboru Ostrzeżenie o czasie trwania podczas dodawania lub edytowania powiadomienia.

Odfiltruj powiadomienia dotyczące pominiętych lub anulowanych przebiegów

Możesz zmniejszyć liczbę wysyłanych powiadomień, odfiltrowując powiadomienia o pominięciu lub anulowaniu przebiegu. Aby filtrować powiadomienia, sprawdź powiadomienia wyciszenia dla pominiętych przebiegów lub powiadomienia wyciszenia dla anulowanych przebiegów podczas dodawania lub modyfikowania powiadomień e-mail lub powiadomień systemowych.

Uwaga

Wybranie opcji Wycisz powiadomienia dotyczące pominiętych przebiegów lub wyciszenie powiadomień dotyczących anulowanych uruchomień zadania nie powoduje odfiltrowania powiadomień skonfigurowanych dla zadań podrzędnych. Aby filtrować wszystkie powiadomienia dotyczące pominiętych lub anulowanych przebiegów, należy również odfiltrować wszystkie skonfigurowane powiadomienia na poziomie zadania.

Ładunki elementu webhook HTTP

Jeśli używasz elementu webhook HTTP do wysyłania powiadomień, poniżej przedstawiono przykładowe ładunki wysyłane przez usługę Azure Databricks do skonfigurowanego punktu końcowego.

Powiadomienie o zdarzeniu uruchamiania zadania:

{
  "event_type": "jobs.on_start",
  "workspace_id": "your_workspace_id",
  "run": {
    "run_id": "run_id"
  },
  "job": {
    "job_id": "job_id",
    "name": "job_name"
  }
}

Powiadomienie o zdarzeniu uruchamiania uruchomienia zadania:

{
  "event_type": "jobs.on_start",
  "workspace_id": "your_workspace_id",
  "task": {
    "task_key": "task_name"
  },
  "run": {
    "run_id": "run_id_of_task"
    "parent_run_id": "run_id_of_parent_job_run"
  },
  "job": {
    "job_id": "job_id",
    "name": "job_name"
  }
}

Podczas konfigurowania miejsc docelowych można skonfigurować elementy webhook dla następujących typów zdarzeń:

Kod zdarzenia Kiedy jest wysyłany?
jobs.on_start Uruchamia się przebieg.
jobs.on_success Przebieg zatrzymuje się i kończy działanie w stanie powodzenia lub powodzenia z powodu niepowodzenia.
jobs.on_failure Przebieg zostanie zatrzymany w stanie niepowodzenia.
jobs.on_duration_warning_threshold_exceeded Przebieg został uruchomiony przez więcej niż skonfigurowany oczekiwany czas trwania.