Trabajar con registros

Los servicios backend de la plataforma Navixy siempre recopilan registros al ejecutarse. Estos registros contienen entradas de todas las acciones realizadas por los servicios Java, así como los errores que ocurren durante la operación de la plataforma. El análisis de registros es una parte integral del proceso de resolución de problemas.

Ubicación de los registros

Los tres servicios backend Java tienen sus propios registros. Los directorios predeterminados son los siguientes:

Servicio	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

Los directorios anteriores son los predeterminados, pero en algunos servidores los registros pueden almacenarse en un directorio personalizado a petición del propietario de la instancia. Para más detalles, consulte el Service logs storage settings página.

Contenido de los registros

Registros de API-server son los primeros que deben analizarse cuando ocurren problemas relacionados con el funcionamiento de la plataforma en su conjunto y funciones individuales. Si observa que alguna solicitud API no se ejecuta (durante integraciones de API o en las herramientas de desarrollo del navegador), busque en el registro por el encabezado o el contenido de esa solicitud. Si hay problemas que afectan a un dispositivo específico o a un grupo de dispositivos, busque por IMEI o ID de ese dispositivo.

Registros de SMS-server deben verificarse cuando se presenten problemas de mensajería. Esto se aplica tanto a SMS como a mensajería por correo electrónico (independientemente del nombre del servicio). Busque problemas por número de teléfono o correo electrónico.

Registros de TCP-server contienen toda la información relacionada con el funcionamiento de los dispositivos, la conexión de red y las verificaciones de licencia. Aquí puede buscar por IMEI del dispositivo, dirección de red u otros parámetros relacionados con el problema.

Si conoce las circunstancias en las que ocurre el problema, una buena táctica es provocarlo y comprobar qué entradas aparecen en los registros. De esta manera "capturará" el error en el momento en que ocurre.

Herramientas útiles

Linux

Puede buscar valores específicos en los registros con grep comando. De esta manera, verá la(s) entrada(s) del registro que contienen el valor que busca. Ejemplo:

grep "12345678910" log.txt

Para ver nuevas entradas del registro en tiempo real, utilice tail comando. Esto es especialmente útil cuando tiene la oportunidad de provocar los problemas.

tail -f log.txt

Para ver el registro completo, use cualquier editor de texto que prefiera, como nano o vim.

Windows

El Bloc de notas estándar en Windows no es capaz de manejar archivos de texto grandes, así que no intente usarlo para ver registros: simplemente se quedará colgado. En su lugar, utilice cualquier editor de texto avanzado de terceros.

Los editores más populares para Windows son:

• Notepad++

• Sublime Text

Estos editores tienen capacidades de búsqueda avanzadas y pueden manejar archivos de gran tamaño, lo que los hace muy útiles al trabajar con registros en instancias grandes.