# Logs

El POS tiene dos interfaces de registro: la **pantalla de Logs dentro de la aplicación** (dentro de la aplicación POS) y la **página de Logs de WP Admin** (dentro de WordPress). Juntas te ofrecen una imagen completa de la actividad del POS para depuración y auditoría.

<!-- -->

## Registros de la Aplicación POS[​](#pos-application-logs "Enlace directo a Registros de la Aplicación POS")

### Acceso a los Registros[​](#accessing-logs "Enlace directo a 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[​](#interface-overview "Enlace directo a Resumen de la Interfaz")

#### Buscar y Filtrar[​](#search--filter "Enlace directo a 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[​](#log-table "Enlace directo a 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[​](#log-levels "Enlace directo a Niveles de Log")

#### Info (Gris)[​](#info-grey "Enlace directo a 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"

#### Warning (Naranja)[​](#warning-orange "Enlace directo a Warning (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)[​](#error-red "Enlace directo a 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"

#### Audit (Azul)[​](#audit-blue "Enlace directo a Audit (Azul)")

El nivel de registro de auditoría registra los cambios en la base de datos realizados por el POS, capturando el estado completo antes y después de cada modificación. Esto es útil para rastrear exactamente qué cambió y cuándo, por ejemplo durante la creación de pedidos, ajustes de inventario o actualizaciones de clientes.

Las entradas de auditoría incluyen:

* **Tipo de entidad** - El recurso que fue modificado (p. ej., pedido, producto, cliente)
* **Acción** - El tipo de cambio (crear, actualizar, eliminar)
* **Estado anterior** - Los valores previos antes del cambio
* **Estado posterior** - Los nuevos valores después del cambio

### Datos de Contexto[​](#context-data "Enlace directo a 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[​](#error-codes "Enlace directo a 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](/es/error-codes/.md), que proporciona:

* Explicación detallada del error
* Causas comunes
* Pasos de solución de problemas

### Entradas de Registro Comunes[​](#common-log-entries "Enlace directo a Entradas de Registro Comunes")

#### Operaciones de Sincronización[​](#sync-operations "Enlace directo a 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[​](#permission-errors "Enlace directo a 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 > Settings > Access`.

#### Problemas de Sesión[​](#session-issues "Enlace directo a 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.

## Página de Logs de WP Admin[​](#wp-admin-logs-page "Enlace directo a Página de Logs de WP Admin")

El plugin del POS también proporciona una página de Logs del lado del servidor en el área de administración de WordPress. Esta página muestra las advertencias y los errores específicos del POS registrados en el servidor, lo que puede ayudar a diagnosticar problemas que tal vez no aparezcan en la propia aplicación POS.

### Acceso a la Página de Logs de WP Admin[​](#accessing-the-wp-admin-logs-page "Enlace directo a Acceso a la Página de Logs de WP Admin")

Navega a **WP Admin > POS > Settings**, luego selecciona la pestaña **Tools** y haz clic en **Logs**.

### Insignia de No Leídos[​](#unread-badge "Enlace directo a Insignia de No Leídos")

El elemento de menú Logs muestra una insignia que indica las entradas de registro no leídas:

* **Insignia roja** - Hay entradas de nivel de error no leídas
* **Insignia ámbar** - Hay entradas de nivel de advertencia no leídas (pero sin errores)

Visitar la página de Logs restablece los recuentos de no leídos. Los recuentos se rastrean por usuario, por lo que cada administrador ve su propio estado de no leídos.

### Filtrado de Entradas[​](#filtering-entries "Enlace directo a Filtrado de Entradas")

Usa el filtro de nivel para acotar las entradas de registro:

* **All** - Mostrar todas las entradas de registro
* **Errors** - Mostrar solo las entradas de nivel de error
* **Warnings** - Mostrar solo las entradas de nivel de advertencia

### Entradas Expandibles[​](#expandable-entries "Enlace directo a Entradas Expandibles")

Los mensajes de registro largos se truncan a aproximadamente 100 caracteres. Haz clic en una entrada para expandirla y ver el mensaje completo junto con cualquier dato de contexto adicional.

### Paginación[​](#pagination "Enlace directo a Paginación")

Las entradas de registro se paginan en el lado del servidor. Usa los controles de paginación para navegar por las entradas más antiguas.

### Banner de Errores Fatales[​](#fatal-errors-banner "Enlace directo a Banner de Errores Fatales")

Si el servidor tiene archivos `fatal-errors-*.log`, la página de Logs muestra un banner de advertencia en la parte superior. Este banner enlaza a **WooCommerce > Status > Logs** donde puedes ver los registros completos de errores fatales. Los errores fatales son normalmente caídas a nivel de PHP que impiden que la API del POS responda.

## Uso de Logs para Soporte[​](#using-logs-for-support "Enlace directo a Uso de Logs para Soporte")

Al solicitar soporte:

1. **Reproduce el problema** - Realiza la acción que causa el problema
2. **Revisa los registros** - Busca errores (rojos) o advertencias (naranjas)
3. **Expande el contexto** - Obtén los detalles completos en JSON
4. **Nota el código de error** - Incluye esto en tu solicitud de soporte
5. **Copia entradas relevantes** - Comparte los mensajes de registro con contexto

## Monitoreo del Rendimiento[​](#performance-monitoring "Enlace directo a 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

## Documentación Relacionada[​](#related-documentation "Enlace directo a Documentación Relacionada")

[Códigos de ErrorExplicaciones detalladas de errores](/es/error-codes/.md)

[Resolución de ProblemasProblemas comunes y soluciones](/es/category/troubleshooting.md)

[SoporteRecibir ayuda](/es/support/.md)