Logs
O POS tem duas interfaces de log: a tela de Logs no aplicativo (dentro do aplicativo do POS) e a página de Logs do WP Admin (dentro do WordPress). Juntas, elas oferecem uma visão completa da atividade do POS para depuração e auditoria.
Logs do Aplicativo POS
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:
| Coluna | Descrição |
|---|---|
| Hora | Quando o evento ocorreu |
| Nível | Severidade: info (cinza), warn (laranja), error (vermelho) |
| Mensagem | Descrição legível por humanos do evento |
| Contexto | JSON expansível com detalhes adicionais |
| Código | Có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 de produtos"
- "Sincronizou novos clientes"
- "Buscou todos os IDs de impostos"
Aviso (Laranja)
Problemas não críticos que podem precisar de atenção:
- "Não foi possível atualizar a sessão"
- "Tentativa de repetição de 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"
Auditoria (Azul)
O nível de log de auditoria registra alterações no banco de dados feitas pelo POS, capturando o estado completo antes e depois de cada modificação. Isso é útil para rastrear exatamente o que mudou e quando, por exemplo durante a criação de pedidos, ajustes de estoque ou atualizações de clientes.
As entradas de auditoria incluem:
- Tipo de entidade - O recurso que foi modificado (por exemplo, pedido, produto, cliente)
- Ação - O tipo de alteração (criar, atualizar, excluir)
- Estado anterior - Os valores anteriores antes da alteração
- Estado posterior - Os novos valores após a alteração
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.
Página de Logs do WP Admin
O plugin do POS também fornece uma página de Logs do lado do servidor na área administrativa do WordPress. Esta página mostra avisos e erros específicos do POS registrados no servidor, o que pode ajudar a diagnosticar problemas que podem não aparecer no próprio aplicativo do POS.
Acessando a Página de Logs do WP Admin
Navegue até WP Admin > POS > Settings, depois selecione a aba Tools e clique em Logs.
Distintivo de Não Lidos
O item de menu Logs exibe um distintivo indicando entradas de log não lidas:
- Distintivo vermelho - Há entradas de nível de erro não lidas
- Distintivo âmbar - Há entradas de nível de aviso não lidas (mas nenhum erro)
Visitar a página de Logs redefine as contagens de não lidos. As contagens são rastreadas por usuário, então cada administrador vê seu próprio status de não lidos.
Filtrando Entradas
Use o filtro de nível para restringir as entradas de log:
- All - Mostrar todas as entradas de log
- Errors - Mostrar apenas entradas de nível de erro
- Warnings - Mostrar apenas entradas de nível de aviso
Entradas Expansíveis
Mensagens de log longas são truncadas em aproximadamente 100 caracteres. Clique em uma entrada para expandi-la e ver a mensagem completa junto com quaisquer dados de contexto adicionais.
Paginação
As entradas de log são paginadas no lado do servidor. Use os controles de paginação para navegar pelas entradas mais antigas.
Banner de Erros Fatais
Se o servidor tiver arquivos fatal-errors-*.log, a página de Logs exibe um banner de aviso no topo. Esse banner direciona para WooCommerce > Status > Logs, onde você pode visualizar os logs completos de erros fatais. Erros fatais geralmente são falhas de nível PHP que impedem que a API do POS responda.
Usando Logs para Suporte
Ao solicitar suporte:
- Reproduza o problema - Realize a ação que causa o problema
- Verifique os logs - Procure erros (vermelho) ou avisos (laranja)
- Expanda o contexto - Obtenha os detalhes completos em JSON
- Anote o código de erro - Inclua isso em sua solicitação de suporte
- 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