メインコンテンツにスキップ
バージョン: 1.x

ストアヘルス

v1.10.0の新機能

ストアヘルスは WCPOS v1.10.0 で導入されました。従来の単独のログ画面を置き換え、同期、ローカルデータの網羅状況、サーバー負荷をリアルタイムで確認できるようにします。

ストアヘルスは、デバイスとWooCommerce店舗の間で起きていることを確認するPOSのダッシュボードです。ナビゲーションドロワー (ハートビートアイコン) から開きます。タブはパフォーマンス、データベース、ログの3つです。

パフォーマンス​

パフォーマンスタブは、「POSはサーバーにどれだけの負荷をかけているのか、同期は正常か」に答えます。

  • ステータス行 — エンジンの現在の状態に基づいて、✓ Normalまたは⚠ Needs attentionと表示されます (すでに復旧した一時的な問題が、後になって警告されることはありません)。
  • 実測アクティビティ — 過去24時間のリクエスト数と典型的な応答時間は、このレジで計測した値であり、推定値ではありません。サイズを宣言していない応答は0として扱われるため、転送データ量は下限値です。
  • 稼働状況のストリップ — 過去24時間について、1時間ごとに1つのセルが表示されます。緑色はその時間内にリクエストがエラーなく完了したことを示します。オレンジ色は1件でも失敗があったことを示します (しきい値はありません)。空欄はアプリが動作していなかったことを示します。
  • 傾向グラフ — リクエスト量と応答時間の推移がグラフに表示されるため、単一の数値だけでなく、負荷が安定しているか、増加しているか、急上昇しているかを確認できます。
  • 次回チェックまでのカウントダウン — 次の変更チェックの予定時刻です。アイドル状態のレジでは、設定した間隔より長く表示されることが正常にありえます。チェックにはジッターがかかり、10分間操作がないと間隔が延びるためです。動きのないレジでカウントダウンが長くなるのは正常であり、同期が停止しているわけではありません。

同期プリセット​

3つのプリセットカードで、このデバイスの同期頻度を設定します。設定するのは、POSが変更を確認する間隔と、一度にリクエストするレコード数の2つです:

プリセットチェック間隔リクエストあたりのレコード数
エコ5分25
バランス（既定）60秒50
リアルタイム10秒75

共有ホスティングや低価格のホスティングではエコを、複数のレジがお互いの変更をすばやく反映する必要があり、サーバーに余力がある場合はリアルタイムを選択してください。カスタムのスライダーでは、全範囲（5秒〜5分、10〜100件）を設定できます。

知っておきたい点が2つあります:

  • 設定はデバイスごとです。 1台のレジを調整しても他のデバイスには影響しません。調整したい各レジで変更を繰り返してください。
  • ダイヤルの横に表示される1日あたり約N件のリクエストは、設定された間隔から算出した想定チェック頻度であり、上限や予測値ではありません。ジッターによって実際の件数は増減します。変更がない場合の304は低コストですが、リクエストとして数えられます。アイドル時の減衰は60秒の下限より短いプリセットでのみ件数を減らすため、「バランス」がさらに遅くなることはありません。

変更は再起動なしで即座に適用されます。これらの数値の裏側にある技術的な背景については、同期のパフォーマンスをご覧ください。

データベース​

データベースタブは、「このデバイスには何があるのか、すべてサーバーに届いたのか」に答えます。

画面上部には4つのタイルがあります: 販売準備完了のマイルストーン、このデバイス上のレコード数、使用中のストレージ容量、送信待ちの変更数です。レコード数には親商品だけでなくバリエーションの合計も含まれ、使用中のストレージ容量は推定値ではなくデバイスの実使用量です。WCPOSはこのデバイスの時計とサーバーの時計も比較し、同期やタイムスタンプに影響するほどずれている場合は、ここに時計のずれを表示します。

販売準備完了はマイルストーンであり、完全ダウンロードの条件ではありません

最初の商品がデバイスに届いた時点で切り替わります。オフラインでも妨げにはなりません。商品がデバイスにあるレジは、オフラインで販売できる状態です。それこそがローカルファーストのPOSの目的です。

