# 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[​](#pos-application-logs "Link direto para Logs do Aplicativo POS")

### Acessando os Logs[​](#accessing-logs "Link direto para 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[​](#interface-overview "Link direto para Visão Geral da Interface")

#### Buscar e Filtrar[​](#search--filter "Link direto para 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[​](#log-table "Link direto para 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[​](#log-levels "Link direto para Níveis de Log")

#### Info (Cinza)[​](#info-grey "Link direto para 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)[​](#warning-orange "Link direto para 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)[​](#error-red "Link direto para 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)[​](#audit-blue "Link direto para 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[​](#context-data "Link direto para 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[​](#error-codes "Link direto para 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](/pt-BR/error-codes/.md), que fornece:

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

### Entradas de Log Comuns[​](#common-log-entries "Link direto para Entradas de Log Comuns")

#### Operações de Sincronização[​](#sync-operations "Link direto para 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[​](#permission-errors "Link direto para 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[​](#session-issues "Link direto para 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[​](#wp-admin-logs-page "Link direto para 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[​](#accessing-the-wp-admin-logs-page "Link direto para 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[​](#unread-badge "Link direto para 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[​](#filtering-entries "Link direto para 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[​](#expandable-entries "Link direto para 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[​](#pagination "Link direto para 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[​](#fatal-errors-banner "Link direto para 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[​](#using-logs-for-support "Link direto para 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[​](#performance-monitoring "Link direto para 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

## Documentação Relacionada[​](#related-documentation "Link direto para Documentação Relacionada")

[Códigos de ErroExplicações detalhadas de erros](/pt-BR/error-codes/.md)

[Solução de ProblemasProblemas comuns e soluções](/pt-BR/category/troubleshooting.md)

[SuporteObter ajuda](/pt-BR/support/.md)