Uso de WP-CLI con el registro de actividad
El plugin Activity Log incluye comandos WP-CLI para exportar datos de registro y purgar entradas antiguas desde la línea de comandos. Esto resulta útil para automatizar las exportaciones de registros, integrarlos con scripts o gestionar registros en entornos sin interfaz gráfica o de prueba.
Requisitos
Necesitarás tener WP-CLI instalado en tu servidor y acceso para ejecutarlo desde la línea de comandos. El plugin Activity Log debe estar instalado y activado. Ejecuta todos los comandos desde la raíz de tu instalación de WordPress.
Comando Exportar
El comando export exporta las entradas del registro de actividad al terminal o a un archivo. Puede filtrar los resultados utilizando cualquier combinación de los indicadores disponibles.
wp duplicator-activity-log export
De forma predeterminada, esto muestra todas las entradas del registro como una tabla formateada. Añade indicadores para filtrar y cambiar el formato de salida.
Banderas de exportación
Todas las banderas son opcionales y se pueden combinar libremente.
--format=
Formato de salida. Acepta table (predeterminado), csvo 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=
Busca en los mensajes de eventos y nombres de objetos. Equivalente al campo Buscar eventos en el administrador.
--date_from=
Mostrar eventos a partir de esta fecha. Acepta cualquier formato de fecha de PHP. strtotime() entiende, por ejemplo 2026-01-01 o yesterday.
--date_to=
Mostrar eventos hasta esta fecha inclusive.
--site_id=
En WordPress Multisite, filtra los eventos de un sitio específico por su ID de blog. El valor predeterminado es el sitio actual.
--fields=
Lista de campos separados por comas que se incluirán en la salida. Útil para reducir 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 gravedad 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 del complemento para un intervalo 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 obtener 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 del registro que superen el periodo de retención configurado (establecido en Registro de actividad › Configuración › General). Se trata de la misma acción que ejecuta automáticamente la tarea cron diaria.
wp duplicator-activity-log purge
Esto resulta útil si ha cambiado el período de retención y desea limpiar inmediatamente las entradas antiguas sin esperar a la próxima ejecución programada, o si necesita activarlo manualmente en un script de implementación.
Para purgar todas las entradas del registro independientemente de su antigüedad, utilice el botón Purgar todos los registros en Registro de actividad › Configuración › Herramientas.