ログ
POS には 2 つのログインターフェースがあります。アプリ内のログ画面（POS アプリケーション内）と WP Admin のログページ（WordPress 内）です。これらを組み合わせることで、デバッグと監査のための POS アクティビティの全体像を把握できます。
POS アプリケーションのログ
ログへのアクセス
左側のナビゲーションドロワー（ハートビートアイコン）からログ画面を開きます。
インターフェースの概要
検索とフィルター
- ログを検索 - メッセージの内容によって特定のログエントリを見つける
- ログレベルフィルター - ログレベル（情報、警告、エラー）でフィルタリング
- 表示設定 - 表示される列を設定
ログテーブル
各ログエントリは以下の情報を示します：
| 列 | 説明 |
|---|---|
| 時間 | イベントが発生した時間 |
| レベル | 重大度: info（グレー）、warn（オレンジ）、error（赤） |
| メッセージ | イベントの人間が読める説明 |
| コンテキスト | 追加の詳細を含む展開可能な JSON |
| コード | エラーコード（ドキュメントへのリンク） |
ログレベル
Info（グレー）
通常の操作と成功したイベント：
- 「製品の全 ID を取得しました」
- 「新しい顧客を同期しました」
- 「税金の全 ID を取得しました」
Warning（オレンジ）
注意が必要な非クリティカルな問題：
- 「セッションを更新できません」
- 「同期のための再試行」
Error（赤）
対処が必要な問題：
- 「申し訳ありませんが、リソースを一覧表示することはできません」（権限の問題）
- 「API リクエストが失敗しました」
- 「データベース同期エラー」
Audit（青）
監査ログレベルは、POS によって行われたデータベースの変更を記録し、各変更の前後の完全な状態をキャプチャします。これは、たとえば注文作成、在庫調整、顧客更新の際に、何がいつ変更されたかを正確に追跡するのに役立ちます。
監査エントリには次の情報が含まれます：
- エンティティタイプ - 変更されたリソース（例：注文、商品、顧客）
- アクション - 変更の種類（作成、更新、削除）
- 変更前の状態 - 変更前の以前の値
- 変更後の状態 - 変更後の新しい値
コンテキストデータ
任意のログエントリの展開矢印をクリックして、詳細な 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 > Settings > Access でユーザーロールを確認してください。
セッションの問題
[warn] Unable to refresh session {...} API02007
POS は認証セッションを更新できませんでした。ログアウトして再ログインする必要があるかもしれません。
WP Admin のログページ
POS プラグインは、WordPress 管理エリアにサーバー側のログページも提供します。このページには、サーバーに記録された POS 固有の警告とエラーが表示され、POS アプリケーション自体には表示されない可能性のある問題の診断に役立ちます。
WP Admin ログページへのアクセス
WP Admin > POS > Settings に移動し、Tools タブを選択して Logs をクリックします。
未読バッジ
Logs メニュー項目には、未読のログエントリを示すバッジが表示されます：
- 赤いバッジ - 未読のエラーレベルのエントリがあります
- アンバーのバッジ - 未読の警告レベルのエントリがあります（ただしエラーはなし）
Logs ページを訪れると未読カウントがリセットされます。カウントはユーザーごとに追跡されるため、各管理者は自分自身の未読ステータスを見ます。
エントリのフィルタリング
レベルフィルターを使用してログエントリを絞り込みます：
- All - すべてのログエントリを表示
- Errors - エラーレベルのエントリのみを表示
- Warnings - 警告レベルのエントリのみを表示
展開可能なエントリ
長いログメッセージはおよそ 100 文字で切り詰められます。エントリをクリックして展開すると、追加のコンテキストデータとともに完全なメッセージが表示されます。
ページネーション
ログエントリはサーバー側でページ分けされます。ページネーションコントロールを使用して、古いエントリをナビゲートします。
致命的エラーバナー
サーバーに fatal-errors-*.log ファイルがある場合、Logs ページの上部に警告バナーが表示されます。このバナーは WooCommerce > Status > Logs にリンクしており、そこで完全な致命的エラーログを表示できます。致命的エラーは通常、POS API が応答できなくなる PHP レベルのクラッシュです。
サポートのためのログの使用
サポートをリクエストする際は：
- 問題を再現する - 問題を引き起こすアクションを実行する
- ログを確認する - エラー（赤）や警告（オレンジ）を探す
- コンテキストを展開する - 完全な JSON 詳細を取得する
- エラーコードをメモする - これをサポートリクエストに含める
- 関連エントリをコピーする - コンテキスト付きでログメッセージを共有する
パフォーマンスモニタリング
ログには実行時間とサーバーロードメトリックが含まれています。以下に注意してください：
- 高い実行時間 - サーバーが過負荷または遅い可能性があります
- 高いサーバーロード値 - サーバーの最適化を検討してください
- 頻繁なタイムアウト - ネットワーク接続を確認する