システムログ閲覧
最終更新日: 2023年1月30日
管理処理メニューから「システムログ閲覧」を選びます。
表示される「メッセージ」は128文字までです。それ以上の文字がある場合は末尾に "...(see system.log file)" が付与されます。
指定した文字列を含むログを取得します。例えば "JFC-" と設定すると、ログコードが含まれるログを取得することができます。
先頭に "OR" を付与すると、そのあとの文字列を空白区切りのキーワードと扱い、OR 検索を行います。OR を付与せず複数のキーワードを空白区切りで列挙すると AND 検索を行います。8.5.7/9.0.3
ログには「タイプ」という概念があります。Wagby では次の 5 つのタイプが用意されています。
次の例は「タイプ」を "INFO" とし、かつキーワードに "ログオン" という文言があるログを絞り込んだ例です。
当日のログファイルは wagbyapp\logs フォルダに「system.log」として出力されます。
ログは日次でローテートされます。過去日のログファイルはファイル名に日付が含まれています。
Wagby は通常運用ではログファイルの削除を行いませんが、再ビルドやシステムの入れ替え作業を行うと、ログファイルは削除されます。具体的には次のような場合です。
ログファイルの長期保管を行うため、再ビルドやシステム入れ替え時には既存の logs フォルダを手動でバックアップしてください。
zip 圧縮したログファイルも閲覧することができます。ディスクスペースの節約につながります。
Wagby はログファイルの自動削除を行いません。ログファイルの削除は管理者の判断で、手動で行ってください。
ログファイルを削除する場合は、別のメディアに保存することを推奨します。
例を示します。
日付時刻は yyyy-MM-dd HH:MM:ss で表現されます。西暦年月日と時分秒です。
ログレベルは "INFO", "ERROR", "WARN", "FATAL", "DEBUG" が用意されています。
クラス名は、このログを出力した Java のクラスです。利用者の画面操作に関するログは "Javaソースコードパッケージ名.controller.SCREENID関数の値(ただし先頭は大文字)" となります。
メソッド名は、クラス内のメソッドです。
アカウントは「@」の後に操作端末のホスト名(ホスト名が不明の場合はIPアドレス)が付与されます。ただしシステムレベルのログの場合、この値は省略されます。
ブラウザは BROWSERTYPE 関数が返す値と同じです。
イベント名は利用者のすべての画面操作(具体的にはボタン押下ならびに画面再描画発生)についてログが記録されます。開発者が作成した独自ボタンも含みます。標準的なイベント名の一覧はこちらをご確認ください。実際のイベント名は EVENT 関数と同じです。
ログにより「いつ、誰が(どの端末から)、どの画面に対して、どういうアクションを行ったか」がわかります。
次のようなログが記録されます。
本機能は "システム管理者" または "システムログ閲覧" プリンシパルをもったアカウントで利用できます。[プリンシパルの詳細...]
ログの日時部分をクリックするとTomcatコンソールに出力されているエラーメッセージを直接、閲覧することができます。
ログの閲覧方法
「ログ日付」「タイプ」「キーワード」といった条件で絞込み表示を行うことができます。標準は「タイプ」が "ERROR" となっています。
キーワードの指定方法
ログ種別
タイプ
説明
INFO
正常処理時のメッセージです。
ERROR
エラー処理時のメッセージです。処理は中断されたことを示します。
WARN
警告を意味します。処理は続行されています。
FATAL
致命的なエラーを意味します。アプリケーションの再起動が必要です。
DEBUG
デバッグメッセージです。開発者向けに用意されています。
ログの保存
ワンポイント
注意点
圧縮されたログファイル
ログの削除
重要
ログフォーマット
R7.11以降
日付時刻 [ログレベル クラス名 メソッド名] (アカウント@ホスト名またはIPアドレス|ブラウザ) 画面名|イベント名
2019-03-24 08:59:00 [INFO jp.jasminesoft.jfc.controller.DbShowListBaseController perform_db] (admin@0:0:0:0:0:0:0:1|Chrome) showListCustomer|Search
Javaソースコードパッケージ名の説明はこちらをお読みください。
SCREENID 関数の説明はこちらをお読みください。なおクラス名の先頭は大文字になります。
詳細画面および更新、削除画面の操作は対象データが特定されます。この場合、イベント名の後ろにコロン ":" 区切りで対象データの主キー情報が記録されます。例を示します。
2019-03-24 09:00:00 [INFO jp.jasminesoft.jfc.controller.DbShowBaseController perform_db] (test01@0:0:0:0:0:0:0:1|Chrome) showCustomer|DoShow:1000
2019-03-24 09:00:01 [INFO jp.jasminesoft.jfc.controller.DbUpdateBaseController perform_db] (test01@0:0:0:0:0:0:0:1|Chrome) updateCustomer|BeginUpdate:1000
ワンポイント
利用者の操作以外のログ
プリンシパル 8.4.0
コンソールログ 9.2.0