カバレッジ表​

同期対象のコレクションごとに行が表示されます。デバイス上、サーバー上の件数と、カバレッジバーを確認できます。数値には厳格な正確性のルールがあります。サーバー上の合計は、推測値ではなく、サーバーが実際に報告した数値です:

  • 確認中… — POSがまだ最新のサーバー合計数を取得できていません。ある行がこの状態のまま約15分以上続く場合、そのコレクションのRESTルートが失敗している可能性があります。ログを確認してください。
  • バーが途中までなのは、多くの場合正常です。 顧客はアイドル時間に少しずつダウンロードされ、カテゴリーとクーポンは初めて開いたときにダウンロードされます。また、注文のバーは注文履歴全体に対して測定される一方で、レジは意図的に未処理の注文と最近の注文のみを保持します。そのため、まったく正常なレジでも注文は部分的と表示されます。
  • 「消去して再ダウンロード」の後に件数がゼロまたは少なくなるのは、同期が停止しているのではなく、想定どおりの状態です。 必要に応じてダウンロードされるコレクションは、使用するにつれて再びデータが入ります。各行には、そのコレクションがどのように補充されるかが表示されます。

サーバーに届かなかった変更​

サーバーが変更を恒久的に拒否した場合 (たとえば、サイトがリクエストを無効として拒否した際に作成された販売など)、POSはその変更を黙って延々と再試行することも、隠すこともしません。変更は保留状態となり、ここにサーバーからの理由、発生時刻、次の2つの操作とともに表示されます:

  • 再送信 — 現在のレコードの内容からリクエストを組み立て直し、あらためてキューに入れます。同じフィールドが再び拒否された場合は、成功したふりをするのではなく、試行回数が目に見えて増えていきます。
  • 破棄 — その変更を破棄します。確認ダイアログには、そのレコードにとって破棄が何を意味するかが正確に表示されます（レコードがこのデバイス上にしか存在しない場合、破棄によって削除されることも含みます）。

復旧は常に、意図的で目に見える操作です。ここに自動的に行われるものはありません。

消去して再ダウンロード​

各コレクションの行には消去して再ダウンロードがあり、そのコレクションのローカルコピーを削除して取得し直します。確認画面には、削除されるレコード件数とおおよそのストレージ容量、そしてサーバーに安全に残るものが表示されます。ローカルデータをすべて消去するよりも、こちらをご利用ください。対象が絞られており、サインアウトもされません。すべてのローカルデータを消去は、引き続き完全なリセットの手段です。

各行には今すぐ変更を確認もあり、次回の定期チェックを待たずに、そのコレクションだけの変更チェックを即時実行します。サーバー上の変更がこのデバイスに反映されたか確認したいときに便利です。

ログ​

ログタブには、このデバイス上の同期アクティビティが記録されます。各行に時刻、レベル、イベント、所要時間、ステータスが表示され、30日間保持されます。

  • プリセットフィルター — すべて／アクション／エラー／同期に加えて、詳細診断の切り替えがあります。これは24時間だけ追加の詳細を記録し、その後自動的にオフになります。
  • 行の詳細 — エラーと警告を展開すると、平易な言葉で書かれた原因、データの安全性に関する一文、推奨される次のステップ、そしてエラーコードのヘルプリンクが表示されます。各詳細表示にはコピー可能なイベントコードが含まれています。サポートにお問い合わせの際は、そのコードをお知らせください。
  • 無限スクロール — スクロールすると記録が追加で読み込まれるため、「次のページ」ボタンを使わずに30日間の履歴をさかのぼれます。
  • ログエントリーは表示時に翻訳されるため、数か月前に書き込まれた行も、そのレジで現在使用している言語で読めます。安定した識別子となるのはイベントコードです。
2つのタブ、2つの件数

ログタブは、滞留しているレコードの件数をログエントリーのみから算出します。一方でデータベースタブには、保留された拒否済みの変更も含まれます。両者が異なる場合、サーバーに届いていないものについてはデータベースが正です。