Gestión de Logs ​

Los logs son registros detallados de todas las actividades del plugin. Te permiten monitorear el funcionamiento, detectar problemas y entender exactamente qué está pasando con tus sincronizaciones.

📋 ¿Qué son los Logs? ​

Definición Simple ​

Los logs son como un "diario" del plugin que registra:

• ✅ Cada sincronización exitosa
• ❌ Errores que puedan ocurrir
• 📊 Estadísticas detalladas
• ⏰ Fechas y horas exactas
• 🔍 Información técnica para diagnósticos

¿Por qué son Importantes? ​

• Monitoreo: Saber si todo funciona correctamente
• Diagnóstico: Identificar problemas rápidamente
• Historial: Ver el rendimiento a lo largo del tiempo
• Soporte: Proporcionar información técnica cuando necesites ayuda

🔍 Acceder a los Logs ​

Paso a Paso ​

1. Ve al panel de WordPress
2. Haz clic en Herramientas (menú lateral)
3. Selecciona NewBytes Logs
4. Verás la interfaz de logs

Acceso rápido: También puedes acceder desde Ajustes → Conector NB → pestaña "Herramientas" → botón "Ver logs"

Interfaz de Logs ​

La página de logs incluye:

• Lista de sincronizaciones ordenadas por fecha (más reciente primero)
• Información de cada log: fecha, hora, usuario que ejecutó la sincronización
• Tamaño del archivo en formato legible (KB, MB)
• Botones de acción para ver detalles, descargar o eliminar
• Búsqueda de productos dentro de cada log

📊 Entender la Información de los Logs ​

Vista General de un Log ​

🕐 2024-01-15 14:30:25
✅ Sincronización Automática Exitosa
📦 150 productos procesados
⏱️ Duración: 2m 34s

🕐 2024-01-15 14:30:25
✅ Sincronización Automática Exitosa
📦 150 productos procesados
⏱️ Duración: 2m 34s

Información Detallada ​

Al hacer clic en un log, verás:

Estadísticas de Sincronización ​

• Productos nuevos: Cuántos se crearon
• Productos actualizados: Cuántos se modificaron
• Productos eliminados: Cuántos se removieron
• Errores: Si hubo algún problema

Información Técnica (Metadata) ​

• Tipo de sincronización: Manual, automática o de descripciones
• Versión del plugin que generó el log
• Versión de WordPress
• Usuario que ejecutó la sincronización
• Configuración activa al momento de la sincronización

Detalles de Productos (API Data) ​

• Lista completa de productos procesados desde la API
• Información de cada producto: SKU, título, precio, stock, categoría
• Búsqueda integrada para encontrar productos específicos por nombre, SKU o categoría

🔍 Tipos de Logs ​

Por Tipo de Sincronización ​

Logs Automáticos 🤖 ​

• Cuándo: Cada intervalo configurado
• Color: Azul
• Información: Sincronización rutinaria

Logs Manuales 👤 ​

• Cuándo: Cuando tú inicias una sincronización
• Color: Verde
• Información: Sincronización iniciada por usuario

Logs de Descripción 📝 ​

• Cuándo: Al actualizar descripciones masivamente
• Color: Naranja
• Información: Solo actualización de descripciones

Por Estado ​

Exitosos ✅ ​

• Significado: La sincronización se completó sin problemas
• Acción: No requiere atención

Con Advertencias ⚠️ ​

• Significado: Se completó pero con algunos problemas menores
• Acción: Revisar detalles, puede requerir atención

Con Errores ❌ ​

• Significado: La sincronización falló o tuvo problemas graves
• Acción: Requiere atención inmediata

🛠️ Usar los Filtros de Logs ​

Filtrar por Fecha ​

1. Selecciona fecha de inicio
2. Selecciona fecha de fin
3. Haz clic en "Filtrar"

Filtrar por Tipo ​

• Todos: Muestra todos los logs
• Automáticos: Solo sincronizaciones automáticas
• Manuales: Solo sincronizaciones manuales
• Errores: Solo logs con errores

Filtrar por Estado ​

• Exitosos: Solo sincronizaciones exitosas
• Con advertencias: Solo logs con advertencias
• Con errores: Solo logs con errores

📥 Descargar Logs ​

¿Cuándo Descargar? ​

• Para soporte técnico: Cuando contactes a NewBytes
• Para análisis: Revisar patrones o tendencias
• Para backup: Mantener registros históricos

