アクセス ログを設定する
アクセス ログはサイトに対して作成されたすべてのリクエストを記録し、監査に便利な他、連携、アプリ、または機能の問題をトラブルシューティングする際に特に役立ちます。
アクセス ログを表示する
ログ ファイルは、<install-directory>/logs/conf_access_log<date>.log にあります。
ログ出力例:
[18/Dec/2020:12:57:26 +1100] testuser http-nio-8090-exec-6 0:0:0:0:0:0:0:1 GET /index.action HTTP/1.1 200 1020ms 7881 http://localhost:8090/login.action?os_destination=%2Findex.action&permissionViolation=true Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36
[18/Dec/2020:12:57:26 +1100] testuser http-nio-8090-exec-1 0:0:0:0:0:0:0:1 GET /images/icons/profilepics/default.svg HTTP/1.1 200 46ms 1206 http://localhost:8090/index.action Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36
[18/Dec/2020:13:02:20 +1100] testuser http-nio-8090-exec-5 0:0:0:0:0:0:0:1 GET /rest/quickreload/latest/2129924?since=1608256850024&_=1608256758069 HTTP/1.1 200 12ms 152 http://localhost:8090/pages/viewpage.action?pageId=2129924 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36アクセス ログのパターン
Confluence アクセス ログは、Apace Tomcat アクセス ログ バルブを使用します。各リクエストで記録される情報は、設定を変更できます。
既定のパターンは次のとおりです。
%t %{X-AUSERNAME}o %I %h %r %s %Dms %b %{Referer}i %{User-Agent}iこれは、日付と時刻、ユーザー名、リモート論理ユーザー名、リモート ホスト名 (または IP)、リクエストの最初の行、応答の HTTP ステータス コード、リクエストの処理にかかった時間 (ミリ秒単位)、送信されたバイト (ヘッダーを除く)、リファラ、ユーザー エージェントを記録します。
各属性の詳細については、Tomcat 9 のドキュメントの「アクセス ログ バルブの属性」を参照してください。
ログインの保持期間を変更する
アクセス ログは最長 30 日間保持するように設定されています。この制限は増減を選択できますが、ログファイルを保存するのに十分なディスク領域を確保する必要があります。
アクセス ログを保持する期間を変更するには、次の手順を実行します。
- Confluence を停止します。
<install-directory>/conf/server.xmlファイルを編集します。アクセス ログ バルブを探し、
maxDaysの値を変更します。<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" maxDays="30" pattern="%t %{X-AUSERNAME}o %I %h %r %s %Dms %b %{Referer}i %{User-Agent}i" prefix="conf_access_log" requestAttributesEnabled="true" rotatable="true" suffix=".log" />- Save the file, and restart Confluence.
Confluence をクラスターで実行している場合は、この手順を各ノードで実行する必要があります。クラスター全体を停止させる必要はなく、各ノードを順番に更新できます。
アクセスのログ記録を無効にする
アクセスのログ記録を無効にするには、次の手順を実行します。
- Confluence を停止します。
<install-directory>/conf/server.xmlファイルを編集します。ここに表示されるアクセス ログ バルブ全体を削除します。
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" maxDays="30" pattern="%t %{X-AUSERNAME}o %I %h %r %s %Dms %b %{Referer}i %{User-Agent}i" prefix="conf_access_log" requestAttributesEnabled="true" rotatable="true" suffix=".log" />Save the file, and restart Confluence.
Confluence をクラスターで実行している場合は、この手順を各ノードで実行する必要があります。クラスター全体を停止させる必要はなく、各ノードを順番に更新できます。
その他のアクセス ログ オプション
アクセス ログを軽量化させる代替ソリューションとして、アクセスのログ記録をアプリケーション ログで有効にする方法もあります。この方法については、「ユーザー アクセスのログ取得を有効化する方法」を参照してください。
このオプションは、ログ エントリを追加するとアプリケーション ログがいっぱいになり、ローテーションが速すぎるため、小規模なサイトに最適です。