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

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 página.

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.

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.

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++

• Sublime Text

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.