> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/working-with-logs.md).

# Trabalhando com logs

Os serviços de backend da plataforma Navixy sempre coletam logs durante a execução. Esses logs contêm entradas sobre todas as ações realizadas pelos serviços Java, bem como erros que ocorrem durante a operação da plataforma. A análise de logs é parte integrante do processo de solução de problemas.

## Localização dos logs

Os três serviços backend Java têm seus próprios logs. Os diretórios padrão são os seguintes:

| **Serviço**    | **Linux**                 | **Windows**            |
| -------------- | ------------------------- | ---------------------- |
| **API-server** | /home/java/api-server/log | C:\java\api-server\log |
| **SMS-server** | /home/java/sms-server/log | C:\java\sms-server\log |
| **TCP-server** | /home/java/tcp-server/log | C:\java\tcp-server\log |

{% hint style="info" %}
Os diretórios acima são os padrão, mas em alguns servidores os logs podem ser armazenados em um diretório personalizado a pedido do proprietário da instância. Para mais detalhes, verifique o [Configurações de armazenamento de logs do serviço](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/working-with-logs/service-logs-storage-settings.md) página.
{% endhint %}

## Conteúdo dos logs

**Logs do API-server** são os primeiros a serem analisados quando ocorrem quaisquer problemas relacionados à operação da plataforma como um todo ou de funções individuais. Se você perceber que alguma solicitação API não está sendo executada (durante integrações de API ou nas ferramentas de desenvolvedor do navegador), pesquise no log pelo cabeçalho ou conteúdo dessa solicitação. Se houver problemas afetando um dispositivo específico ou um grupo de dispositivos, pesquise pelo IMEI ou ID desse dispositivo.

**Logs do SMS-server** devem ser verificados quando houver qualquer problema de mensagens. Isso se aplica tanto a mensagens SMS quanto a e-mails (independentemente do nome do serviço). Pesquise problemas pelo número de telefone ou e-mail.

**Logs do TCP-server** contêm todas as informações relacionadas à operação dos dispositivos, conexão de rede e verificações de licença. Aqui você pode pesquisar pelo IMEI do dispositivo, endereço de rede ou quaisquer outros parâmetros relacionados ao problema.

{% hint style="info" %}
Se você conhece as circunstâncias sob as quais o problema ocorre, uma boa tática é acioná-lo e verificar quais entradas aparecem nos logs. Dessa forma, você "capturará" o erro no momento em que ocorrer.
{% endhint %}

## Ferramentas úteis

#### Linux

Você pode pesquisar valores específicos nos logs com o **grep** comando. Dessa forma, você verá a(s) entrada(s) do log que contêm o valor que procura. Exemplo:

```
grep "12345678910" log.txt
```

Para visualizar novas entradas do log em tempo real, use o **tail** comando. Isso é especialmente útil quando você tem a oportunidade de reproduzir problemas.

```
tail -f log.txt
```

Para visualizar o log inteiro, utilize qualquer editor de texto de sua preferência, como **nano** ou **vim**.

#### Windows

O Bloco de Notas padrão do Windows é incapaz de lidar com arquivos de texto grandes, então não tente usá-lo para visualizar logs — ele apenas travará. Em vez disso, use qualquer editor de texto avançado de terceiros.

Os editores mais populares para Windows são:

* [**Notepad++**](https://notepad-plus-plus.org/)
* [**Sublime Text**](https://www.sublimetext.com/)

Esses editores possuem recursos avançados de busca e conseguem lidar com arquivos de grande porte, tornando-os muito úteis ao trabalhar com logs em instâncias grandes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/working-with-logs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.