O plugin Log de Atividades inclui comandos WP-CLI para exportar dados de log e limpar entradas antigas da linha de comando. Isso é útil para automatizar exportações de log, integrar com scripts ou gerenciar logs em ambientes headless ou de staging.

Requisitos

Você precisará do WP-CLI instalado em seu servidor e acesso para executá-lo a partir da linha de comando. O plugin Log de Atividades deve estar instalado e ativado. Execute todos os comandos a partir da raiz da sua instalação do WordPress.

Comando de Exportação

O comando export exibe as entradas do log de atividades no terminal ou em um arquivo. Você pode filtrar os resultados usando qualquer combinação das sinalizações disponíveis.

wp duplicator-activity-log export

Por padrão, isso exibe todas as entradas de log como uma tabela formatada. Adicione opções para filtrar e alterar o formato de saída.

Opções de Exportação

Todas as opções são opcionais e podem ser combinadas livremente.

--format=

Formato de saída. Aceita table (padrão), csv ou json.

--category_l1=

Filtrar por categoria de evento de nível superior. Valores aceitos: user, content, media, plugin, theme, wordpress, appearance, taxonomy, settings.

--severity=

Filtrar por nível de severidade. Valores aceitos: info, low, medium, high, critical.

--user_id=

Filtrar eventos por um ID de usuário específico do WordPress.

--event_type=

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

--search=

Pesquisar em mensagens de eventos e nomes de objetos. Equivalente ao campo Pesquisar Eventos no admin.

--date_from=

Mostrar eventos a partir desta data. Aceita qualquer formato de data que strtotime() do PHP entenda, por exemplo, 2026-01-01 ou yesterday.

--date_to=

Mostrar eventos até e incluindo esta data.

--site_id=

No WordPress Multisite, filtrar eventos para um site específico pelo seu ID de blog. O padrão é o site atual.

--fields=

Lista separada por vírgulas de campos a serem incluídos na saída. Útil para refinar exportações CSV. Campos disponíveis: id, date_gmt, user_login, user_role, severity, event_type, message, object_name, ip_address, is_cli.

Exemplos de Exportação

Exportar todos os eventos como um arquivo CSV:

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

Exportar apenas eventos de alta severidade dos últimos 7 dias:

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

Exportar todas as tentativas de login falhadas como JSON:

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

Exportar todos os eventos de plugin para um intervalo de datas específico para um arquivo:

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

Exporte apenas campos específicos para um CSV leve:

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

Comando de Limpeza

O comando purge exclui todas as entradas de log mais antigas que seu período de retenção configurado (definido em Registro de Atividade › Configurações › Geral). Esta é a mesma ação que o trabalho cron diário executa automaticamente.

wp duplicator-activity-log purge

Isso é útil se você alterou seu período de retenção e deseja limpar imediatamente as entradas antigas sem esperar pela próxima execução agendada, ou se precisar acioná-lo manualmente em um script de implantação.

Para excluir todas as entradas de log, independentemente da idade, use o botão Excluir Todos os Logs em Registro de Atividade › Configurações › Ferramentas.