Pular para o conteúdo principal

Gerenciar destinos de notificação

Esta página ensina como criar e configurar destinos de notificação para o seu workspace.

As notificações do sistema são mensagens que informam ao senhor quando o fluxo de trabalho passa por um evento de execução (início, sucesso e falha). Por default, as notificações são enviadas aos endereços email do usuário, mas os administradores podem configurar destinos alternativos de notificação usando webhooks. Isso permite que o senhor crie integrações orientadas por eventos com a Databricks.

Os administradores também podem configurar destinos de notificação para receber solicitações de acesso de usuários workspace, como solicitações de privilégios em objetos Unity Catalog.

O senhor precisa ser um administrador do Databricks workspace para gerenciar destinos de notificação. Depois que um destino é configurado, ele fica disponível para todos os usuários.

Requisitos de rede

  • A Databricks impõe o uso de HTTPS para segurança. O destino da notificação deve usar certificados Secure Sockets Layer (SSL) assinados por uma autoridade certificadora confiável.
  • O destino da notificação deve adicionar os endereços IP de saída do plano de controle e do plano de dados workspace à sua lista de permissões:
    • Para endereços IP de aplicativos web do plano de controle, consulte Endereços IP e domínios para Databricks serviço e ativo.

    • Para obter endereços IP de saída do plano de dados, entre em contato com sua equipe account Databricks . Você receberá um URL para um arquivo JSON contendo os endereços IP de saída. Procure no arquivo a região do plano de dados do seu workspace e adicione à lista de permissões os endereços IP de saída correspondentes na sua pilha de rede.

      A Databricks pode atualizar os endereços IP de saída até uma vez a cada 30 dias. Os endereços IP atualizados entram em vigor em até 60 dias após a publicação, portanto, revise o arquivo regularmente e atualize sua lista de permissões antes do fechamento do período de ativação.

      Para rastrear as alterações entre as versões, salve as versões sucessivas do arquivo JSON e compare o valor timestampSeconds . Filtrar entradas onde:

      • O campo service é Databricks
      • O campo platform é aws
      • O campo type é outbound

Criar um novo destino de notificação

Para configurar um novo destino de notificação

  1. Clique em seu nome de usuário na barra superior do workspace e selecione Settings (Configurações) no menu suspenso.

  2. Na seção de administração do espaço de trabalho , clique em Notifications (Notificações ) tab.

  3. Clique no botão gerenciar .

  4. Clique em +Adicionar destino.

  5. Selecione um tipo de destino. Atualmente, há suporte para os seguintes destinos:

    • Email
    • Slack
    • Webhook
    • Equipes MS
    • PagerDuty
  6. Configure o destino com base no tipo.

  7. Clique em Criar .

Use credenciais diferentes para cada destino

A configuração de um destino é armazenada de forma segura e criptografada em seu site Databricks workspace. Para aumentar a segurança se o endpoint de terceiros for comprometido, a Databricks recomenda o uso de credenciais diferentes para cada destino configurado. Isso inclui:

  • Slack: o URL para o qual a notificação é enviada.
  • MS Teams: o URL para o qual a notificação é enviada.
  • PagerDuty: integração key usada para rotear notificações de forma exclusiva para um serviço PagerDuty.
  • Webhook: nome de usuário e senha usados para autenticar em um endpoint de terceiros usando a autenticação HTTP Basic ao entregar notificações.

O uso de segredos diferentes para cada destino configurado permite que o senhor revogue individualmente o acesso de destinos de notificação individuais sem afetar as operações de todos os outros destinos em seu site Databricks workspace.

Destino do Slack

Para configurar um destino para o Slack, siga as instruções em Webhooks de entrada para o Slack. Cole o URL gerado no destino da notificação do Databricks.

Adicionar um webhook a um trabalho

Depois de configurar os destinos, o senhor pode acessá-los nas configurações de notificações do siteJob de um trabalho. Para obter mais informações, consulte Adicionar notificações em um trabalho.

Cada Job suporta até três destinos de sistema por tipo de evento. Ao configurar as notificações de trabalho, os endereços email devem ser inseridos manualmente.

Limitações

Atualmente, os destinos de notificação têm as seguintes limitações:

  • O senhor só pode configurar notificações para Databricks SQL e Job.
  • Os destinos de notificação por e-mail têm um limite de 1.300 caracteres para o comprimento do endereço do destinatário.
  • Para corpos de notificação personalizados, destinos que não sejam oemail, como o Slack e o MS Teams, não são compatíveis com a formatação HTML. Alguns destinos de notificação oferecem suporte à redução.
  • Para o trabalho, os destinos do email devem ser definidos manualmente nas configurações do trabalho.