Querendo saber como exportar ou limpar seu log de atividades sem abrir o wp-admin? O plugin Activity Log inclui comandos WP-CLI para exportar dados do log e limpar entradas antigas diretamente da linha de comando.

Este guia abrange o uso do WP-CLI com o plugin Activity Log, incluindo todas as flags de exportação e limpeza disponíveis.

Requisitos

O WP-CLI deve estar instalado em seu servidor, com acesso para executá-lo a partir da linha de comando. O plugin Activity Log 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. Combine qualquer uma das flags abaixo para filtrar os resultados.

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 flags 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=
  Filtrar entradas por data. Use o formato YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS
• –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 de campos separados por vírgula para exibir. Esta flag se aplica apenas ao formato table. Exportações CSV e JSON sempre incluem todos os campos.
  
  Campos disponíveis 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.

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 severidade Alta por 7 dias:

wp duplicator-activity-log export --severity=high --date_from=2026-01-01 --date_to=2026-01-07

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.

O comando purge exclui entradas do log de atividades diretamente da linha de comando.

wp duplicator-activity-log purge

• Executar purge sem flags exclui todas as entradas no log de atividades. O WP-CLI solicita confirmação antes de excluir, a menos que –yes seja passado.
• older-than=<days>: Excluir apenas entradas com mais de X dias, em vez de excluir tudo.
• yes: Pular a solicitação de confirmação.

Observação: Executar wp duplicator-activity-log purge sem sinalizadores exclui todo o log de atividades, não apenas as entradas após o período de retenção configurado. Adicione –older-than= para excluir apenas entradas mais antigas. A limpeza automática baseada na retenção é executada como uma tarefa agendada diária separada (definida em Activity Log › Settings › General) e não é a mesma ação que este comando.

Limpar Exemplos

Excluir todas as entradas de log, com um prompt de confirmação:

wp duplicator-activity-log purge

Excluir entradas com mais de 90 dias:

wp duplicator-activity-log purge --older-than=90

Excluir todas as entradas sem um prompt de confirmação:

wp duplicator-activity-log purge --yes

Use estes comandos para acionar a limpeza sob demanda em vez de esperar pela próxima execução agendada. Para a mesma ação do wp-admin, use Activity Log › Settings › Tools › Purge All Logs.

É isso! Com estes comandos, você pode exportar e limpar dados do log de atividades inteiramente da linha de comando, sem abrir o wp-admin.