Referencia de Logs

Este documento es una referencia para la pantalla de Logs del plugin ADP Car Market Hub (Car Market Hub → Logs). Explica cómo supervisar los errores y advertencias recientes, ver el archivo de registro sin procesar del plugin y vaciarlo cuando sea necesario.

Cuándo utilizar este documento

Lea esto si necesita:

• Comprobar si el plugin ha registrado errores o advertencias recientes.
• Leer las últimas entradas del archivo de registro sin procesar.
• Ajustar cuántas líneas se muestran.
• Restablecer el archivo de registro (por ejemplo, para iniciar un seguimiento limpio antes de una reproducción para soporte).

Descripción general

El plugin escribe un único archivo de registro de tipo "append-only" (solo adición). La pantalla de Logs lo muestra en tres bloques:

1. Recent Errors (Errores recientes): las entradas de registro más recientes que contienen el nivel [ERROR].
2. Recent Warnings (Advertencias recientes): las entradas de registro más recientes que contienen el nivel [WARNING].
3. Log Viewer (Visor de registro): la parte final sin procesar del archivo de registro con un número configurable de líneas.

Los paneles de errores recientes y advertencias recientes muestran cada uno hasta 50 de las entradas más recientes, analizadas a partir de las últimas 2000 líneas de registro para garantizar el rendimiento.

Requisitos o prerrequisitos

• Un usuario con la capacidad de gestión del plugin.
• Una ruta de archivo de registro con permisos de escritura en el servidor. La ruta actual se muestra encima del Log Viewer.

Instrucciones paso a paso

Inspeccionar el registro

1. Abra Car Market Hub → Logs.
2. Utilice Recent Errors y Recent Warnings en la parte superior para detectar cualquier elemento que requiera atención.
3. Desplácese hasta el Log Viewer para ver la parte final sin procesar del archivo.

Ajustar cuántas líneas se muestran

1. En la barra de herramientas situada encima del Log Viewer, cambie el campo Lines (Líneas). El rango permitido es de 100 a 2000 en pasos de 50.
2. Haga clic en Reload (Recargar) para volver a leer el archivo con el nuevo recuento de líneas.

Vaciar el archivo de registro

1. Haga clic en Clear log file (Vaciar archivo de registro) en la barra de herramientas del Log Viewer.
2. Confirme el diálogo. El archivo de registro se truncará a cero bytes.
3. El plugin registra que el registro se vació manualmente para que las futuras entradas estén correlacionadas con un punto de restablecimiento conocido.

Vaciar el registro es irreversible. Utilice esto solo cuando desee intencionadamente iniciar un seguimiento limpio.

Referencia de configuración

La pantalla de Logs no tiene ajustes persistentes. El selector de líneas es únicamente un parámetro de consulta por solicitud.

Notas operativas

• La ruta del archivo de registro se muestra encima del Log Viewer. Trátela como una ubicación interna y evite compartirla externamente; consúltela únicamente cuando realice tareas de depuración en su propio servidor.
• Si el archivo de registro aún no existe, la pantalla muestra un aviso. El archivo se crea automáticamente en la siguiente entrada de registro.
• Los paneles de errores recientes y advertencias recientes detectan las entradas mediante las subcadenas [ERROR] y [WARNING] respectivamente. Los escritores de registro personalizados que utilicen un formato diferente no coincidirán.
• Las advertencias de rotación de registros, archivado y uso de disco se muestran en la pantalla de la Referencia de sistema y ayuda.
• El visor procesa texto escapado dentro de un bloque <pre>. Haga clic en el área para seleccionar todo el contenido para copiarlo.

Resolución de problemas

• "Could not clear log file (file not found or not writable)." El usuario del servidor web no tiene permisos de escritura en la ruta del archivo de registro, o el archivo no existe. Verifique los permisos del sistema de archivos en la ruta que se muestra en la barra de herramientas.
• El selector de líneas se restablece después de navegar a otra página. Comportamiento esperado. El recuento de líneas es un parámetro de consulta por solicitud y no se almacena como un ajuste.
• El registro aparece vacío después de un fallo reciente. Confirme que se está visualizando el archivo de registro correcto (ruta en la barra de herramientas) y que la operación que falla realmente se ejecuta a través del registrador del plugin. Algunos errores fatales de PHP se escriben en el WordPress debug.log en su lugar; consulte la Referencia de sistema y ayuda.
• "Recent Errors" está vacío a pesar de que algo falló. O bien el fallo se registró en un nivel diferente (por ejemplo, [INFO]), o bien ocurrió fuera de las últimas 2000 líneas analizadas por los paneles de supervisión. Lea el Log Viewer sin procesar.

Documentos relacionados

• Referencia de sistema y ayuda
• Referencia de herramientas
• Referencia de soporte
• Referencia de ajustes