Logs
La pantalla de Logs registra la actividad del sistema dentro del POS. Es una herramienta esencial para depurar problemas y entender lo que está sucediendo detrás de escena.
Acceso a los Registros
Abre la pantalla de Logs desde el cajón de navegación izquierda (el ícono del latido).
Resumen de la Interfaz
Buscar y Filtrar
- Buscar Registros - Encuentra entradas de registro específicas por contenido del mensaje
- Filtro de Nivel de Log - Filtra por nivel de log (info, warn, error)
- Configuraciones de visualización - Configura las columnas visibles
Tabla de Logs
Cada entrada de registro muestra:
| Columna | Descripción |
|---|---|
| Hora | Cuándo ocurrió el evento |
| Nivel | Severidad: info (gris), warn (naranja), error (rojo) |
| Mensaje | Descripción legible del evento |
| Contexto | JSON expandible con detalles adicionales |
| Código | Código de error (enlaces a la documentación) |
Niveles de Log
Info (Gris)
Operaciones normales y eventos exitosos:
- "Se obtuvieron todos los ID para productos"
- "Se sincronizaron nuevos clientes"
- "Se obtuvieron todos los ID para impuestos"
Warn (Naranja)
Problemas no críticos que pueden necesitar atención:
- "No se pudo actualizar la sesión"
- "Intento de reintentar la sincronización"
Error (Rojo)
Problemas que necesitan ser abordados:
- "Lo siento, no puedes listar recursos" (problema de permisos)
- "La solicitud de API falló"
- "Error de sincronización de base de datos"
Datos de Contexto
Haz clic en la flecha de expansión en cualquier entrada de registro para ver el contexto JSON detallado:
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
Estos datos incluyen:
- Conteos de artículos - Cuántos registros fueron afectados
- Tiempo de ejecución - Cuánto tiempo tomó la operación
- Carga del servidor - Métricas de rendimiento del servidor
- Detalles de solicitud/respuesta - Para depurar problemas de API
Códigos de Error
Muchas entradas de registro incluyen un código de error (p. ej., API02004, DB01001). Estos códigos enlazan directamente a la documentación de Códigos de Error, que proporciona:
- Explicación detallada del error
- Causas comunes
- Pasos de solución de problemas
Entradas de Registro Comunes
Operaciones de Sincronización
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
Estos indican actividad de sincronización normal. El contexto muestra cuántos elementos fueron sincronizados.
Errores de Permisos
[error] Sorry, you cannot list resources {...} API02004
Esto normalmente significa que el usuario no tiene permiso para acceder a un recurso. Verifica los roles de usuario en WP Admin > POS > Configuraciones > Acceso.
Problemas de Sesión
[warn] Unable to refresh session {...} API02007
El POS no pudo actualizar la sesión de autenticación. Esto puede requerir cerrar sesión y volver a ingresar.
Uso de Logs para Soporte
Al solicitar soporte:
- Reproduce el problema - Realiza la acción que causa el problema
- Revisa los registros - Busca errores (rojos) o advertencias (naranjas)
- Expande el contexto - Obtén los detalles completos en JSON
- Nota el código de error - Incluye esto en tu solicitud de soporte
- Copia entradas relevantes - Comparte los mensajes de registro con contexto
Monitoreo del Rendimiento
Los registros incluyen tiempo de ejecución y métricas de carga del servidor. Si notas:
- Altos tiempos de ejecución - El servidor puede estar sobrecargado o lento
- Altos valores de carga del servidor - Considera la optimización del servidor
- Frecuentes timeouts - Verifica la conectividad de la red