Monitoreo de importaciones

Este documento explica cómo monitorear el flujo de importación de vehículos en el plugin ADP Car Market Hub, incluyendo cómo leer los resultados de la ejecución de la importación, comprender los contadores de estado e identificar y responder a los fallos de importación.

Cuándo usar este documento

Lea este documento si es un administrador del sitio o un operador técnico que necesita confirmar que las importaciones programadas o manuales se están ejecutando correctamente, comprender qué significan los contadores de importación o investigar por qué los vehículos no aparecen o no se actualizan como se esperaba.

Descripción general

Cada vez que se ejecuta el flujo de importación —ya sea activado por WP-Cron, el endpoint cron REST o el botón Ejecutar importación ahora— el plugin registra el resultado en la tabla de opciones WordPress y escribe un resumen en el archivo de registro. Esta información se muestra en la pestaña Dashboard (fila de KPI y actividad reciente), la pestaña Automatización (hora y estado de la última ejecución) y la pestaña Logs (detalle por vehículo cuando el registro detallado está activado).

Requisitos

• Cuenta de administrador con la capacidad manage_as24_imports.
• Las credenciales de la API de AutoScout24 y al menos un Seller ID configurado en ADP Car Market Hub → Ajustes.
• Importación automática habilitada o una importación manual activada.

Contadores de estado de la ejecución de importación

Después de cada ejecución de importación, el plugin registra los siguientes contadores:

Una ejecución de importación saludable en un catálogo estable normalmente mostrará un recuento alto de skipped y un valor bajo o cero en inserted, updated y errors. Si los anuncios han cambiado, updated aumentará en consecuencia.

Visualización del estado de la importación en la administración

Pestaña Dashboard

1. Abra ADP Car Market Hub → Dashboard.
2. La fila de KPI muestra: - Total de vehículos importados (publicados y borradores) - Nuevos vehículos añadidos en los últimos 7 días - La marca de tiempo de la ejecución de importación más reciente
3. Los gráficos de tendencia del inventario e interés del cliente muestran la actividad histórica durante los períodos de tiempo seleccionados.
4. Los datos del Dashboard se almacenan en caché durante 3 minutos. Espere un momento después de una importación manual antes de verificar.

Pestaña Importación y límites

1. Abra ADP Car Market Hub → Referencia de importación y límites.
2. La fila Última ejecución muestra la marca de tiempo de la importación completada más reciente.
3. La fila Estado de la última ejecución muestra los contadores de la ejecución más reciente: insertados, actualizados, omitidos, errores.
4. La fila Programación muestra la configuración actual de WP-Cron o del cron del servidor.
5. Utilice el botón Forzar importación ahora para ejecutar una importación inmediata y observar el resultado.

Pestaña Logs

1. Abra ADP Car Market Hub → Referencia de Logs.
2. Los paneles Errores recientes y Advertencias recientes muestran las últimas 50 entradas de error o advertencia del registro, escaneando las 2000 líneas más recientes.
3. Con el registro detallado habilitado, el Visor de logs muestra una línea por cada vehículo procesado: `` [INFO] Import vehicle {listing_id} (seller {seller_id}) begin. [INFO] Import vehicle {listing_id} result=updated. ``
4. Una ejecución de importación completada produce una línea de resumen: `` [INFO] Import runner (wp-cron) finished: inserted=X updated=X skipped=X errors=X ``

Pestaña Sistema y ayuda — Tareas en segundo plano

1. Abra ADP Car Market Hub → Requisitos técnicos del sistema.
2. La tabla Tareas en segundo plano muestra el hook del trabajo de importación (as24ci_scheduled_import), su programación, la hora de la próxima ejecución y el estado actual del bloqueo.
3. Las insignias de estado indican: - Programado (verde) — el evento de importación está en cola en WP-Cron - Ejecutándose (ámbar) — el bloqueo de importación está activo actualmente - Bloqueo atascado (rojo) — se detectó un bloqueo obsoleto; se borrará automáticamente en el próximo intento de ejecución - No programado (ámbar) — el evento cron de importación no está registrado; verifique los ajustes de automatización - Gestionado por el cron del servidor (verde) — el modo de cron del servidor está activo

Entendiendo el bloqueo de importación

