Uso de WP-CLI con el Registro de Actividad
¿Te preguntas cómo exportar o limpiar tu registro de actividad sin abrir wp-admin? El plugin Activity Log incluye comandos WP-CLI para exportar datos del registro y purgar entradas 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. Combina 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 las entradas y cambiar el formato de salida.
Indicadores de exportación
Los siguientes indicadores están disponibles. Todos son opcionales y funcionan en cualquier combinación:
--format=
Formato de salida. Aceptatable(por defecto),csvojson.--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 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 mensajes de eventos, nombres de usuario y nombres de objetos. Equivalente al campo Buscar eventos en el administrador.--date_from=
Mostrar eventos desde esta fecha en adelante. Usa el formatoYYYY-MM-DDoYYYY-MM-DD HH:MM:SS. Las fechas y horas están en UTC.--date_to=
Mostrar eventos hasta esta fecha y hora. Usa el mismo formato que--date_from=. Una fecha por sí sola significa medianoche al inicio de ese día, por lo que los eventos de ese día se excluyen. Para incluir el día completo, añade la hora, por ejemplo--date_to="2026-01-07 23:59:59".--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 de campos separados por comas que se mostrarán. Esta opción 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
wp duplicator-activity-log export --format=csv > activity-log.csv
Exportar todos los eventos como un archivo CSV:
Exporta solo eventos de alta gravedad para un rango de 7 días:
wp duplicator-activity-log export --severity=high --date_from=2026-01-01 --date_to="2026-01-07 23:59:59"
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 23:59:59" --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 las entradas del registro de actividad directamente desde la línea de comandos.
wp duplicator-activity-log purge
Ejecutar purge sin opciones elimina todas las entradas del registro de actividad. WP-CLI solicita confirmación antes de eliminar, a menos que añadas --yes.
Las siguientes opciones están disponibles:
--older-than=<days>
Elimina solo las entradas más antiguas que el número de días indicado, en lugar de eliminar todo.--yes
Omite 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
Usa estos comandos para limpiar el registro de actividad bajo demanda. Para eliminar todas las entradas desde wp-admin, ve a Registro de actividad » Configuración » Herramientas y haz clic en Purgar todos los registros.
¡Eso es todo! Ahora sabes cómo exportar y limpiar datos del registro de actividad desde la línea de comandos, sin abrir wp-admin.
¿Quieres cambiar cuánto tiempo permanecen las entradas en el registro antes de que la limpieza diaria las elimine? Consulta nuestra guía sobre Configuración de los ajustes del registro de actividad.