Pular para o conteúdo principal
Versão: 1.x

Logs

A tela de Logs registra a atividade do sistema dentro do POS. É uma ferramenta essencial para depurar problemas e entender o que está acontecendo nos bastidores.

Acessando os Logs​

Abra a tela de Logs no menu de navegação à esquerda (o ícone do batimento cardíaco).

Visão Geral da Interface​

Buscar e Filtrar​

  • Buscar Logs - Encontre entradas específicas de log pelo conteúdo da mensagem
  • Filtro de Nível de Log - Filtrar por nível de log (info, warn, error)
  • Configurações de exibição - Configurar colunas visíveis

Tabela de Logs​

Cada entrada de log mostra:

ColunaDescrição
HoraQuando o evento ocorreu
NívelSeveridade: info (cinza), warn (laranja), error (vermelho)
MensagemDescrição legível por humanos do evento
ContextoJSON expansível com detalhes adicionais
CódigoCódigo de erro (links para a documentação)

Níveis de Log​

Info (Cinza)​

Operações normais e eventos bem-sucedidos:

  • "Buscou todos os IDs para produtos"
  • "Sincronizou novos clientes"
  • "Buscou todos os IDs para impostos"

Aviso (Laranja)​

Problemas não críticos que podem precisar de atenção:

  • "Não é possível atualizar a sessão"
  • "Tentativa de reexibição para sincronização"

Erro (Vermelho)​

Problemas que precisam ser resolvidos:

  • "Desculpe, você não pode listar recursos" (problema de permissão)
  • "Solicitação de API falhou"
  • "Erro de sincronização do banco de dados"

Dados de Contexto​

Clique na seta de expansão em qualquer entrada de log para ver o contexto JSON detalhado:

{
  "total": "6",
  "execution_time": "54.79 ms",
  "server_load": "[10.51, 10.42, 9.98]"
}

Esses dados incluem:

  • Contagens de itens - Quantos registros foram afetados
  • Tempo de execução - Quanto tempo a operação levou
  • Carga do servidor - Métricas de desempenho do servidor
  • Detalhes da solicitação/resposta - Para depurar problemas com a API

Códigos de Erro​

Muitas entradas de log incluem um código de erro (por exemplo, API02004, DB01001). Esses códigos estão diretamente ligados à documentação dos Códigos de Erro, que fornece:

  • Explicação detalhada do erro
  • Causas comuns
  • Etapas de solução de problemas

Entradas de Log Comuns​

Operações de Sincronização​

[info] Fetched all IDs for products    {...} 3 items
[info] Synced new customers            {...} 1 item
[info] Fetched all IDs for taxes       {...} 3 items

Essas indicam atividade de sincronização normal. O contexto mostra quantos itens foram sincronizados.

Erros de Permissão​

[error] Sorry, you cannot list resources    {...} API02004

Isso geralmente significa que o usuário não tem permissão para acessar um recurso. Verifique as funções de usuário em WP Admin > POS > Settings > Access.

Problemas de Sessão​

[warn] Unable to refresh session    {...} API02007

O POS não conseguiu atualizar a sessão de autenticação. Isso pode exigir que o usuário saia e entre novamente.

Usando Logs para Suporte​

Ao solicitar suporte:

  1. Reproduza o problema - Realize a ação que causa o problema
  2. Verifique os logs - Procure erros (vermelho) ou avisos (laranja)
  3. Expanda o contexto - Obtenha os detalhes completos em JSON
  4. Anote o código de erro - Inclua isso em sua solicitação de suporte
  5. Copie entradas relevantes - Compartilhe as mensagens de log com o contexto

Monitoramento de Desempenho​

Os logs incluem tempo de execução e métricas de carga do servidor. Se você notar:

  • Altos tempos de execução - O servidor pode estar sobrecarregado ou lento
  • Altos valores de carga do servidor - Considere a otimização do servidor
  • Timeouts frequentes - Verifique a conectividade da rede
Códigos de ErroExplicações detalhadas de erros
Solução de ProblemasProblemas comuns e soluções
SuporteObter ajuda