監査ログの機能

Confluence Data Center の監査ログには次の機能があります。

機能	Data Center で利用可能
適用領域	はい
カバレッジ エリアの選択	はい
データベースのログ保存期間の設定	はい
監査ログを 2 か所で保存	はい
サードパーティ製の監視ツールとの連携	はい
最新の 10 万件の結果のエクスポート	はい
カテゴリーおよび要約ごとのフィルタリング	はい
フィルタリングした結果のエクスポート	はい
スペース レベルの監査ログ	はい

監査ログの保存

Confluence は、データベースとログ ファイルに監査ログを書き込みます。データベースを使用すると、データを簡単に表示、検索、エクスポートできます。

ログ ファイルがあれば、監査ログを長期保存用のデータベースから定期的にエクスポートする手間が不要になります。なお、その主な目的は、サードパーティ製のログ記録プラットフォームと簡単に連携することです。

Confluence Data Center のクラスター化されたインスタンスでは、ノードごとに独自のログが生成され、<home-directory/log/audit> ディレクトリに格納されます。ログは JSON ファイル形式で保存されます。

監査ログの表示

Confluence でグローバル監査ログを表示するには、次の手順を実行します。

1. [管理] メニュー から [一般設定] に移動します
2. [監査ログ] を選択します。
3. イベントを選択して展開し、詳細を確認します。

イベントに応じてさまざまな詳細が表示されます。これらには、以下のものが含まれることがあります。

• IP アドレス – 操作を実行したユーザーの IP アドレス。システムが生成したイベントの場合は記録されません。
• ロード バランサー/プロキシ IP アドレス – リクエストを転送したロード バランサーまたはプロキシ サーバーの IP アドレス。
• ノード ID – 操作が実行されたクラスター ノードの一意の ID。
• 方法 - 操作の実行方法。ブラウザ (エンド ユーザー) またはシステム (システム プロセス) として記録されます。

スペースの監査ログの表示

システム管理者、Confluence 管理者、スペース管理者は、そのスペースの管理権限がある場合、特定のスペースの監査ログにもアクセスできます。

スペースの監査ログは、スペースの権限や設定に関連するイベント、スペース内のユーザー操作、およびスペースのセキュリティに関連する一部のイベント (たとえば、特定のスペースでの制限付きページへのアクセスや権限付与に関連するイベント) を記録します。

特定のスペースの監査ログを表示するには、[スペース ツール] > [監査ログ] の順に選択します。

監査ログの検索と絞り込み

キーワードでログを検索し、日付、作成者、およびスペースで検索結果を絞り込むことができます。カテゴリーと要約でフィルタリングすることもできます。

特定のイベントが見つからない場合

カバレッジ レベルを変更すると、記録される個別のイベントも変更されます。特定のイベントを見つけることができない場合、カバレッジ レベルが変更されていて、対象のイベントがその期間に記録されていなかった可能性があります。これが発生しているかどうかを確認するには、監査ログの設定イベントを確認します。

監査ログのエクスポート

最大 100,000 件の最新またはフィルター済みイベントを CSV ファイルとしてエクスポートできます。100,000 件以上のイベントがある場合、最新の 100,000 件のイベントのみがエクスポートに含まれます。

監査ログをエクスポートするには、次の手順を実行します。

1. [監査ログ] に移動し、[エクスポート] を選択します。
2. 最新の 10 万件またはフィルター済みの結果のエクスポートを選択します。
3. [エクスポート] を選択して確定します。

スペース管理者も、スペース レベルの監査ログからエクスポートできます。

ログ設定の編集

監査ログ設定では、ログに記録したイベントをデータベースに保存する期間と、ログを収集する範囲を決定できます。

データベースの保存期間の更新

データベースでの保存は、保存期間と記録件数の上限 (1000 万件) で制限されます。

データベースの保存期間を更新するには、次の手順を実行します。

1. Select
   その他のオプション
    > [設定] の順に選択します。
2. 期間を入力します。日、月、年単位で入力できます。
3. 保存 を選択します。

長期間の保存を選択すると、データベースのサイズやパフォーマンスに影響を及ぼすことがあります。ご利用の Confluence インスタンスに最適な保存期間の設定の詳細をご確認ください。

保存期間を短くすることを決定した場合、新しく設定された期間を超えるすべてのイベントが削除され、ページに表示されなくなります。保存期間を短くする前に、バックアップを作成しておくことをおすすめします。

以前のバージョンの Confluence から移行している場合、既定の保存期間は 20 年間です。新しい Confluence インストールの場合は 3 年間です。

ログに記録するイベントの選択

ログに記録されるイベントは、特定の適用領域に所属するカテゴリにまとめられています。

たとえば、インポートおよびエクスポート関連のイベントは、[インポート/エクスポート] カテゴリに記録されます。このカテゴリは、[ローカル設定および管理] カバレッジ エリアに属しています。すべてのカバレッジ エリアと、各エリアに記録されるイベントについては、「Confluence の監査ログ イベント」を参照してください。

対象範囲を調整するには、次の手順を実行します。

1. 移動
   その他のオプション
    > [設定] の順に選択します。
2. [カバレッジ レベル] ドロップダウンで、必要なイベントをログに記録するためのレベルを選択するか、[オフ] を選択して特定のエリアのイベントの収集を停止します。

カバレッジ レベルの定義

適用レベルは、ログに記録されるイベントの数と頻度を反映します。

監査ログ ファイルの保存期間を変更する

各ノードのローカル ホーム ディレクトリに保存される監査ログ ファイルの数を選択できます。デフォルトでは、100 件のファイルが保存されます。特に、ログ レベルを「高度」または「完全」に設定している場合は、ファイル用に十分なディスク容量がプロビジョニングされていることをご確認ください。 

ファイルの保持設定を変更するには、次の手順を実行します。

1. 移動
   その他のオプション
   > [設定] の順に選択します。
2. ノードごとに保存するファイルの最大数を入力し、[保存] を選択します。 

ノードでログ ファイルの保存件数が上限に達すると、最も古いものが削除されます。たとえばコンプライアンスなどの目的で、これらのログを保持する必要がある場合は、このディレクトリのファイルを手動で定期的にバックアップするか、サードパーティのログ記録プラットフォームに送信する必要があります。「Confluence での監査ログの連携」をご確認ください。

外部ソフトウェアとの統合

ログ ファイルを使用して、ELK、Splunk、Sumologic、Amazon CloudWatch などのサードパーティ製ツールと連携できます。連携の詳細については、「Confluence での監査ログの連携」をご覧ください。

監査ログと移行

データベースの移行

データベースに 1000 万件を超えるイベントが保存されていて、新しいデータベースに移行する場合、最新の 1000 万件のみが移行され、残りのデータは削除されます。

古いイベントにアクセスできるようにするには、移行の前にバックアップを作成して、バックアップのデータにアクセスします。

以前の Confluence バージョンからの移行

監査ログのサイズやデータベースによっては、監査ログ記録の移行に時間がかかることがあります。

監査と REST API

REST API を使用して監査ログにアクセスすることも可能です。