Logs
O POS tem duas interfaces de log: o log de atividades no aplicativo (dentro do aplicativo do POS) e a página Logs do WP Admin (dentro do WordPress). Juntas, elas dão um panorama completo da atividade do POS para depuração e auditoria.
Logs do Aplicativo do POS
A partir da versão 1.10.0, o log no aplicativo fica em Saúde da loja → Logs (o ícone de batimento cardíaco na gaveta de navegação — a tela de Logs independente que ele substitui foi removida). Esta seção descreve o log da versão 1.10.0; veja Saúde da loja para o passeio completo por essa área.
Acessando os Logs
Abra Saúde da loja na gaveta de navegação à esquerda (o ícone de batimento cardíaco) e selecione a aba Logs.
Visão Geral da Interface
O log é um registro da atividade neste dispositivo, mantido por 30 dias. Cada linha mostra:
| Coluna | Descrição |
|---|---|
| Hora | Quando o evento ocorreu |
| Nível | Severidade — error, warning, action, sync ou info |
| Evento | Descrição legível (traduzida no momento da exibição) |
| Duração | Quanto tempo a operação levou |
| Status | O resultado |
Acima do registro, uma linha de status mostra a pulsação da sincronização — quando a última verificação de alterações foi executada e quando a próxima está prevista — e um cabeçalho de estatísticas conta os eventos e erros do dia, os registros travados e as alterações aguardando envio. A maioria deles funciona como filtro ao ser tocada.
Filtragem
Chips predefinidos filtram o registro: Todos, Ações (coisas que uma pessoa fez — vendas, edições, alterações de configurações), Erros e Sincronização. Uma opção separada de Diagnósticos detalhados captura informações extras por 24 horas e depois se desativa sozinha.
Detalhes da Linha e Códigos de Erro
Toque em uma linha de erro ou aviso para expandi-la. A visão de detalhes oferece:
- O que aconteceu, em linguagem simples
- Seus dados — uma declaração explícita sobre a segurança dos dados (por exemplo, se a alteração está a salvo no servidor ou existe apenas neste dispositivo)
- O que fazer — o próximo passo recomendado
- Um link de ajuda — os erros trazem um código (por exemplo,
SYNC121,AUTH311) que leva à documentação de Códigos de Erro - Um código de evento copiável — os títulos das linhas são traduzidos no momento da exibição, então o código do evento é o identificador estável. Cite-o ao entrar em contato com o suporte.
Página Logs do WP Admin
O plugin do POS também disponibiliza uma página de Logs do lado do servidor na área administrativa do WordPress. Essa página mostra avisos e erros específicos do POS registrados no servidor, o que pode ajudar a diagnosticar problemas que talvez não apareçam no próprio aplicativo do POS.
Acessando a Página Logs do WP Admin
Navegue até WP Admin > POS > Configurações, selecione a aba Ferramentas e clique em Logs.
Selo de Não Lidos
O item de menu Logs exibe um selo indicando entradas de log não lidas:
- Selo vermelho - Há entradas não lidas de nível de erro
- Selo âmbar - Há entradas não lidas de nível de aviso (mas nenhum erro)
Visitar a página Logs zera as contagens de não lidos. As contagens são registradas por usuário, então cada administrador vê o próprio status de não lidos.
Filtrando Entradas
Use o filtro de nível para restringir as entradas de log:
- Todos - Exibe todas as entradas de log
- Erros - Exibe apenas entradas de nível de erro
- Avisos - Exibe 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 de 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 por entradas mais antigas.
Banner de Erros Fatais
Se o servidor tiver arquivos fatal-errors-*.log, a página Logs exibirá um banner de aviso no topo. Esse banner leva a WooCommerce > Status > Logs, onde é possível ver os logs completos de erros fatais. Erros fatais são normalmente falhas em nível de PHP que impedem a API do POS de responder.
Usando os Logs para Suporte
Ao solicitar suporte:
- Reproduza o problema - Execute a ação que causa o problema
- Verifique os logs - Procure erros ou avisos em Saúde da loja → Logs
- Expanda a linha - Leia a linha sobre a segurança dos dados e o próximo passo sugerido
- Copie o código do evento - Inclua-o na sua solicitação de suporte; ele é o identificador estável do que aconteceu
- Ative os Diagnósticos detalhados se o suporte pedir mais detalhes — eles capturam informações extras por 24 horas
Monitoramento de Desempenho
O desempenho agregado fica em Saúde da loja → Desempenho: requisições, dados transferidos (um limite inferior quando as respostas omitem o próprio tamanho) e tempo de resposta típico nas últimas 24 horas, além de uma faixa de disponibilidade por hora. Se os tempos de resposta parecerem altos, veja Desempenho do Servidor.