Aggiungere notifiche di posta elettronica e di sistema per gli eventi del processo

È possibile monitorare le esecuzioni di un processo e le attività che fanno parte di tale processo configurando le notifiche all'avvio di un'esecuzione, completa correttamente, ha esito negativo o la relativa durata supera una soglia configurata. Le notifiche possono essere inviate a uno o più indirizzi di posta elettronica o destinazioni di sistema, ad esempio Slack, Microsoft Teams, PagerDuty o qualsiasi servizio basato su webhook.

Configurare le notifiche di sistema

Nota

• Per ogni processo o attività, è possibile configurare un massimo di tre destinazioni di sistema per ogni tipo di evento di notifica.
• Un amministratore deve configurare le destinazioni di sistema. Le destinazioni di sistema vengono configurate selezionando Crea nuova destinazione nella finestra di dialogo Modifica notifiche di sistema o nella pagina delle impostazioni di amministrazione.
• Le notifiche impostate a livello di processo non vengono inviate quando vengono ritentate le attività non riuscite. Per ricevere una notifica di errore dopo ogni attività non riuscita (inclusi tutti i tentativi non riusciti), utilizzare invece le notifiche dell'attività. Per aggiungere notifiche di sistema per le esecuzioni di attività, fare clic su + Aggiungi accanto a Notifiche nel pannello attività quando si aggiunge o modifica un'attività di processo.
• Un processo completato in uno Succeeded with failures stato viene considerato in uno stato di esito positivo. Per ricevere avvisi per i processi completati in questo stato, è necessario selezionare Operazione riuscita quando si configurano le notifiche.

Le notifiche di sistema si integrano con gli strumenti di notifica più diffusi, tra cui:

• Slack
• PagerDuty
• Microsoft Teams
• Webhook HTTP

Per aggiungere una o più notifiche di sistema quando l'esecuzione di questo processo ha un evento notificabile, ad esempio l'avvio, il completamento o l'errore di un processo:

1. Nel pannello Dettagli processo per il processo fare clic su Modifica notifiche.
2. Fare clic su Aggiungi notifica e selezionare una destinazione di sistema in Destinazione.
3. In Selezionare una destinazione di sistema selezionare una destinazione e fare clic sulla casella di controllo per ogni tipo di notifica da inviare a tale destinazione.
4. Per aggiungere un'altra destinazione, fare di nuovo clic su Aggiungi notifica .
5. Fare clic su Conferma.

Importante

Il contenuto dei messaggi di Slack e Microsoft Teams potrebbe cambiare nelle versioni future. Non è consigliabile implementare client o elaborazioni che dipendono dal contenuto o dalla formattazione specifici di questi messaggi. Se è necessario uno schema o una formattazione specifici per le notifiche, Azure Databricks consiglia di configurare un webhook definito dall'utente.

Configurare le notifiche tramite posta elettronica

Nota

• Le notifiche impostate a livello di processo non vengono inviate quando vengono ritentate le attività non riuscite. Per ricevere una notifica di errore dopo ogni attività non riuscita (inclusi tutti i tentativi non riusciti), utilizzare invece le notifiche dell'attività. Per aggiungere notifiche tramite posta elettronica per le esecuzioni di attività, fare clic su + Aggiungi accanto a Notifiche nel pannello attività quando si aggiunge o modifica un'attività di processo.
• Un processo completato in uno Succeeded with failures stato viene considerato in uno stato di esito positivo. Per ricevere avvisi per i processi completati in questo stato, è necessario selezionare Operazione riuscita quando si configurano le notifiche.

Per aggiungere uno o più indirizzi di posta elettronica per notificare all'avvio, al completamento o all'esito negativo dell'esecuzione del processo:

1. Nel pannello Dettagli processo per il processo fare clic su Modifica notifiche.
2. Fare clic su Aggiungi notifica e selezionare Indirizzo di posta elettronica in Destinazione.
3. Immettere un indirizzo di posta elettronica e fare clic sulla casella di controllo per ogni tipo di notifica da inviare a tale indirizzo.
4. Per immettere un altro indirizzo di posta elettronica per la notifica, fare di nuovo clic su Aggiungi notifica .
5. Fare clic su Conferma.

È possibile usare le notifiche tramite posta elettronica per l'integrazione con strumenti come Amazon edizione Standard S e SNS.

Configurare le notifiche per processi in esecuzione lenta o in ritardo

Se è stata configurata una durata prevista per un processo, è possibile aggiungere un messaggio di posta elettronica o una notifica di sistema se il processo supera la durata configurata. Per ricevere una notifica per i processi che superano la soglia di durata, fare clic sulla casella di controllo Avviso durata quando si aggiunge o modifica una notifica.

Filtrare le notifiche per le esecuzioni ignorate o annullate

È possibile ridurre il numero di notifiche inviate filtrando le notifiche quando un'esecuzione viene ignorata o annullata. Per filtrare le notifiche, selezionare Disattiva notifiche per le esecuzioni ignorate o Disattiva notifiche per le esecuzioni annullate quando si aggiungono o modificano notifiche tramite posta elettronica o notifiche di sistema.

Nota

Selezionando Disattiva notifiche per le esecuzioni ignorate o Disattiva notifiche per le esecuzioni annullate per un processo non filtra le notifiche configurate per le attività di processo. Per filtrare tutte le notifiche per le esecuzioni ignorate o annullate, è necessario filtrare anche eventuali notifiche a livello di attività configurate.

Payload webhook HTTP

Se si usa un webhook HTTP per inviare notifiche, di seguito sono riportati i payload di esempio inviati da Azure Databricks all'endpoint configurato.

Notifica per un evento di avvio dell'esecuzione del processo:

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

Notifica per un evento di avvio dell'esecuzione dell'attività:

{
  "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"
  }
}

Quando si configurano le destinazioni, i webhook possono essere configurati per i tipi di evento seguenti:

Codice evento	Quando viene inviato?
jobs.on_start	Viene avviata un'esecuzione.
jobs.on_success	Un'esecuzione si arresta e viene completata in uno stato di esito positivo o riuscito con errori.
jobs.on_failure	Un'esecuzione si arresta in uno stato non riuscito.
jobs.on_duration_warning_threshold_exceeded	Un'esecuzione è stata eseguita per più della durata prevista configurata.