Uso de WP-CLI con el Registro de Actividad
Se pregunta cómo exportar o limpiar su registro de actividad sin abrir wp-admin? El plugin Activity Log incluye comandos WP-CLI para exportar datos del registro y purgar entradas antiguas directamente desde la línea de comandos.
Esta guía cubre el uso de WP-CLI con el plugin Activity Log, incluyendo cada indicador de exportación y purga disponible.
Requisitos
WP-CLI debe estar instalado en su servidor, con acceso para ejecutarlo desde la línea de comandos. El plugin Activity Log debe estar instalado y activado. Ejecute todos los comandos desde la raíz de su 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. Combine cualquiera de los indicadores a continuación para filtrar los resultados.
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 tabla (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 gravedad. Valores aceptados:info,low,medium,high,critical. - –user_id=
Filtrar eventos por un ID de usuario específico de WordPress. - –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=
Filtrar entradas por fecha. Utilice el formatoYYYY-MM-DDoYYYY-MM-DD HH:MM:SS - –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. El valor predeterminado es el sitio actual. - –fields=
Lista de campos separados por comas para mostrar. Este indicador solo se aplica al formatotable. Las exportaciones CSV y JSON siempre incluyen todos los campos.
Campos disponibles para –fields:
id, date_gmt, severity, event_type, event_label, category_l1, category_l2, category_l3, message, user_id, user_login, user_role, object_type, object_id, object_name, ip_address, user_agent, request_method, request_uri, source, site_id, metadata.
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 gravedad durante 7 días:
wp duplicator-activity-log export --severity=high --date_from=2026-01-01 --date_to=2026-01-07
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.
El comando purge elimina las entradas del registro de actividad directamente desde la línea de comandos.
wp duplicator-activity-log purge
- Ejecutar purge sin indicadores elimina todas las entradas del registro de actividad. WP-CLI solicita confirmación antes de eliminar, a menos que se pase –yes.
- older-than=<days>: Eliminar solo entradas más antiguas que el número de días dado, en lugar de eliminar todo.
- yes: Omitir la solicitud de confirmación.
Purgar Ejemplos
Elimina todas las entradas del registro, con una solicitud de confirmación:
wp duplicator-activity-log purge
Elimina las entradas de hace más de 90 días:
wp duplicator-activity-log purge --older-than=90
Elimina todas las entradas sin solicitud de confirmación:
wp duplicator-activity-log purge --yes
Utiliza estos comandos para activar la limpieza bajo demanda en lugar de esperar la próxima ejecución programada. Para la misma acción desde wp-admin, utiliza Registro de actividad > Configuración > Herramientas > Purgar todos los registros.
¡Eso es todo! Con estos comandos, puedes exportar y limpiar los datos del registro de actividad completamente desde la línea de comandos, sin abrir wp-admin.