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

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:

• Slack
• PagerDuty
• Microsoft Teams
• Elementy webhook HTTP

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ń po przekroczeniu progu

Jeśli skonfigurowano próg dla zadania lub pułapu dla zadania, takich jak czas trwania lub metryki zaległości przetwarzania strumieniowego, możesz dodać powiadomienie e-mail lub systemowe, jeśli zadanie lub proces przekroczy skonfigurowany próg. Aby otrzymać powiadomienie o zadaniu lub zadaniu, które przekracza próg czasu trwania, kliknij pole wyboru Ostrzeżenie czasu trwania podczas dodawania lub edytowania powiadomienia. Aby otrzymać powiadomienie o zadaniu lub zadaniu, które przekracza metrykę listy prac przesyłania strumieniowego, kliknij pole wyboru dla listy prac przesyłania strumieniowego podczas dodawania lub edytowania powiadomienia.

Następujące informacje dotyczą metryk zaległości przesyłania strumieniowego:

• Powiadomienia są wysyłane, gdy średnia lista prac w okresie 10 minut przekracza zdefiniowany próg.
• Aby zapobiec nadmiernym komunikatom, usługa Azure Databricks czeka 30 minut przed ustaleniem, czy wysłać kolejną wiadomość. Lista prac pozostaje wysoka, ale aktualizacje będą otrzymywane w 30-minutowych odstępach czasu.

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.