Gerenciamento de Erros
Console de Gerenciamento de Erros (EMC)
Seção intitulada “Console de Gerenciamento de Erros (EMC)”A aba Error Monitor no aplicativo DQS fornece uma interface dedicada para monitorar e resolver erros que ocorrem durante o processamento de varreduras. Ela oferece visibilidade completa sobre falhas de lote, erros de estratégia e problemas de plataforma — tudo em um só lugar.
O Console de Gerenciamento de Erros usa um layout de 3 zonas:
- Barra lateral de filtros (esquerda) — Filtre erros por Tipo de Erro, Classe de Origem, Mensagem de Erro, intervalo de tempo (De/Até) e endereço IP. Uma seção de Detalhamentos agrupa os erros por tipo, origem ou outros critérios, exibindo contagens ao lado de cada categoria para triagem rápida.
- Tabela de log de erros (centro) — Tabela ordenável listando todos os erros com colunas de resumo. Exibe contagens totais de erros em três janelas de tempo: Últimas 24 Horas, Últimos 7 Dias e Expirando em Breve. Clique em qualquer linha para ver os detalhes completos.
- Painel de ações (direita) — Atualize o log, crie uma exportação CSV para download, exclua entradas selecionadas e configure o período de retenção.
Tabela de Log de Erros
Seção intitulada “Tabela de Log de Erros”Cada linha de erro na tabela exibe as seguintes colunas:
| Coluna | Descrição |
|---|---|
| Error ID | Identificador único para a entrada do log de erros |
| Type | Categoria do erro (por exemplo, DML_FAILED, QUERY_FAILED, FIELD_INSERT_FAILED, BATCH_EXECUTE_FAILED) |
| Message | Descrição curta do erro (truncada — clique na linha para ver a mensagem completa) |
| Source | A classe Apex que gerou o erro (por exemplo, DQS_ExportFileService, DQS_DynamicQueryBuilder01) |
| Event Time | Timestamp de quando o erro ocorreu |
No topo da tabela são exibidos contadores agregados — Total Errors, Last 24 Hours, Last 7 Days e Expiring Soon — oferecendo uma visão geral rápida da saúde do sistema.
Modal de Detalhes da Linha
Seção intitulada “Modal de Detalhes da Linha”Clique em qualquer linha de erro para abrir um modal de detalhes com o contexto completo:
- Error ID e Type (destacados em vermelho para identificação rápida)
- Source — a classe Apex de origem
- uniqueIdentifier_01 — o registro relacionado ou identificador do lote
- Insert Type — se a operação foi uma inserção, atualização ou outro tipo de DML
- Event Time e First Event Time — timestamps da ocorrência do erro
- Message — mensagem de erro completa incluindo o tipo de exceção do Salesforce (por exemplo,
System.AsyncException,System.DmlException) - Stack Trace — stack trace completo do Apex para depuração
Fontes de Erros
Seção intitulada “Fontes de Erros”| Fonte | Exemplos |
|---|---|
| Processamento em Lote | Governor limit excedido, timeout de consulta |
| Dimension Strategy | Acesso inválido a campo, null pointer na lógica da estratégia |
| Platform Events | Falha na publicação de evento |
| Agendamento | Problemas com expressão CRON, erros de permissão |
Integração com Platform Events
Seção intitulada “Integração com Platform Events”O DQS usa platform events DQS_Processing_Error__e para exibir erros em tempo real. Quando um erro ocorre durante o processamento em lote:
- O erro é capturado e registrado
- Um platform event é publicado
- O EMC recebe o evento e o exibe
Isso substitui blocos catch silenciosos por reporte de erros visível.
Retenção de Erros
Seção intitulada “Retenção de Erros”Os logs de erros são automaticamente purgados com base no período de retenção configurado. A retenção padrão é de 7 dias.
Para alterar o período de retenção, use a seção Retention Configuration no painel de ações no lado direito do console. Insira o número de dias desejado no campo Error Log Retention (days) e clique em Save. Os logs de erros mais antigos que o período especificado serão automaticamente purgados. As alterações são implantadas via Metadata API e podem levar um momento para entrar em vigor.
Melhores Práticas
Seção intitulada “Melhores Práticas”- Verifique o EMC regularmente após configurar novas definições de varredura
- Revise os erros após alterar configurações de capacidades
- Use padrões de erros para identificar problemas sistemáticos (por exemplo, permissões de acesso a campos)
- Use o contador Expiring Soon para revisar erros antes que sejam automaticamente purgados
- Exporte logs de erros para CSV antes que expirem caso precise mantê-los para análises mais longas
- Entre em contato com o suporte se erros de plataforma persistirem em múltiplas varreduras