アクティビティログでのWP-CLIの使用
アクティビティログプラグインには、ログデータをエクスポートしたり、コマンドラインから古いエントリをパージしたりするためのWP-CLIコマンドが含まれています。これは、ログのエクスポートを自動化したり、スクリプトと統合したり、ヘッドレスまたはステージング環境でログを管理したりするのに役立ちます。
要件
サーバーにWP-CLIがインストールされており、コマンドラインから実行できる必要があります。アクティビティログプラグインがインストールされ、有効化されている必要があります。すべてのコマンドはWordPressのルートディレクトリから実行してください。
エクスポートコマンド
exportコマンドは、アクティビティログのエントリをターミナルまたはファイルに出力します。利用可能なフラグの任意の組み合わせを使用して結果をフィルタリングできます。
wp duplicator-activity-log export
デフォルトでは、すべてのログエントリがフォーマットされたテーブルとして出力されます。フラグを追加して、出力形式をフィルタリングおよび変更します。
エクスポートフラグ
すべてのフラグはオプションであり、自由に組み合わせることができます。
--format=
出力形式。table(デフォルト)、csv、またはjsonを受け入れます。
--category_l1=
トップレベルのイベントカテゴリでフィルタリングします。受け入れられる値:user、content、media、plugin、theme、wordpress、appearance、taxonomy、settings。
--severity=
重大度レベルでフィルタリングします。受け入れられる値:info、low、medium、high、critical。
--user_id=
特定のWordPressユーザーIDでイベントをフィルタリングします。
--event_type=
特定のイベントタイプコードでフィルタリングします。例:user_login_failed、plugin_activated、content_post_published。
--search=
イベントメッセージとオブジェクト名を検索します。管理画面の「イベントの検索」フィールドと同等です。
--date_from=
この日付以降のイベントを表示します。PHPのstrtotime()が理解できる任意の日付形式(例:2026-01-01またはyesterday)を受け入れます。
--date_to=
この日まで(この日を含む)のイベントを表示します。
--site_id=
WordPressマルチサイトでは、特定のサイトのブログIDでイベントをフィルタリングします。デフォルトは現在のサイトです。
--fields=
出力に含めるフィールドのカンマ区切りリスト。CSVエクスポートを絞り込むのに役立ちます。利用可能なフィールド:id、date_gmt、user_login、user_role、severity、event_type、message、object_name、ip_address、is_cli。
エクスポート例
すべてのイベントをCSVファイルとしてエクスポートします:
wp duplicator-activity-log export --format=csv > activity-log.csv
過去7日間のHigh重大度イベントのみをエクスポートします:
wp duplicator-activity-log export --severity=high --date_from="7 days ago"
すべてのログイン失敗イベントをJSONとしてエクスポートします:
wp duplicator-activity-log export --event_type=user_login_failed --format=json
特定の期間のすべてのプラグインイベントをファイルにエクスポートします:
wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv
軽量CSV用に特定のフィールドのみをエクスポートします:
wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv
パージコマンド
purgeコマンドは、設定された保持期間(アクティビティログ › 設定 › 一般で設定)よりも古いすべてのログエントリを削除します。これは、毎日のcronジョブが自動的に実行するのと同じアクションです。
wp duplicator-activity-log purge
保持期間を変更し、次回のスケジュール実行を待たずに古いエントリをすぐにクリーンアップしたい場合、またはデプロイスクリプトで手動でトリガーする必要がある場合に便利です。
すべてのログエントリを年齢に関係なく削除するには、代わりにアクティビティログ › 設定 › ツールのすべてのログを削除ボタンを使用してください。