Cómo Descargar ​

1. Selecciona los logs que quieres descargar
2. Haz clic en "Descargar Logs Seleccionados"
3. Se descarga un archivo JSON con toda la información

Formato del Archivo ​

El archivo descargado contiene:

• Información completa de cada sincronización
• Formato JSON fácil de leer por programas
• Todos los detalles técnicos para análisis avanzado

🧹 Gestión Automática de Logs ​

Limpieza Automática ​

El plugin incluye un sistema de limpieza automática que mantiene solo los 15 logs más recientes. Esto significa que:

• No necesitas limpiar manualmente en la mayoría de casos
• El espacio se gestiona automáticamente
• Siempre tendrás los logs más relevantes disponibles

Limpieza Manual (Opcional) ​

Si necesitas limpiar logs manualmente:

Limpiar por Antigüedad ​

• Más de 30 días: Recomendado para uso normal
• Más de 7 días: Para sitios con mucha actividad

Proceso de Limpieza ​

1. Ve a Herramientas → NewBytes Logs
2. Haz clic en "Limpiar logs antiguos"
3. Selecciona el período a limpiar
4. Confirma la acción

🔍 Interpretar Logs Comunes ​

Log de Sincronización Exitosa ​

{
  "tipo": "automatica",
  "estado": "exitoso",
  "productos_procesados": 150,
  "productos_nuevos": 5,
  "productos_actualizados": 140,
  "productos_eliminados": 2,
  "duracion": "2m 34s",
  "memoria_usada": "45MB"
}

{
  "tipo": "automatica",
  "estado": "exitoso",
  "productos_procesados": 150,
  "productos_nuevos": 5,
  "productos_actualizados": 140,
  "productos_eliminados": 2,
  "duracion": "2m 34s",
  "memoria_usada": "45MB"
}

Log con Advertencias ​

{
  "tipo": "manual",
  "estado": "advertencia",
  "productos_procesados": 148,
  "advertencias": [
    "2 productos sin imagen disponible",
    "1 producto con precio cero"
  ],
  "duracion": "3m 12s"
}

{
  "tipo": "manual",
  "estado": "advertencia",
  "productos_procesados": 148,
  "advertencias": [
    "2 productos sin imagen disponible",
    "1 producto con precio cero"
  ],
  "duracion": "3m 12s"
}

Log con Errores ​

{
  "tipo": "automatica",
  "estado": "error",
  "error_principal": "Conexión timeout con API NewBytes",
  "productos_procesados": 0,
  "reintentos": 3,
  "duracion": "30s"
}

{
  "tipo": "automatica",
  "estado": "error",
  "error_principal": "Conexión timeout con API NewBytes",
  "productos_procesados": 0,
  "reintentos": 3,
  "duracion": "30s"
}

🚨 Logs que Requieren Atención ​

Errores de Conexión ​

Síntomas:

• "Timeout de conexión"
• "Error de red"
• "API no disponible"

Acciones:

1. Verificar conexión a internet
2. Contactar a NewBytes sobre estado de API
3. Revisar configuración de firewall

Errores de Autenticación ​

Síntomas:

• "Credenciales inválidas"
• "Token expirado"
• "Acceso denegado"

Acciones:

1. Verificar usuario y contraseña
2. Reconfigurar credenciales
3. Contactar a NewBytes si persiste

Errores de Memoria ​

Síntomas:

• "Memoria agotada"
• "Límite de tiempo excedido"
• "Proceso interrumpido"

Acciones:

1. Contactar al hosting sobre límites
2. Aumentar intervalo de sincronización
3. Considerar hosting más potente

📈 Monitoreo Proactivo ​

Revisión Regular ​

Frecuencia recomendada:

• Diaria: Para tiendas críticas
• Semanal: Para uso normal
• Mensual: Para tiendas estables

Qué Buscar ​

• Tendencias de errores: ¿Aumentan los problemas?
• Rendimiento: ¿Las sincronizaciones son más lentas?
• Patrones: ¿Errores en horarios específicos?

Alertas Automáticas ​

El plugin puede configurarse para:

• Enviar emails cuando hay errores
• Notificar sobre sincronizaciones fallidas
• Alertar sobre problemas de rendimiento

Próximos Pasos ​

Con el conocimiento sobre logs, ahora puedes diagnosticar y resolver la mayoría de problemas que puedan surgir.

👉 Continúa con: Solución de Problemas →