# Como consultar os Logs do sistema

<span style="white-space: pre-wrap;">A rotina </span>**Consulta de Logs**<span style="white-space: pre-wrap;"> permite visualizar o histórico de ações e eventos registrados automaticamente pelo sistema. Cada entrada representa algo que aconteceu: um usuário que se autenticou, um campo que foi alterado, um processo automático que foi executado.</span>

No dia a dia, essa consulta é utilizada principalmente pelas equipes de suporte e administração para investigar comportamentos inesperados, rastrear alterações em registros e confirmar se determinadas ações foram realizadas corretamente.

---

#### **1. Navegação no módulo**

![logs.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/logs.gif)**Rotina:**<span style="white-space: pre-wrap;"> Administrador &gt; Consulta de Logs</span>

---

#### **2. Como funciona**

<span style="white-space: pre-wrap;">Ao acessar a rotina, o sistema exibe a tela </span>**Listando Logs**, com um painel de filtros na parte superior e uma tabela de resultados logo abaixo. Os registros são ordenados do mais recente para o mais antigo e mostram, em cada linha, a data de criação, o módulo relacionado, o módulo pai (quando aplicável), o tipo de log e uma descrição das alterações ou eventos registrados.

A tabela exibe a quantidade total de registros encontrados e permite escolher quantos itens são exibidos por página: 10, 25, 50, 100 ou 240.

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/OVpimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/OVpimage.png)

<p class="callout info">Os logs são gerados automaticamente pelo sistema. Você não precisa ativar nem configurar nada para que eles sejam criados. Basta acessar esta tela para consultá-los.</p>

---

#### **3. Filtros de busca**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/Nl5image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/Nl5image.png)

<span style="white-space: pre-wrap;">Para localizar um log específico, utilize os filtros disponíveis na parte superior da tela. Preencha um ou mais campos e clique no botão </span>**Buscar**<span style="white-space: pre-wrap;"> para aplicar os filtros. Os campos disponíveis são:</span>

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 200px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 200px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Criado em

</td><td>Período de data para limitar os resultados. Permite definir um intervalo de tempo e concentrar a busca nos eventos de um dia, semana ou mês específico.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Tipo de log

</td><td>Classifica o evento pelo seu tipo, como "Autenticação", "Alteração" ou "Sucesso". Use este filtro para encontrar apenas autenticações ou apenas modificações em registros, por exemplo.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Usuário responsável

</td><td>Filtra os logs pelo usuário que realizou a ação. Útil para investigar o que determinado colaborador fez em um período específico.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Módulo

</td><td>Restringe os resultados a um módulo específico do sistema, como "Imóvel", "Usuário" ou outro disponível na lista. Use quando quiser rastrear ações em uma área específica.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Módulo ID

</td><td>Permite informar o número identificador de um registro específico dentro do módulo selecionado. Por exemplo, para ver todos os eventos do imóvel de número 508768, informe esse número neste campo.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<span style="white-space: pre-wrap;">➜ </span>**Botão Buscar:**<span style="white-space: pre-wrap;"> aplica os filtros preenchidos e atualiza a listagem com os resultados correspondentes.</span>

<p class="callout warning"><span style="white-space: pre-wrap;">O campo </span>**Criado em**<span style="white-space: pre-wrap;"> é obrigatório. Sem informar um período, o sistema não realiza a busca.</span></p>

---

#### **4. Entendendo os resultados da listagem**[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/ICIimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/ICIimage.png)

Cada linha da tabela representa um evento registrado. Veja o que cada coluna significa:

<table id="bkmrk-colunao-que-signific" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">**Coluna**

</th><th>**O que significa**

</th></tr><tr><td>Criação

</td><td>Data e horário exatos em que o evento foi registrado no sistema. Exemplo: 04/08/2026 17:00:49.

</td></tr><tr><td>Módulo

</td><td>Área do sistema onde o evento ocorreu, podendo incluir o identificador do registro. Exemplo: "Usuário ~ 18504" ou "Imóvel ~ 508768".

</td></tr><tr><td>Módulo Pai

</td><td>Quando o evento ocorreu em um sub-registro, esta coluna mostra o registro principal ao qual ele pertence. Exemplo: "Imóvel ~ 508768" aparece como módulo pai de alterações em finalidades desse imóvel.

</td></tr><tr><td>Tipo de log

</td><td>Categoria do evento. Os tipos observados incluem "Autenticação" (entrada no sistema), "Alteração" (mudança em um campo) e "Sucesso" (processo automático concluído).

</td></tr><tr><td>Alterações

</td><td><span style="white-space: pre-wrap;">Descrição detalhada do que aconteceu. Pode informar quem se autenticou, qual campo foi alterado, de qual valor para qual valor, ou o resultado de um processo automático. Quando a descrição é muito longa, o link </span>

