Condividi tramite

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

  • Articolo

È possibile monitorare le esecuzioni di un processo e le attività che ne fanno parte, configurando notifiche quando un'esecuzione viene avviata, completata con successo, fallita o la sua durata supera una soglia configurata. Le notifiche possono essere inviate a uno o più indirizzi email o a destinazioni di sistema come Slack, Microsoft Teams, PagerDuty o qualsiasi altro 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 l'esecuzione delle attività, cliccare + Aggiungi accanto a Notifiche nel pannello dei task quando si aggiunge o si modifica il task di un processo.
  • Un processo completato in stato Succeeded with failures viene considerato in uno stato di esito positivo. Per ricevere avvisi per i processi completati in questo stato, è necessario selezionare Riuscito quando si configurano le notifiche.

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

Per aggiungere una o più notifiche di sistema quando le esecuzioni di questo processo hanno un evento notificabile, come l'avvio, il completamento o il mancato completamento del processo:

  1. Nel pannello Dettagli processo del processo, cliccare Modifica notifiche.
  2. Cliccare Aggiungi notifica e selezionare una destinazione di sistema in Destinazione.
  3. In Selezionare una destinazione di sistema, selezionare una destinazione e cliccare la casella di controllo per ogni tipo di notifica da inviare a tale destinazione.
  4. Per aggiungere un'altra destinazione, cliccare di nuovo su Aggiungi notifica.
  5. Cliccare 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 di 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 e-mail per l'esecuzione delle attività, cliccare + Aggiungi accanto a Notifiche nel pannello delle attività quando si aggiunge o si modifica un'attività di processo.
  • Un processo completato in stato Succeeded with failures viene considerato in uno stato di esito positivo. Per ricevere avvisi per i processi completati in questo stato, è necessario selezionare Riuscito quando si configurano le notifiche.

Per aggiungere uno o più indirizzi e-mail per notificare quando hanno inizio le esecuzioni di questo processo, quando vengono completate o falliscono:

  1. Nel pannello Dettagli processo del processo, cliccare Modifica notifiche.
  2. Cliccare Aggiungi notifica e selezionare Indirizzo email in Destinazione.
  3. Immettere un indirizzo email e cliccare la casella di controllo per ogni tipo di notifica da inviare a tale indirizzo.
  4. Per immettere un altro indirizzo email per la notifica, cliccare di nuovo su Aggiungi notifica.
  5. Cliccare Conferma.

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

Configurare le notifiche per processi a esecuzione lenta o in ritardo

Se è stata configurata una durata prevista per un processo, è possibile aggiungere una notifica email o di sistema se il processo supera la durata configurata. Per ricevere una notifica per i processi che superano la soglia di durata, cliccare la casella di controllo Avviso durata quando si aggiunge o si 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, quando si aggiungono o modificano le notifiche e-mail o le notifiche di sistema, selezionare Disattiva notifiche per le esecuzioni ignorate o Disattiva notifiche per le esecuzioni annullate.

Nota

Se si seleziona Disattiva notifiche per le esecuzioni ignorate o Disattiva notifiche per le esecuzioni annullate per un processo, non vengono filtrate le notifiche configurate per le attività del processo. Per filtrare tutte le notifiche per le esecuzioni saltate o annullate, è necessario filtrare anche tutte le 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 del task:

{
  "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, è possibile configurare dei webhook per i seguenti tipi di eventi:

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 una quantità di tempo maggiore della durata prevista configurata.