Quer exportar ou limpar seu log de atividades sem abrir o wp-admin? O plugin Activity Log inclui comandos WP-CLI para exportar dados de log e purgar entradas 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: Para usar o plugin Activity Log, você precisará de uma licença do Activity Log ou de uma licença Duplicator Pro Elite.

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 flags para filtrar as entradas e alterar o formato de saída.

Observação: Quando o Método de Registro está definido como Assíncrono (em fila) em Activity Log » Configurações » Geral, novos eventos são salvos em lotes a cada 5 minutos. Uma exportação executada logo após uma ação pode ainda não incluir essa ação.

Opções de Exportação

As seguintes flags estão disponíveis. Todas são opcionais e funcionam em qualquer combinação:

• --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, nomes de usuário e nomes de objetos. Equivalente ao campo Pesquisar Eventos no admin.
• --date_from=
  Mostrar eventos a partir desta data. Use o formato YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS. Datas e horas estão em UTC.
• --date_to=
  Mostrar eventos até esta data e hora. Usa o mesmo formato que --date_from=. Uma data sozinha significa meia-noite no início desse dia, então eventos desse dia são omitidos. Para incluir o dia inteiro, adicione a hora, por exemplo --date_to="2026-01-07 23:59:59".
• --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

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

Exportar todos os eventos como um arquivo CSV:

Exporte apenas eventos de alta severidade para um intervalo de 7 dias:

wp duplicator-activity-log export --severity=high --date_from=2026-01-01 --date_to="2026-01-07 23:59:59"

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 23:59:59" --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 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 pede confirmação antes de excluir, a menos que você adicione --yes.

As seguintes flags estão disponíveis:

• --older-than=<days>
  Exclua apenas entradas mais antigas que o número de dias fornecido, em vez de excluir tudo.
• --yes
  Pule a solicitação de confirmação.

Observação: Executar wp duplicator-activity-log purge sem flags exclui todo o log de atividades, não apenas as entradas após o seu período de Retenção de Logs. Adicione --older-than=<days> para excluir apenas entradas mais antigas. A limpeza automática baseada em 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. O valor de --older-than= deve ser um número inteiro acima de 0. Com 0 ou um valor que não seja um número, o comando oferece excluir todas as entradas.

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 limpar o log de atividades sob demanda. Para excluir todas as entradas do wp-admin em vez disso, vá para Activity Log » Settings » Tools e clique em Purge All Logs.

É isso! Agora você sabe como exportar e limpar dados do log de atividades da linha de comando, sem abrir o wp-admin.

Quer alterar por quanto tempo as entradas permanecem no log antes que a limpeza diária as remova? Confira nosso guia sobre Configurando as Configurações do Log de Atividades.