**Ver mais...**

<span style="white-space: pre-wrap;"> permite ler o conteúdo completo.</span>

</td></tr></tbody></table>

<p class="callout info">Registros gerados por processos automáticos do sistema, como o faturamento em lote ou a atualização de valores pelo indicador CUB, aparecem sem usuário responsável. Isso é esperado: esses eventos foram feitos pelo próprio sistema, sem intervenção manual.</p>

---

#### **5. Como usar os logs para investigar um problema**

<span style="white-space: pre-wrap;">Ao clicar na opção </span>**Detalhar**<span style="white-space: pre-wrap;">, o sistema apresenta todas as informações relacionadas à alteração realizada, exibindo os dados </span>**antes e depois da modificação**. Dessa forma, é possível identificar com clareza o que foi alterado, facilitando o acompanhamento e a auditoria dos registros, conforme demonstrado na imagem abaixo.

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/7qrimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/7qrimage.png)Quando um problema ocorre no sistema, os logs são a principal fonte de informação para investigação. Siga o procedimento abaixo para uma consulta eficiente:

**Passo 1: anote as informações do problema antes de buscar**  
Antes de abrir a tela de logs, tenha em mãos as seguintes informações:

- **Nome do usuário**<span style="white-space: pre-wrap;"> que estava utilizando o sistema no momento do problema.</span>
- **Data e horário**<span style="white-space: pre-wrap;"> aproximados em que o problema ocorreu.</span>
- **Rotina acessada:**<span style="white-space: pre-wrap;"> qual tela ou módulo o usuário estava usando.</span>
- **Passo a passo realizado:**<span style="white-space: pre-wrap;"> o que o usuário fez antes de o problema aparecer.</span>
- **Comportamento esperado:**<span style="white-space: pre-wrap;"> o que deveria ter acontecido.</span>
- **Comportamento apresentado:**<span style="white-space: pre-wrap;"> o que realmente aconteceu.</span>
- **Mensagem de erro:**<span style="white-space: pre-wrap;"> se o sistema exibiu alguma mensagem, anote o texto exato ou tire uma captura de tela.</span>

**Passo 2: aplique os filtros adequados**  
<span style="white-space: pre-wrap;">Acesse </span>**Administrador &gt; Consultar Logs**<span style="white-space: pre-wrap;">, informe o período no campo </span>**Criado em**<span style="white-space: pre-wrap;"> e, se souber, selecione o usuário responsável e o módulo relacionado. Clique em </span>**Buscar**.

**Passo 3: localize o evento na listagem**  
<span style="white-space: pre-wrap;">Percorra a tabela de resultados e identifique o registro que corresponde ao problema. Observe a data, o módulo, o tipo de log e a descrição das alterações. Se a descrição estiver truncada, clique em </span>**Ver mais...**<span style="white-space: pre-wrap;"> para ler o conteúdo completo.</span>

**Passo 4: registre ou compartilhe as informações encontradas**  
<span style="white-space: pre-wrap;">Copie a descrição do log relevante e reúna com as informações anotadas no Passo 1. Encaminhe esse conjunto de dados para a equipe de suporte, incluindo a data, o horário, o módulo, o tipo de log e o texto da coluna </span>**Alterações**.

<p class="callout success">Quanto mais preciso for o período e o módulo informados nos filtros, mais rápido você encontrará o registro correto.</p>

<p class="callout warning">Durante a investigação, acesse somente o que for necessário para reproduzir ou entender o problema. Ações desnecessárias em outras telas criam novos registros e podem dificultar a identificação do evento original.</p>

---

#### **6. Perguntas frequentes**

**O que são os logs do sistema?**  
Os logs são registros das ações realizadas pelos usuários dentro da plataforma. Eles permitem consultar informações como usuário responsável, data, horário, rotina acessada e alterações efetuadas.

**Quais informações são exibidas ao detalhar um log?**  
<span style="white-space: pre-wrap;">Ao clicar em </span>**Detalhar**, o sistema apresenta as informações relacionadas à ação registrada, incluindo os dados existentes antes da alteração e os dados após a modificação.

**É possível alterar ou excluir um log?**  
Não. Os logs são registros de auditoria e devem permanecer disponíveis para garantir a segurança e a confiabilidade do histórico das ações realizadas no sistema.

**Por que uma alteração não aparece na consulta de logs?**  
Verifique se os filtros utilizados correspondem à data, ao usuário, à rotina ou ao tipo de ação realizada. Caso os filtros estejam muito específicos, remova alguns critérios e realize uma nova busca.

**Para que a consulta de logs pode ser utilizada?**  
A consulta pode ser utilizada para acompanhar alterações, identificar quem realizou determinada ação, verificar os dados modificados e auxiliar em processos de auditoria, segurança e análise de situações ocorridas no sistema.

---