Tines

info

Visualização

O Lakewatch está em Pré-visualização privada. Para solicitar acesso, entre em contato com a equipe da sua conta da Databricks.

Exporte alertas do Lakewatch para uma história do Tines. Quando um alerta é criado, o Lakewatch publica um evento JSON em um webhook do Tines, e sua história do Tines decide o que acontece com ele. Para saber como a exportação funciona entre destinos, consulte Destinos de alertas.

A exportação para o Tines é unidirecional, do Lakewatch para o Tines. O Lakewatch envia o evento por meio de uma ação de webhook do Tines, autenticando-se com um segredo de webhook que você armazena como um segredo do Unity Catalog.

Como o evento é entregue

• Na criação de alerta : o Lakewatch posta um evento JSON com o event_type lakewatch.alert.created. O payload usa o mesmo esquema e nomes de campos que o destino de webhook genérico, portanto, uma história do Tines pode ler os mesmos campos.
• Sobre atualizações de alerta : quando o envio de atualização está habilitado para o destino, o Lakewatch também publica um evento lakewatch.alert.updated quando o estado, título, severidade, descrição, classificação ou responsável por um alerta já exportado muda. Quando um alerta é fechado, você recebe um evento updated com alert_state definido como RESOLVED ou DUPLICATE. Não há um evento de fechamento separado. Para habilitar a entrega de atualização, selecione Também enviar atualizações de alerta nas configurações. Consulte Definir configurações.
• Sua story define o resultado : uma exportação bem-sucedida significa que o Tines recebeu o evento, não que sua story agiu sobre ele.

atenção

O Lakewatch envia cada evento uma única vez. Se a entrega ao Tines falhar, o Lakewatch registrará a falha e não reenviará o evento. O alerta ainda aparece no Lakewatch.

Use data.alert_id para combinar eventos com o mesmo alerta. Com a entrega de atualização habilitada, um alerta produz um evento created e, posteriormente, eventos updated, portanto, verifique event_type para diferenciá-los. delivery_attempt_id muda em cada entrega, portanto, não pode informar se dois eventos são sobre o mesmo alerta.

Pré-requisitos

Configurar o webhook do Tines

Em sua história do Tines, adicione uma ação de webhook de entrada e configure-a para autenticar com um segredo:

1. Adicione uma ação de Webhook à sua história.
2. Defina a ação para exigir um segredo, enviado como um cabeçalho (modo de acesso secreto). Observe a URL do webhook e o segredo.

Para obter detalhes, consulte a documentação da ação do webhook Tines.

A URL do webhook deve ser uma URL de ação de webhook, no formato https://<tenant>.tines.com/webhook/<path>, e acessível pela internet pública. O Lakewatch não consegue entregar para redes privadas, como Endpoint atrás do Private Service Connect.

Armazene o segredo do webhook como um segredo do Unity Catalog

Armazene o segredo do webhook do Tines em um segredo do Unity Catalog no esquema __lakewatch do catálogo do seu ambiente do Lakewatch. Selecionar segredo lista os segredos desse esquema, e Criar segredo cria um segredo lá. O Lakewatch armazena apenas o nome do segredo, não o seu valor.

Você pode criar este segredo com antecedência em <catalog>.__lakewatch ou criá-lo ao configurar a exportação do Tines com o botão Create secret (Criar segredo). De qualquer forma, a criação de um segredo requer USE CATALOG no catálogo e a propriedade do esquema __lakewatch ou ambos CREATE SECRET e USE SCHEMA nele. Para os passos, veja Criar um segredo.

Permissões necessárias

Para configurar a exportação do Tines, você precisa do seguinte:

• READ SECRET no segredo do Unity Catalog que contém o segredo do webhook, ou no esquema ou catálogo pai dele. O Lakewatch verifica se você pode ler o segredo quando você salva a configuração. Para concedê-la, consulte Gerenciar permissões em segredos.
• O privilégio MANAGE no catálogo do seu ambiente Lakewatch. Veja Definir configurações.

Para alterar o segredo do webhook, atualize o valor do mesmo segredo do Unity Catalog. Lakewatch usa o novo valor na próxima exportação, sem nenhuma alteração nas configurações. Para usar um segredo diferente, clique em Selecionar segredo ou Criar segredo nas configurações e salve.

Configure Tines como um destino de alerta

Configure um destino Tines para alertas na seção de configurações de Alertas .

1. Na barra lateral do Lakewatch, vá para Configurações e abra Alertas .
2. Em Entrega , defina Destino de alerta para Tines .
3. No URL do webhook , insira o URL da ação de webhook do Tines (https://<tenant>.tines.com/webhook/<path>).
4. Para Segredo do webhook , clique em Selecionar segredo para escolher o segredo que contém o segredo do webhook, ou clique em Criar segredo para criar um a partir do segredo do webhook sem sair da página. O campo mostra o nome do segredo, não o seu valor.
5. Salvar suas alterações.

Para obter a referência completa das configurações de alerta, consulte Definir configurações.

Solução de problemas

• Os eventos não chegam à sua story : o URL do webhook não é um URL de ação de webhook do Tines ou a story está desativada. Confirme se o URL está no formulário https://<tenant>.tines.com/webhook/<path> e se a story está ativa.
• A configuração não é salva : você não tem permissão para ler o segredo do Unity Catalog, o segredo está em um catálogo diferente do seu ambiente do Lakewatch ou a URL do webhook não usa HTTPS ou aponta para uma rede privada. Confirme seu acesso ao segredo, seu catálogo e a URL do webhook.
• Seu segredo não está listado em Selecionar segredo : Selecionar segredo lista apenas os segredos que você pode acessar no esquema __lakewatch do catálogo do seu ambiente. Armazene o segredo lá ou peça READ SECRET nele.
• O Lakewatch relata uma exportação bem-sucedida, mas nada acontece no Tines : uma resposta 2xx significa que o Tines aceitou o evento, não que sua história agiu sobre ele. Verifique a lógica da sua história do Tines.
• Você girou o segredo do webhook : atualize o segredo do Unity Catalog com o novo valor. Nenhuma alteração na configuração de exportação é necessária.