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 Serverアプリケーションが起動されました。
  • clientConnected -- クライアントPCがサーバーへの接続を確立しました。
  • clientDisconnected -- クライアントPCがサーバーから切断されました。

フィルタリングと検索

カテゴリフィルター

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

アクションフィルター

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

日付範囲フィルター

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

ソートオプション

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

テキスト検索

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

権限

ログページへのアクセスは以下の権限で制御されます。

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

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

リアルタイム更新

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