El plugin Registro de Actividad incluye comandos de WP-CLI para exportar datos de registro y purgar entradas antiguas desde la línea de comandos. Esto es útil para automatizar exportaciones de registros, integrarse con scripts o gestionar registros en entornos headless o de staging.

Requisitos

Necesitarás WP-CLI instalado en tu servidor y acceso para ejecutarlo desde la línea de comandos. El plugin Registro de Actividad debe estar instalado y activado. Ejecuta todos los comandos desde la raíz de tu instalación de WordPress.

Comando de exportación

El comando export muestra las entradas del registro de actividad en la terminal o en un archivo. Puedes filtrar los resultados utilizando cualquier combinación de los indicadores disponibles.

wp duplicator-activity-log export

Por defecto, esto muestra todas las entradas del registro como una tabla formateada. Añade indicadores para filtrar y cambiar el formato de salida.

Indicadores de exportación

Todos los indicadores son opcionales y se pueden combinar libremente.

--format=

Formato de salida. Acepta table (predeterminado), csv o json.

--category_l1=

Filtrar por categoría de evento de nivel superior. Valores aceptados: user, content, media, plugin, theme, wordpress, appearance, taxonomy, settings.

--severity=

Filtrar por nivel de severidad. Valores aceptados: info, low, medium, high, critical.

--user_id=

Filtrar eventos por un ID de usuario de WordPress específico.

--event_type=

Filtrar por un código de tipo de evento específico. Por ejemplo: user_login_failed, plugin_activated, content_post_published.

--search=

Buscar en los mensajes de eventos y nombres de objetos. Equivalente al campo Buscar eventos en el administrador.

--date_from=

Mostrar eventos desde esta fecha en adelante. Acepta cualquier formato de fecha que PHP strtotime() entienda, p. ej. 2026-01-01 o yesterday.

--date_to=

Mostrar eventos hasta e incluyendo esta fecha.

--site_id=

En WordPress Multisite, filtrar eventos para un sitio específico por su ID de blog. Por defecto, es el sitio actual.

--fields=

Lista separada por comas de los campos a incluir en la salida. Útil para acotar las exportaciones CSV. Campos disponibles: id, date_gmt, user_login, user_role, severity, event_type, message, object_name, ip_address, is_cli.

Ejemplos de exportación

Exportar todos los eventos como un archivo CSV:

wp duplicator-activity-log export --format=csv > activity-log.csv

Exportar solo eventos de alta severidad de los últimos 7 días:

wp duplicator-activity-log export --severity=high --date_from="7 days ago"

Exportar todos los intentos de inicio de sesión fallidos como JSON:

wp duplicator-activity-log export --event_type=user_login_failed --format=json

Exportar todos los eventos de plugins para un rango de fechas específico a un archivo:

wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv

Exportar solo campos específicos para un CSV ligero:

wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv

Comando de purga

El comando purge elimina todas las entradas de registro anteriores a tu período de retención configurado (establecido en Registro de actividad › Configuración › General). Esta es la misma acción que ejecuta automáticamente el trabajo cron diario.

wp duplicator-activity-log purge

Esto es útil si has cambiado tu período de retención y deseas limpiar inmediatamente las entradas antiguas sin esperar a la próxima ejecución programada, o si necesitas activarlo manualmente en un script de implementación.

Para purgar todas las entradas de registro independientemente de su antigüedad, utiliza el botón Purger todas las entradas de registro en Registro de actividad › Configuración › Herramientas en su lugar.