Adicionar notificações por e-mail e do sistema para eventos de trabalhos

  • Artigo

Você pode monitorar as execuções de um trabalho e as tarefas que fazem parte desse trabalho configurando notificações quando uma execução é iniciada, concluída com êxito, falha ou sua duração excede um limite configurado. As notificações podem ser enviadas para um ou mais endereços de e-mail ou destinos do sistema, como Slack, Microsoft Teams, PagerDuty ou qualquer serviço baseado em webhook.

Configurar notificações do sistema

Nota

  • Para cada trabalho ou tarefa, você pode configurar um máximo de três destinos do sistema para cada tipo de evento de notificação.
  • Os destinos do sistema têm de ser configurados por um administrador. Os destinos do sistema são configurados ao selecionar Criar novo destino na caixa de diálogo Editar notificações do sistema ou na página de definições administrativas.
  • As notificações definidas no nível do trabalho não são enviadas quando as tarefas com falha são repetidas. Para receber uma notificação de falha após cada tarefa com falhas (incluindo cada nova tentativa com falhas), utilize notificações de tarefas . Para adicionar notificações do sistema para execuções de tarefas, clique em + Adicionar ao lado de Notificações no painel de tarefas quando adicionar ou editar uma tarefa de trabalho.
  • Um trabalho concluído em um Succeeded with failures estado é considerado bem-sucedido. Para receber alertas para trabalhos concluídos nesse estado, você deve selecionar Êxito ao configurar notificações.

As notificações do sistema integram-se com ferramentas de notificação populares, incluindo:

Para adicionar uma ou mais notificações do sistema quando as execuções deste trabalho tiverem um evento notificável, como início, conclusão ou falha do trabalho:

  1. No painel Detalhes do trabalho, clique em Editar notificações.
  2. Clique em Adicionar notificação e selecione um destino do sistema em Destino.
  3. Em Selecione um destino do sistema, selecione um destino e clique na caixa de seleção para cada tipo de notificação a ser enviada para esse destino.
  4. Para adicionar outro destino, clique em Adicionar notificação novamente.
  5. Clique em Confirmar.

Importante

O conteúdo das mensagens do Slack e do Microsoft Teams pode mudar em versões futuras. Você não deve implementar clientes ou processamento que dependem do conteúdo específico ou da formatação dessas mensagens. Se você precisar de um esquema ou formatação específica para notificações, o Azure Databricks recomenda configurar um webhook definido pelo usuário.

Configurar notificações por e-mail

Nota

  • As notificações definidas no nível do trabalho não são enviadas quando as tarefas com falha são repetidas. Para receber uma notificação de falha após cada tarefa com falhas (incluindo cada nova tentativa com falhas), utilize notificações de tarefas . Para adicionar notificações por e-mail para execuções de tarefas, clique em + Adicionar ao lado de Notificações no painel de tarefas quando adicionar ou editar uma tarefa de trabalho.
  • Um trabalho concluído em um Succeeded with failures estado é considerado bem-sucedido. Para receber alertas para trabalhos concluídos nesse estado, você deve selecionar Êxito ao configurar notificações.

Para adicionar um ou mais endereços de e-mail para notificar quando as execuções deste trabalho começarem, forem concluídas ou falharem:

  1. No painel Detalhes do trabalho, clique em Editar notificações.
  2. Clique em Adicionar notificação e selecione Endereço de e-mail no destino.
  3. Insira um endereço de e-mail e clique na caixa de seleção para cada tipo de notificação a ser enviado para esse endereço.
  4. Para inserir outro endereço de e-mail para notificação, clique em Adicionar notificação novamente.
  5. Clique em Confirmar.

Você pode usar notificações por e-mail para integrar com ferramentas como Amazon SES e SNS.

Configurar notificações para trabalhos lentos ou atrasados

Se você configurou uma duração esperada para um trabalho, poderá adicionar um e-mail ou notificação do sistema se o trabalho exceder a duração configurada. Para receber uma notificação para trabalhos que excedem o limite de duração, clique na caixa de seleção Aviso de Duração ao adicionar ou editar uma notificação.

Filtrar notificações para execuções ignoradas ou canceladas

É possível reduzir o número de notificações enviadas filtrando as notificações quando uma execução é ignorada ou cancelada. Para filtrar notificações, marque Silenciar notificações para execuções ignoradas ou Silenciar notificações para execuções canceladas quando você adicionar ou modificar notificações por e-mail ou notificações do sistema.

Nota

Selecionar Silenciar notificações para execuções ignoradas ou Silenciar notificações para execuções canceladas para um trabalho não filtra as notificações configuradas para tarefas de trabalho. Para filtrar todas as notificações de execuções ignoradas ou canceladas, você também deve filtrar todas as notificações de nível de tarefa que você configurou.

Cargas úteis HTTP webhook

Se você estiver usando um webhook HTTP para enviar notificações, a seguir estão exemplos de cargas úteis enviadas pelo Azure Databricks para seu ponto de extremidade configurado.

Notificação para um evento de início de execução de trabalho:

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

Notificação para um evento de início de execução de tarefa:

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

Ao configurar destinos, webhooks podem ser configurados para os seguintes tipos de eventos:

Código do evento Quando é enviado?
jobs.on_start Uma corrida é iniciada.
jobs.on_success Uma execução para e é concluída em um estado bem-sucedido ou bem-sucedido com falhas.
jobs.on_failure Uma execução para em um estado malsucedido.
jobs.on_duration_warning_threshold_exceeded Uma execução tem sido executada por mais do que a duração esperada configurada.