Erros do sistema
Beta
O Lakewatch está em Beta. Os administradores do Workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias no nível do workspace.
Um erro do sistema é o registro que o Lakewatch cria quando uma regra de detecção ou fonte de dados falha, ou quando encontra um problema de configuração em um deles. Cada erro do sistema agrupa suas ocorrências repetidas para que você possa investigar problemas relacionados de integridade e configuração do sistema juntos. Os erros do sistema estão separados dos alertas, que agrupam sinais que indicam potenciais ameaças à segurança.
Como os erros do sistema são criados?
Erros do sistema são criados automaticamente por meio de agrupamento. Quando uma regra de detecção ou fonte de dados gera uma nova ocorrência, o Lakewatch a anexa a um erro do sistema existente em vez de abrir um novo erro do sistema para cada ocorrência. Uma ocorrência é anexada a um erro do sistema existente (um que não foi resolvido ou marcado como duplicado) quando ambas as condições a seguir são atendidas:
- A ocorrência tem o mesmo resumo e foi levantada pela mesma regra de detecção ou fonte de dados que a ocorrência que abriu o erro do sistema existente.
- O erro de sistema existente foi aberto nas últimas 24 horas.
O Lakewatch cria um novo erro de sistema quando nenhum erro de sistema correspondente existe, o erro de sistema correspondente mais recente foi aberto há mais de 24 horas, ou o erro de sistema correspondente está resolvido ou marcado como duplicado. A janela de agrupamento de 24 horas começa quando o erro de sistema é aberto. Novas ocorrências não a estendem.
Erros do sistema não podem ser criados manualmente a partir da IU.
Os critérios de agrupamento (o resumo da ocorrência e a regra ou fonte de dados que o acionou) e a janela de agrupamento de 24 horas não podem ser alterados. O Lakewatch ignora o valor da Janela de ordenação em Configurações > Erros do sistema .
O que Trigger os erros do sistema?
O Lakewatch abre erros do sistema quando uma regra de detecção ou job de fonte de dados encontra um erro ou problema de integridade. Os cenários comuns incluem:
- Erros de execução de regra de detecção : Uma regra falha ao ler seus dados de origem, ao avaliar sua lógica de detecção ou ao processar ou gravar sua saída. Por exemplo, uma regra cuja tabela de origem foi excluída falha ao ler seus dados de origem.
- Erros de pipeline de fonte de dados : Uma execução de pipeline de fonte de dados falha.
O Lakewatch também abre erros do sistema para problemas de configuração que ele encontra enquanto configura ou atualiza uma regra ou fonte de dados. Por exemplo, uma regra falha na validação, uma fonte de tabela existente de uma fonte de dados não está disponível ou um analisador não pode ser encontrado. Esses erros de sistema não listam ocorrências individuais na tab Erros .
Trabalhando com erros do sistema
Cada erro do sistema tem os seguintes atributos editáveis:
- Responsável : O usuário responsável por resolver o erro do sistema.
- Estado : Um entre Aberto, Em progresso, Mitigado, Resolvido ou Duplicado. Quando uma regra que falhou na validação passa na validação ou é excluída, o Lakewatch define seu erro de sistema como Resolvido. Outros erros do sistema mantêm seu estado até que você o altere.
- Gravidade : O Lakewatch define novos erros de sistema como Médio. Você pode atualizar manualmente a gravidade a qualquer momento. Valores válidos: Informativo, Baixo, Médio, Alto ou Crítico.
Cada erro do sistema também tem os seguintes atributos somente leitura:
- Link permanente : O ID do erro do sistema, como
SYS-42, com um link que pode copiar. - Title : O resumo da ocorrência que abriu o erro do sistema.
- Descrição : Detalhes da ocorrência mais recente que incluiu detalhes, como a mensagem de erro ou uma correção sugerida. O Lakewatch atualiza a descrição quando uma nova ocorrência com detalhes é anexada.
- Regra ou Fonte de dados : A regra de detecção ou fonte de dados que gerou as ocorrências.
- Erros : As ocorrências anexadas ao erro do sistema e a sua contagem. Os erros do sistema devido a problemas de configuração não listam ocorrências individuais.
- Primeiro evento : Timestamp da ocorrência mais antiga anexada ao erro do sistema.
- Último evento : Timestamp da ocorrência mais recente anexada ao erro do sistema.
- Criado por : A identidade que criou o erro do sistema. Para uma falha em uma regra de detecção ou job de fonte de dados, essa é a identidade de execução dessa regra ou fonte de dados. Para um problema de configuração, é uma identidade de serviço Lakewatch.
- Criado em : Timestamp de quando o erro do sistema foi criado.
- Atualizado em : Timestamp de quando o erro do sistema foi modificado pela última vez.
Trabalhar com erros do sistema na IU
Os erros de sistema aparecem como um item de nível superior na navegação do Lakewatch. Nesta página, você pode:
- view uma lista de erros do sistema. Por default, a lista mostra erros do sistema abertos, em progresso e mitigados com uma severidade de Baixa ou superior. Para ver erros do sistema resolvidos, duplicados ou informacionais, altere os filtros Estado e Severidade .
- Pesquise erros do sistema por título, descrição ou texto de comentário ou encontre um erro do sistema específico pelo seu ID, como
SYS-42. - Filtre erros do sistema por estado, gravidade, responsável, regra de detecção, fonte de dados e hora de criação. As seleções de pesquisa e filtro persistem na navegação dentro do Lakewatch, e o estado do filtro ativo é refletido na URL. Copie a URL para compartilhar ou marcar uma view filtrada.
- Ordene pelas colunas Eventos , Criado ou Atualizado e redimensione as colunas. A lista também inclui uma coluna Exportado para .
- Abra um erro do sistema para view seus detalhes e editar seus atributos.
Detalhes do erro do sistema
Clique no título de um erro de sistema para abrir a página de detalhes. Lá, você pode view e editar seus atributos e ver suas ocorrências na tab Erros .
Clique no resumo de uma ocorrência para abrir seus detalhes em um painel lateral. O painel mostra o recurso envolvido e a mensagem de erro ou uma correção sugerida.
Você também pode adicionar comentários a um erro do sistema na página de detalhes. Os comentários oferecem suporte à sintaxe Markdown. Use o controle de ordem de comentários para alternar entre Mais recentes primeiro e Mais antigos primeiro .
Exportando erros do sistema
Exporte erros do sistema para um sistema externo, como Jira, ServiceNow, Tines ou um webhook. A exportação está configurada para cada ambiente na seção Erros do sistema de Configurações . Para configuração e opções, consulte Configurar definições.
Solucionar falhas de execução do datasource
Quando uma execução de fonte de dados falha, o Lakewatch abre um erro de sistema para a fonte de dados afetada. O atributo Datasource (Fonte de dados ) do erro do sistema identifica a fonte de dados, e suas ocorrências incluem a mensagem de erro da execução, que descreve a falha, como um erro de pipeline ou um problema de conectividade de origem.
Para investigar e recuperar:
- Abra o erro do sistema da fonte de dados para ler seu resumo e a mensagem de erro na tab Erros ou query as ocorrências na
system_eventsview filtrada porresource_type = 'Datasource'. - Na tab História de execução do datasource, clique em view execuções de Job para abrir as execuções de Job do Databricks subjacentes para história de execução e logs.
- Para uma falha de acesso à fonte, restaure o acesso da identidade de execução à fonte. Se a identidade não for alterada, a próxima execução agendada será recuperada automaticamente. Para reatribuir a identidade de execução, abra a tab Configuração da fonte de dados e selecione um novo principal no cartão Executar como . As alterações na tab Configuração salvam automaticamente. Consulte Solucionar erros da fonte de dados.
- Depois que as execuções são bem-sucedidas novamente, o erro do sistema permanece aberto. Altere seu estado para Resolved (Resolvido ) quando você confirmar a correção.
Ocorrências de query em SQL
A view <UC-CATALOG>.__lakewatch.system_events contém uma linha por ocorrência levantada por jobs de regra de detecção e fonte de dados naquele catálogo, onde <UC-CATALOG> é o catálogo do seu ambiente Lakewatch. Faça uma query para analisar ocorrências, correlacioná-las com erros do sistema e criar relatórios ou dashboards personalizados.
A view inclui o ID do erro de sistema de cada ocorrência. Para view e gerenciar erros de sistema, use a página Erros de sistema na interface.
Esquema
Coluna | Tipo | Descrição |
|---|---|---|
| String | Identificador exclusivo para a ocorrência. |
| String | ID do catálogo do Unity Catalog que contém o recurso. |
| Timestamp | Quando a ocorrência foi gerada. |
| String | O tipo de recurso que levantou a ocorrência: |
| String | Identificador único da regra ou fonte de dados. |
| String | Nome da regra ou fonte de dados quando a ocorrência foi gerada. Para regras, este é o nome totalmente qualificado, como |
| String | Uma breve descrição do problema. |
| String | Informações estendidas, como a mensagem de erro ou uma correção sugerida. |
| String | Não preenchido. O valor é |
| String | Identificador exclusivo do erro do sistema ao qual a ocorrência está anexada. Apesar do nome da coluna, esse valor identifica um erro de sistema, não um alerta de segurança. É diferente do ID de erro do sistema mostrado na UI, como |