El plugin utiliza un bloqueo transitorio (as24ci_cron_import_running) para evitar ejecuciones de importación superpuestas. El bloqueo almacena la marca de tiempo Unix de cuándo comenzó la ejecución y expira después de 40 minutos.

Si una ejecución de importación comienza mientras el bloqueo está activo y este no está obsoleto, la nueva ejecución se omite y se escribe el siguiente mensaje en el registro:

[INFO] Import runner (wp-cron): already in progress, skipping.

Si el bloqueo tiene más de 40 minutos (lo que indica que la ejecución anterior finalizó sin liberarlo), el bloqueo se borra automáticamente y se procede con una nueva ejecución:

[INFO] Import runner (wp-cron): stale lock detected (age=Xs), clearing and proceeding.

No es necesario borrar este bloqueo manualmente en condiciones normales de funcionamiento.

Máximo de vehículos por ejecución

Cuando el ajuste Máximo de vehículos por ejecución está configurado con un valor distinto de cero, el ejecutor de la importación se detiene después de procesar esa cantidad de vehículos insertados o actualizados. Los vehículos omitidos (aquellos sin cambios) no cuentan para este límite. Cuando se alcanza el límite, el registro registra:

[INFO] Import runner (wp-cron): vehicle limit (N) reached, stopping. inserted=X updated=X skipped=X errors=X

La siguiente ejecución programada continuará con los anuncios restantes. Este ajuste está diseñado para entornos con restricciones estrictas de tiempo de ejecución.

Monitoreo de la sincronización completa

Cuando la Sincronización completa está habilitada, el ejecutor de la importación realiza un paso adicional después de la importación regular: compara todos los ID de publicaciones de vehículos importados localmente con el conjunto de ID de anuncios activos devueltos por la API, y elimina permanentemente cualquier publicación local cuyos ID de anuncios ya no estén presentes.

El resultado de la sincronización completa se registra:

[INFO] Full sync completed: kept=X deleted=X.

Precaución: La sincronización completa no se ejecutará si se alcanzó el límite de vehículos durante la importación, ya que el conjunto de anuncios remotos podría estar incompleto. Esta es una medida de seguridad para evitar la eliminación masiva accidental cuando la API devuelve un resultado parcial.

La sincronización completa se omite (con un aviso en el registro) si el conjunto de anuncios remotos está vacío.

Monitoreo de la conectividad de la API

1. Abra ADP Car Market Hub → Requisitos técnicos del sistema.
2. La tarjeta Conectividad y API muestra: - Si la URL base de la API está configurada y es accesible (código de respuesta HTTP y latencia) - Si un token de OAuth válido está almacenado en caché y su tiempo de expiración - Si el endpoint cron REST es accesible (si se ha configurado un token de cron) - Si la API de Market Hub es accesible

Si la API no está accesible durante una importación, los errores se registran por anuncio y se contabilizan en el contador errors.

Referencia de configuración

Notas operativas

• El ejecutor de la importación escribe la marca de tiempo de la última ejecución en as24ci_last_run_time y los contadores de estado en as24ci_last_run_status en la tabla de opciones WordPress después de cada ejecución.
• La pestaña Dashboard lee de una caché transitoria con un TTL de 3 minutos. Inmediatamente después de una importación manual, es posible que los recuentos mostrados aún no reflejen la última ejecución.
• El contador api_active refleja el número de anuncios que pasaron el filtro del lado del cliente del plugin (estado = activated, live = true). Este número puede ser inferior al total bruto informado por la API porque el plugin filtra los anuncios inactivos y no publicados antes de importar.
• El plugin intenta aumentar el límite de tiempo de ejecución de PHP a 300 segundos al comienzo de cada importación activada por WP-Cron o REST. Si su entorno de hosting no lo permite, las importaciones de catálogos grandes pueden agotar el tiempo de espera. La pestaña Sistema y ayuda muestra una insignia para el valor actual de max_execution_time.
• En instalaciones multisitio de WordPress, cada sitio de la red tiene su propia configuración de Seller ID y su propio historial de importación.

Resolución de problemas

Documentos relacionados

• Logging and Monitoring
• Image Queue Maintenance
• Daily Operation
• Weekly Maintenance