ログ
ログ画面はPOS内のシステムアクティビティを記録します。これは、問題をデバッグし、バックグラウンドで何が起こっているかを理解するための不可欠なツールです。
ログへのアクセス方法
左側のナビゲーションドロワー（ハートビートアイコン）からログ画面を開きます。
インターフェース概要
検索とフィルター
- ログを検索 - メッセージの内容によって特定のログエントリを見つける
- ログレベルフィルター - ログレベル（情報、警告、エラー）でフィルタリング
- 表示設定 - 表示される列を設定
ログテーブル
各ログエントリは以下の情報を示します：
| 列 | 説明 |
|---|---|
| 時間 | イベントが発生した時間 |
| レベル | 重大度: info（グレー）、warn（オレンジ）、error（赤） |
| メッセージ | イベントの人間可読な説明 |
| コンテキスト | 追加の詳細を含む展開可能なJSON |
| コード | エラーコード（ドキュメントへのリンク） |
ログレベル
Info（グレー）
通常の操作と成功したイベント：
- "製品の全IDを取得しました"
- "新しい顧客を同期しました"
- "税金の全IDを取得しました"
Warning（オレンジ）
注意が必要な非クリティカルな問題：
- "セッションを更新できません"
- "同期のための再試行"
Error（赤）
対処が必要な問題：
- "申し訳ありませんが、リソースを一覧表示することはできません"（権限の問題）
- "APIリクエストが失敗しました"
- "データベース同期エラー"
コンテキストデータ
任意のログエントリの展開矢印をクリックして詳細なJSONコンテキストを見る：
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
このデータには以下が含まれます：
- アイテム数 - 影響を受けたレコードの数
- 実行時間 - 操作にかかった時間
- サーバーロード - サーバーのパフォーマンスメトリック
- リクエスト/レスポンスの詳細 - APIの問題をデバッグするため
エラーコード
多くのログエントリにはエラーコード（例：API02004、DB01001）が含まれています。これらのコードは、エラーコードドキュメントに直接リンクしており、以下を提供します：
- エラーの詳細な説明
- 一般的な原因
- トラブルシューティング手順
一般的なログエントリ
同期操作
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
これらは通常の同期活動を示します。コンテキストは、いくつのアイテムが同期されたかを示しています。
権限エラー
[error] Sorry, you cannot list resources {...} API02004
これは通常、ユーザーがリソースにアクセスする権限を持っていないことを意味します。WP Admin > POS > 設定 > アクセスでユーザーロールを確認してください。
セッションの問題
[warn] Unable to refresh session {...} API02007
POSは認証セッションを更新できませんでした。これは、ログアウトして再ログインする必要があるかもしれません。
サポートのためのログの使用
サポートをリクエストする際は：
- 問題を再現する - 問題を引き起こすアクションを実行する
- ログを確認する - エラー（赤）や警告（オレンジ）を探す
- コンテキストを展開する - 完全なJSON詳細を取得する
- エラーコードをメモする - これをサポートリクエストに含める
- 関連エントリをコピーする - コンテキスト付きでログメッセージを共有する
パフォーマンスモニタリング
ログには実行時間とサーバーロードメトリックが含まれています。以下に注意してください：
- 高い実行時間 - サーバーが過負荷または遅いかもしれません
- 高いサーバーロード値 - サーバーの最適化を検討してください
- 頻繁なタイムアウト - ネットワーク接続を確認する