Visualizando acessos e logs nas integrações (opções V1 e V2)

Na tela de Configurações > Geral > Integrações, tanto na aba Acessos quanto na aba Logs, está disponível a opção V2 entre os filtros. Essa opção define qual versão de registros é exibida. A cada momento, uma das duas versões está em uso:

• V2 desativada → a V1 assume automaticamente e a tela exibe os registros históricos.
• V2 ativada → a tela exibe os registros mais recentes.

As duas versões são complementares: juntas, formam todo o histórico de acessos e logs disponível.
 

Diferença entre as abas Acessos e Logs

As duas abas registram informações distintas, mas compartilham a mesma opção V2:

• Aba Acessos: registra os logins realizados no sistema. Útil para auditar quem acessou a plataforma e quando, incluindo acessos via integração.

  

   

• Aba Logs: registra a atividade técnica das integrações: chamadas recebidas pela API do Nectar, webhooks disparados pelo Nectar para sistemas externos e dados recebidos por formulários web (WebForm). Útil para diagnosticar o comportamento de uma integração específica.

  

Em ambas as abas, a opção V2 funciona da mesma forma: ativada, exibe os registros recentes; desativada, exibe os registros históricos da V1.
 

Para quem é indicado

• Administradores que auditam o uso da API e o acesso de usuários
• Times de TI responsáveis por integrações ativas
• Gestores que acompanham a saúde operacional das integrações
   

Como usar

1. Acesse Configurações > Geral > Integrações.

2. Selecione a aba que deseja consultar: Acessos ou Logs.

3. Entre os filtros disponíveis, localize a opção V2.

4. Ative a opção V2 para visualizar registros recentes.

5. Aplique os filtros de período desejados (Hoje, Ontem, Esta semana, Mês atual, etc.).

6. Para consultar registros antigos, desative a opção V2 — a V1 assume automaticamente. Aplique novamente os filtros de período.
 

Boas práticas

• Para acompanhamento operacional do dia a dia, mantenha a V2 ativada. É onde os registros atuais são exibidos.
• Para auditoria histórica, desative a V2 para acessar a V1. O conteúdo anterior permanece consultável.
• Reaplique os filtros de período após alternar a opção V2. Cada versão tem sua própria base de datas.
   

Limitações conhecidas

• A opção V2 não funciona como um filtro tradicional. Ela alterna entre duas versões distintas de registros — V1 (históricos) e V2 (recentes). As duas versões não são exibidas simultaneamente.
• Em algumas situações pode haver um intervalo entre o fim do registro da V1 e o início do registro da V2. Caso identifique uma lacuna que afete uma auditoria específica, abra um chamado com o Suporte para análise individual.
• A Nectar está avaliando uma evolução para unificar a experiência das telas de Acessos e Logs em uma visualização única, eliminando a necessidade de alternar entre versões. Esta documentação será atualizada quando essa evolução estiver disponível.