HandyCafe Docs
owner

ログ

ログページは、HandyCafe内のすべてのシステムイベントの詳細な監査履歴を提供します。セッションの開始からキャッシャーのログインまで、重要なアクションはすべてここに記録され、責任追跡、トラブルシューティング、コンプライアンスの目的に役立ちます。

パフォーマンス

ログビューアは仮想リストレンダリングを使用しており、数千のエントリを表示してもスムーズなパフォーマンスを維持します。これは、常に表示されている行のみがDOMにレンダリングされることを意味し、1,000以上のログレコードをインターフェースの劣化なしに処理できます。

ログエントリフィールド

各ログエントリには以下のフィールドが含まれます:

フィールド 説明
タイムスタンプ イベントが発生した日時
ソース イベントを生成したシステムコンポーネント
カテゴリ イベントの分類(以下のカテゴリを参照)
アクション 特定のアクションタイプ(以下の一般的なアクションを参照)
PC 関連するクライアントPCまたはコンソール(該当する場合)
IP イベントに関連付けられたIPアドレス
メンバー 関与したメンバー(該当する場合)
キャッシャー イベントを引き起こした、または担当していたキャッシャー
メッセージ 発生した内容の人間が読める説明

ログカテゴリ

イベントは8つのカテゴリに分類されます:

  1. サーバー -- サーバーの起動、シャットダウン、設定変更、システムレベルのイベント。
  2. クライアント -- クライアントの接続、切断、状態変更。
  3. キャッシャー -- キャッシャーのログイン、ログアウト、管理アクション。
  4. メンバー -- メンバー登録、プロフィール更新、アカウント変更。
  5. セッション -- セッションライフサイクルイベント(開始、停止、一時停止、再開)。
  6. コンソール -- コンソール関連のイベント(追加、削除、セッション割り当て)。
  7. 注文 -- 注文の作成、変更、終了イベント。
  8. 支払い -- 支払い処理、返金、金融取引イベント。

一般的なログアクション

ログには以下のアクションが頻繁に表示されます:

  • startSession -- クライアントまたはコンソールで新しいセッションが開始されました。
  • stopSession -- アクティブなセッションが終了しました。
  • pauseSession -- 実行中のセッションが一時停止されました。
  • resumeSession -- 一時停止されたセッションが再開されました。
  • consoleAdded -- 新しいゲームコンソールがシステムに登録されました。
  • newMemberAdded -- 新しいメンバーアカウントが作成されました。
  • orderCreated -- 新しい商品注文が行われました。
  • orderClosed -- 注文が完了し、終了しました。
  • cashierLogin -- キャッシャーがシステムにログインしました。
  • cashierLogout -- キャッシャーがログアウトしました。
  • serverStarted -- HandyCafeサーバーアプリケーションが開始されました。
  • clientConnected -- クライアントPCがサーバーに接続しました。
  • clientDisconnected -- クライアントPCがサーバーから切断されました。

フィルタリングと検索

カテゴリフィルター

1つ以上のカテゴリを選択してログ表示を絞り込みます。例えば、セッションと支払いイベントのみを表示して、財務活動を監査します。

アクションフィルター

特定のアクションタイプでフィルタリングして、特定のイベントを迅速に見つけます。

日付範囲フィルター

特定の期間にログビューを制限します。他のフィルターと組み合わせることで、既知の時間枠内で発生したインシデントを調査するのが簡単になります。

ソートオプション

任意のフィールドでログエントリを昇順または降順にソートします。タイムスタンプでのソート(最新が最初)がデフォルトです。

テキスト検索

フリーテキスト検索ボックスはすべてのフィールドに対して一致し、特定のホスト名、IPアドレス、メンバー名、またはログメッセージ内の任意のキーワードを検索できます。

権限

ログページへのアクセスは以下の権限によって制御されます:

権限 説明
LOG_VIEW ログページへのアクセスに必要
LOG_DISPLAY_FULL 完全なログ履歴の表示を許可
LOG_DISPLAY_TODAY 今日のエントリのみの表示に制限
LOG_DELETE ログエントリの削除を許可

LOG_VIEWLOG_DISPLAY_TODAYを持つキャッシャーは、今日のイベントを確認できますが、過去のデータにはアクセスできません。LOG_DISPLAY_FULLを持つユーザーのみが、全ログアーカイブを閲覧できます。

リアルタイム更新

新しいログイベントは発生すると自動的にビューアに表示されます。システムはTCPイベント接続を介してログイベントをリッスンするため、ページを手動で更新する必要はありません。ログキャッシュは、最近のエントリをスクロールする際のデータベースクエリの繰り返しを減らし、パフォーマンスを向上させます。