Consultar arquivos de registro de eventos

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

Consultar um objeto EventLogfile usando o Developer Console.
Exibir eventos no Navegador do ELF (Arquivo de registro de eventos) do Salesforce.
Saiba mais sobre tipos de eventos EventLogfile.

Esta unidade depende de seus conhecimentos sobre o Developer Console do Salesforce e o Navegador do ELF (Arquivo de registro de eventos). Para saber mais sobre cada um, consulte os links na seção Recursos desta unidade.

Neste módulo, pressupomos que você seja um administrador do Salesforce com as devidas permissões para ativar o monitoramento de eventos. Se você não for um administrador do Salesforce, tudo bem. Continue lendo para saber como seu administrador executaria essas etapas em uma organização de produção. Você também pode acompanhar o módulo usando um Trailhead Playground. No entanto, leva 24 horas para que os eventos apareçam nos arquivos de registro.

Exibir eventos no Navegador do Arquivo de registro de eventos do Salesforce

O Navegador do ELF (Arquivo de registro de eventos) do Salesforce é uma aplicativo da web conectado ao Salesforce que permite acesso rápido a arquivos de registro de eventos. Com o Navegador do ELF, você pode facilmente encontrar e baixar eventos de vários períodos de tempo sem uma linha de código. Os dados nos arquivos que você recebe do navegador podem até ser visualizados usando o Tableau CRM.

O navegador do ELF do Salesforce não é um produto oficial da Salesforce. Não garantimos a segurança, proteção ou manutenção do projeto ou do aplicativo implantado.

Verifique se atualmente você tem dados no Navegador do ELF. Se não for o caso, primeiro, gere alguma atividade do usuário. Fazer isso, neste momento, fornece alguns dados para examinar quando chegar à Unidade 3. Além disso, observe que isso fornece informações gerais, como tipo de evento e data, mas que todos os eventos nessa data (campo LogFile) não ficarão visíveis no Developer Console.

Captura de tela do Navegador do ELF retornando zero resultados

Se nenhum relatório tiver sido exportado de sua organização nas últimas 24 horas, o campo totalSize terá um valor de zero. Lembre-se que demora 24 horas para que os eventos estejam disponíveis. Você pode exportar um relatório a partir de sua organização e tentar novamente amanhã.

Entre na sua organização.
Navegue até o aplicativo do Navegador do ELF clicando neste link: https://salesforce-elf.herokuapp.com.
Clique em Login de produção.
Defina a data de início.
Selecione um tipo de evento para sua pesquisa ou deixe o tipo de evento definido como Todos.
Clique em Aplicar.

Consultar arquivos de registro de eventos no Developer Console

Vamos considerar um exemplo: Um representante de vendas chamado Rob Burgle deixou sua empresa há algumas semanas e foi trabalhar para um concorrente importante. De repente, você começa a perder negócios para essa outra empresa. Você suspeita que Rob baixou um relatório com informações confidenciais sobre leads e o compartilhou com seu novo empregador. Normalmente, você não teria como confirmar suas suspeitas. Mas, com o Monitoramento de eventos, você pode coletar todas as evidências para passar a história a limpo. Vamos ver como esse processo funciona.

Bastam alguns cliques para abrir o Developer Console no Lightning Experience. O Developer Console é um ambiente de desenvolvimento integrado com um conjunto de ferramentas para criar, depurar e testar aplicativos na sua organização do Salesforce.

Para abrir o Developer Console no Lightning Experience:

Clique em .
Clique em Developer Console.

Captura de tela exibindo o menu de acesso rápido usado para abrir o Developer Console no Lightning Experience

Agora estamos pronto para abrir o EventLogfile para consultar as informações.

Clique em Arquivo | Abrir.
Em Tipos de entidade, selecione Objetos.
No campo Filter the repository (Filtrar o repositório), digite EventLogFile.
Selecione EventLogFile em Entidades.
Clique em Abrir.

Em seguida, selecione os campos para sua consulta e clique no botão Consulta .

Captura de tela exibindo campos para selecionar a partir de Consulta

Antes de prosseguir para a próxima etapa, verifique se há dados de eventos em sua organização. Se não houver dados, execute e exporte pelo menos um relatório e aguarde 24 horas para que os dados apareçam.

Por fim, clique no botão Executar para concluir a consulta.

Captura de tela exibindo resultados da consulta

Você pode usar o Editor de consulta no Developer Console para executar uma consulta SOQL (Salesforce Object Query Language, Linguagem de consulta de objetos do Salesforce). O painel Histórico exibe suas últimas 10 consultas para reutilização rápida. Os resultados são exibidos em uma grade de Resultados da consulta.

A grade de Resultados da consulta exibe cada registro em forma de uma linha. Você pode abrir, criar, atualizar e excluir registros sem sair do Developer Console.

Documentação do arquivo de registro de eventos para tipos de eventos

O campo EventType no objeto EventLogfile dá suporte a eventos. Todos os tipos de eventos são documentados na Referência de objeto do Salesforce. A Referência de objeto do Salesforce mostra os campos e suas descrições, além das consultas de exemplo que podem ser usadas.

Por exemplo, no campo DB_TOTAL_TIME, o número do tipo de evento corresponde à hora em nanossegundos para uma viagem de ida e volta do banco de dados, que inclui o tempo gasto no driver do JDBC, a rede para o banco de dados e DB_CPU_TIME. Como administrador, você pode comparar esse campo com CPU_TIME para determinar se os problemas de desempenho estão ocorrendo na camada do banco de dados ou em seu próprio código.

Página Tipo de evento de relatório

Os eventos de relatório contêm informações sobre o que aconteceu quando um usuário executou um relatório, elementos como a data e a hora, o nome do relatório, os registros referenciados no relatório, o número de linhas e colunas, e o usuário de origem, dentre outros.

Você também pode usar a API REST para interagir com os registros do Monitoramento de eventos. O acesso ao Monitoramento de eventos é feito pela API SOAP e API REST da Lightning Platform por meio do objeto EventLogfile. Assim, você consegue integrar dados de registro com seu próprio armazenamento de back-end e bases de dados para correlacionar dados de várias organizações e em sistemas distintos.

Na próxima unidade, vamos explorar como baixar e visualizar arquivos de registro de eventos para chegar mais perto de fornecer informações sobre o comportamento malicioso do usuário usando o Monitoramento de eventos.