ログ
POS には 2 つのログインターフェースがあります。アプリ内のアクティビティログ(POS アプリケーション内)と WP Admin のログページ(WordPress 内)です。これらを組み合わせることで、デバッグと監査のための POS アクティビティの全体像を把握できます。
POS アプリケーションのログ
v1.10.0 以降、アプリ内のログは ストアヘルス → ログ(ナビゲーションドロワーのハートビートアイコン)にあります。これに置き換えられた単独のログ画面は削除されました。このセクションでは v1.10.0 のログについて説明します。この領域の全体像についてはストアヘルスを参照してください。
ログへのアクセス
左のナビゲーションドロワーから ストアヘルス(ハートビートアイコン)を開き、ログ タブを選択します。
インターフェースの概要
ログは、このデバイス上のアクティビティの記録で、30 日間保持されます。各行には次の情報が表示されます。
| 列 | 説明 |
|---|---|
| 時刻 | イベントが発生した時刻 |
| レベル | 重要度 — error、warning、action、sync、info |
| イベント | 人が読める形式の説明(表示時に翻訳されます) |
| 所要時間 | 操作にかかった時間 |
| ステータス | 結果 |
記録の上部には、同期のハートビートを示すステータス行(最後の変更チェックが実行された時刻と次回の予定時刻)と、当日のイベント数とエラー数、滞留しているレコード、送信待ちの変更を表示する統計ヘッダーがあります。これらのほとんどはタップしてフィルターとして使用できます。
フィルタリング
プリセットのチップで記録を絞り込めます。すべて、アクション(人が行った操作 — 販売、編集、設定変更)、エラー、同期 があります。別途 詳細診断 の切り替えがあり、24 時間にわたって追加の詳細を記録した後、自動的にオフになります。
行の詳細とエラーコード
エラーまたは警告の行をタップすると展開されます。詳細表示には次の情報が含まれます。
- 何が起きたか — 平易な言葉での説明
- データについて — データの安全性に関する明確な記述(たとえば、その変更がサーバー上で安全なのか、このデバイス上にのみ存在するのか)
- 対処方法 — 推奨される次のステップ
- ヘルプリンク — エラーにはコード(例:
SYNC121、AUTH311)が付いており、エラーコードのドキュメントにリンクしています - コピー可能なイベントコード — 行のタイトルは表示時に翻訳されるため、安定した識別子となるのはイベントコードです。サポートに問い合わせる際にはこのコードを添えてください。
WP Admin のログページ
POS プラグインは、WordPress 管理画面にサーバー側のログページも提供します。このページには、サーバー上で記録された POS 固有の警告とエラーが表示され、POS アプリケーション自体には表示されない問題の診断に役立ちます。
WP Admin のログページへのアクセス
WP Admin > POS > 設定 に移動し、ツール タブを選択して ログ をクリックします。
未読バッジ
ログのメニュー項目には、未読のログエントリを示すバッジが表示されます。
- 赤いバッジ - 未読の error レベルのエントリがあります
- オレンジのバッジ - 未読の warning レベルのエントリがあります(error はありません)
ログページを表示すると未読件数はリセットされます。件数はユーザーごとに管理されるため、各管理者は自分の未読状況を確認できます。
エントリのフィルタリング
レベルフィルターを使用してログエントリを絞り込めます。
- すべて - すべてのログエントリを表示します
- エラー - error レベルのエントリのみを表示します
- 警告 - warning レベルのエントリのみを表示します
展開可能なエントリ
長いログメッセージは約 100 文字で省略されます。エントリをクリックすると展開され、完全なメッセージと追加のコンテキストデータを確認できます。
ページネーション
ログエントリはサーバー側でページ分割されます。ページネーションコントロールを使用して、より古いエントリを参照してください。
致命的エラーのバナー
サーバーに fatal-errors-*.log ファイルがある場合、ログページの上部に警告バナーが表示されます。このバナーは WooCommerce > ステータス > ログ にリンクしており、そこで完全な致命的エラーログを表示できます。致命的エラーは通常、POS API が応答できなくなる PHP レベルのクラッシュです。
サポートのためのログの活用
サポートを依頼する際は:
- 問題を再現します - 問題が発生する操作を実行します
- ログを確認します - ストアヘルス → ログ でエラーや警告を探します
- 行を展開します - データの安全性に関する記述と、推奨される次のステップを読みます
- イベントコードをコピーします - サポートリクエストに含めてください。何が起きたかを示す安定した識別子です
- サポートからより詳しい情報を求められた場合は 詳細診断 をオンにします — 24 時間にわたって追加情報が記録されます
パフォーマンスの監視
集計されたパフォーマンスは ストアヘルス → パフォーマンス にあります。直近 24 時間のリクエスト数、転送データ量(レスポンスがサイズを申告しない場合は下限値になります)、代表的な応答時間に加えて、1 時間単位の稼働状況ストリップが表示されます。応答時間が高いように見える場合は、サーバーパフォーマンスを参照してください。