El modo de depuración permite registrar detalladamente toda la actividad del complemento, incluidas las solicitudes de API, las respuestas y los pasos de procesamiento interno. Esto resulta útil para solucionar problemas de conexión, sincronización o comportamientos inesperados.
Cómo habilitar el modo de depuración
- Ir a Integración de WooCommerce > Mautic y abrir el Conexión pestaña.
- Desplácese hacia abajo hasta el Registro sección en la parte inferior de la página.
- Marque la casilla con la etiqueta Habilitar registro de depuración.
- Haga clic Guardar cambios.
Modo normal frente a modo de depuración
El complemento utiliza diferentes niveles de registro dependiendo de si el modo de depuración está habilitado:
- Modo normal (modo de depuración desactivado): Solo se registran las advertencias y los errores. Esto incluye fallos de autenticación, errores de API y otros problemas que requieren atención. Esta es la configuración recomendada para tiendas en producción.
- Modo de depuración (Modo de depuración activado): Se registran todos los niveles de registro, incluidos los mensajes de depuración detallados. Esto incluye todas las URL y métodos de solicitud de API, los intentos de actualización de tokens, las operaciones de sincronización y otros detalles de procesamiento.
Dónde encontrar los registros
El plugin escribe sus registros a través del sistema de registro de WooCommerce. Para ver los registros:
- En WordPress, vaya a WooCommerce > Estado.
- Haga clic en el Troncos pestaña.
- En el menú desplegable del archivo de registro, busque los archivos con el nombre de origen Integración de Mautic con WooCommerce.
- Seleccione un archivo de registro y haga clic en Ver para ver su contenido.
Los archivos de registro se nombran con la fuente y la fecha, por lo que es posible que vea varios archivos si el complemento ha estado registrando datos durante varios días.
¿Qué se registra?
En modo normal
- Errores de API (solicitudes fallidas, códigos de error HTTP)
- Fallos de autenticación
- Fallos en la actualización de tokens
- Advertencias sobre problemas con los datos (por ejemplo, direcciones de correo electrónico no válidas o valores de campo rechazados).
En modo depuración (todo lo anterior, además)
- Cada solicitud API con el método HTTP y la URL
- Operaciones de sincronización de contactos
- Procesamiento de sincronización de pedidos
- Eventos de detección y recuperación de carritos abandonados
- Intentos de actualización de token
Nota sobre el rendimiento
El modo de depuración escribe una cantidad significativamente mayor de datos en los archivos de registro. En una tienda con mucho tráfico, esto puede generar archivos de registro de gran tamaño y añadir una pequeña sobrecarga a cada operación. Por este motivo, solo debe habilitar el modo de depuración cuando esté solucionando activamente un problema. Una vez resuelto el problema, desactive el modo de depuración para que su tienda siga funcionando al máximo rendimiento.
Registro de respaldo
Si el sistema de registro de WooCommerce no está disponible por cualquier motivo, el complemento recurre a escribir entradas en el registro de errores de PHP. Puede encontrar estas entradas en el archivo de registro de errores de su servidor, que normalmente se encuentra en una ruta como /var/log/php-errors.log o según lo configurado por su proveedor de alojamiento.
Referencia de niveles de registro
El complemento utiliza los siguientes niveles de registro, ordenados de mayor a menor detalle:
- Depurar – Información detallada de diagnóstico (solo registrada en modo depuración).
- Información – Mensajes operativos generales (solo registrados en modo depuración).
- Aviso – Eventos normales pero dignos de mención (solo registrados en modo depuración).
- Advertencia – Ocurrió algo inesperado, pero la operación continuó.
- Error – Una operación falló.
- Crítico – Un fallo grave que requiere atención inmediata.
- Alerta – Se deben tomar medidas de inmediato.
- Emergencia – El sistema no se puede utilizar.
En modo normal, solo se registran los niveles del 4 al 8 (Advertencia y superiores). En modo depuración, se registran los 8 niveles.