アクセスログの記録

アクセスログについて

オンプレミス CAMServer へアクセスするクライアントのログを記録する事ができます。
アクセスログは管理画面から閲覧する方法と、テキストベースで記録する方法があります。

管理画面のアクセスログ

各ユーザのアクセスログを管理画面で閲覧できます。

テキストのアクセスログ

記録方法

1. CAMServer 停止
2. CAMServer/cam.ini ファイルに次のセクションを追加

   # HTTPアクセス毎にログを記録
   cam.enableServerAccessLog=true
   # 任意。上記ログにログイン認証時のEmailを追加(Emailは一部マスクされ記録されます)
   cam.enableServerAccessLogEmail=true
   

3. CAMServer 起動

ログ保存場所

上記設定が完了すると CAMServer/sys/logs/YYYYMM_application0.log ファイルにアクセスログが記録されます。

※ YYYYMM は CAMServer を起動した年と月

※ ログファイルは50MB単位でローテーションされ、YYYYMM_application0.log の0番目は現在出力中のログファイル。連番が若いものが当月の新しいログファイルとなる。

記録される内容

アクセスログには次のフォーマットでログが記録されます。

日時:[INFO]:CAMServlet :Request /CAMServer/APIエンドポイント クライアントIP マスクされたEmail ユーザIDの一部 セッションIDの一部 クライアント端末識別子(web|electron|android|ios)

2022/09/10 13:57:09:[INFO]:CAMServlet :Request /CAMServer/getpublickey 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:09:[INFO]:CAMServlet :Request /CAMServer/getack 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:09:[INFO]:CAMServlet :Request /CAMServer/serverInfo 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:09:[INFO]:CAMServlet :Request /CAMServer/signIn 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:10:[INFO]:CAMServlet :Request /CAMServer/getTalkList 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:10:[INFO]:CAMServlet :Request /CAMServer/getUserPref 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web
2022/09/10 13:57:10:[INFO]:CAMServlet :Request /CAMServer/getLatestEntities 192.168.1.XX tes*ou*an*be*te*t*co* 1gh7pgnovpss 856C9E2 web

ログ監視

CAMServer で発生した異常をログから検知するためには、CAMServer が出力するログファイル（CAMServer/sys/logs/YYYYMM_application0.log）をログ監視ツールで監視する必要があります。

ほとんどの場合は [SEVERE] を監視ツールで監視してください。

WARNING レベル

• 内容・・・認証エラー、APIアクセスエラー、クライアント側の予期せぬエラーの場合に出力
• 影響度・・・ほとんどの場合は無害

2024/05/23 16:29:15:[WARNING]:CAMServlet :app.base.AppLevelException: Bad request.

SEVERE レベル

• 内容・・・ディスク障害、ディスク不足、メモリ不足、製品のバグ等
• 影響度・・・影響があるため対処が必要。ただし無害ではあるが製品自体の考慮漏れでも発生するため、頻繁に発生するログは監視ツールで除外設定も必要です。

2024/05/23 09:29:57:[SEVERE]:ErrorHandler :An error has occurred. java.lang.NullPointerException