Registro y monitorización

Este documento explica el sistema de registro del plugin, cómo leer y gestionar los archivos de log y cómo utilizar los paneles de monitorización integrados en la administración de WordPress para realizar un seguimiento de los errores y advertencias en producción.

Cuándo utilizar este documento

Lea este documento si es un administrador del sitio responsable de monitorizar un sitio activo, diagnosticar comportamientos inesperados o preparar información para una solicitud de soporte. Cubre todo lo necesario para comprender, ver y mantener el log del plugin.

Descripción general

El plugin escribe toda la salida de diagnóstico en un único archivo de log plano almacenado en el directorio de subidas de WordPress. El log registra la actividad de importación, las respuestas de la API, los resultados de la descarga de imágenes, los eventos de cron y cualquier error o advertencia que ocurra durante el funcionamiento del plugin.

El acceso al log se proporciona a través de la página de administración ADP Car Market Hub → Logs, que presenta:

• Un panel de Errores recientes que muestra las últimas entradas con nivel de error
• Un panel de Advertencias recientes que muestra las últimas entradas con nivel de advertencia
• Un Visor de logs para leer y vaciar el archivo de log sin procesar

La pestaña Sistema y ayuda (ADP Car Market Hub → System & Help) proporciona una monitorización complementaria a nivel de sistema: estado de conectividad de la API, programaciones de tareas cron, comprobaciones del entorno PHP y acciones de tareas en segundo plano.

Requisitos

• Cuenta de administrador con la capacidad manage_as24_imports.
• El directorio de subidas de WordPress debe tener permisos de escritura para el proceso del servidor web para que el archivo de log se pueda crear y escribir.

Ubicación y formato del archivo de log

El archivo de log se escribe en:

{wp-uploads}/as24ci-logs/adp-car-market-hub.log

Donde {wp-uploads} es el directorio base de subidas de WordPress, normalmente wp-content/uploads/.

El directorio de logs está protegido automáticamente contra el acceso web público mediante un archivo .htaccess (para Apache) y un archivo silencioso index.php. Ambos se crean cuando el plugin configura el directorio por primera vez.

Cada línea de log sigue el formato:

[YYYY-MM-DD HH:MM:SS UTC] [LEVEL] Message text

Por ejemplo:

[2025-04-30 06:15:03 UTC] [INFO] Import runner (wp-cron): started.
[2025-04-30 06:15:47 UTC] [INFO] Import runner (wp-cron) finished: inserted=3 updated=12 skipped=85 errors=0
[2025-04-30 06:16:02 UTC] [INFO] Image queue worker: processed=30 errors=0 remaining=45

Niveles de log

Registro detallado (Verbose logging)

Cuando el registro detallado está activado (por defecto), el importador escribe una línea de log adicional por cada vehículo procesado y cada acción de imagen realizada. Esto es útil para diagnosticar problemas de importación en catálogos pequeños, pero puede generar un volumen de log significativo en catálogos grandes.

El registro detallado se controla mediante la opción Verbose logging. Para reducir el volumen de logs en catálogos grandes, desactive el registro detallado en los ajustes del plugin.

Cuando el registro detallado está activado, verá líneas como:

[INFO] Import vehicle abc123 (seller 456) begin.
[INFO] Import vehicle abc123 result=updated.

Enmascaramiento de seguridad en los logs

El registrador enmascara automáticamente los valores sensibles antes de escribirlos en el disco:

• Los parámetros de consulta token=... se reemplazan con token=***
• Los parámetros client_secret=... se reemplazan con client_secret=***
• Los valores de cabecera Authorization: Bearer ... se reemplazan con Bearer ***

Esto significa que el archivo de log no contiene credenciales de API ni tokens de cron, incluso si aparecen en una URL o en el contexto de una solicitud.

Rotación de logs y gestión de archivos históricos

El registrador comprueba periódicamente el tamaño del archivo de log (en la primera llamada y cada 100 llamadas de registro posteriores). Cuando el archivo supera los 10 MB, el archivo de log actual se mueve a un archivo histórico con marca de tiempo en el mismo directorio utilizando el formato:

adp-car-market-hub-YYYYMMDD-HHMMSS.log

A continuación, se inicia automáticamente un nuevo archivo de log activo vacío.

Los archivos históricos con más de 7 días de antigüedad se eliminan automáticamente en cada comprobación de rotación.

Si necesita conservar el historial de logs durante más de 7 días, copie los archivos de log archivados a una ubicación de almacenamiento independiente antes de que se eliminen.

Uso de la página de administración de Logs

Visualización de errores y advertencias recientes

1. Abra ADP Car Market Hub → Logs.
2. El panel Errores recientes muestra las entradas más recientes que contienen [ERROR] de las últimas 2.000 líneas del archivo de log (hasta 50 entradas).
3. El panel Advertencias recientes muestra las entradas más recientes que contienen [WARNING] de la misma ventana de escaneo.
4. Si ambos paneles están vacíos, no se encontraron errores ni advertencias en el historial de logs reciente.

Visualización del log sin procesar

1. En la misma página, desplácese hacia abajo hasta la tarjeta del Visor de logs.
2. El visor muestra las últimas 500 líneas de forma predeterminada. Cambie el campo Líneas y haga clic en Recargar para mostrar un número diferente (de 100 a 2.000 líneas).
3. Al hacer clic en cualquier parte del texto del visor de logs se selecciona todo el contenido visible, lo que facilita la copia del log para su análisis externo.

Vaciar el archivo de log

1. En la barra de herramientas del Visor de logs, haga clic en Vaciar archivo de log.
2. Confirme el mensaje del cuadro de diálogo. El archivo se truncará para quedar vacío y se escribirá una única entrada de confirmación.
3. Vaciar el log es una acción unidireccional y no se puede deshacer. Realice una copia primero si necesita conservar el contenido.

El botón de vaciado solo se muestra cuando el archivo de log existe. Si el archivo no se encuentra o no tiene permisos de escritura, se mostrará un aviso.

Monitorización de la pestaña Sistema y ayuda

La página ADP Car Market Hub → Sistema y ayuda proporciona monitorización del entorno y de la conectividad:

Los indicadores de estado utilizan una convención de semáforo:

• Verde (correcto) — dentro del rango recomendado
• Ámbar (advertencia) — aceptable pero puede requerir atención
• Rojo (incorrecto) — fuera del rango recomendado; es probable que cause problemas

Exportación de diagnósticos

La pestaña Sistema y ayuda incluye un botón Descargar diagnósticos que exporta un archivo ZIP (o JSON si ZipArchive no está disponible) que contiene información del sistema útil para solicitudes de soporte. La exportación no incluye credenciales ni datos privados.

Referencia de configuración

Notas operativas

• Si el directorio de subidas no tiene permisos de escritura, el archivo de log no se podrá crear y todas las escrituras de log se descartarán silenciosamente. La pestaña Sistema y ayuda mostrará una advertencia sobre el estado del directorio de subidas.
• La rotación de logs se activa mediante las escrituras de log, no por una tarea programada independiente. Si no se produce ningún registro (por ejemplo, el sitio está inactivo), la rotación no se ejecutará hasta la siguiente escritura de log.
• El log no registra las visitas a las páginas del frontend ni los eventos de analíticas. Estos se almacenan en la tabla de la base de datos {prefix}as24ci_analytics. Consulte la pestaña Analytics para ver esos datos.
• En instalaciones multisitio de WordPress, cada sitio de la red tiene su propio directorio de subidas y, por lo tanto, su propio archivo de log independiente.

Resolución de problemas

Documentos relacionados

• Monitorización de importación
• Operación diaria
• Proceso de actualización