Checkout と Customer Account の UI Extension が、アプリ起因でどれくらい・どのストアで読み込みに失敗しているかを Dev Dashboard で確認可能に。近日中にマーチャント側にも健全性ステータスとアラートが表示される予定。
Extension が読み込めなくても、購入者の画面から「消える」だけ。開発者側では問題を見つけにくかった。
アプリのホームの Operations に失敗率と失敗の多いインストール先ランキング、Logs に失敗イベントが記録される。
対象 ： Checkout UI Extensions Customer Account UI Extensions
指定した期間内に Extension が何回読み込まれ、そのうち何割が失敗したか。
Top extension installations by failure rate。現行バージョンの Extension が最も失敗しているストアと Extension target のランキング。読み込み 10 回以上のインストールが対象。各行からそのストアのマウント失敗ログへ移動できる。
マウントに失敗するたびに新しいイベントが記録される。store／extension／target／result で絞り込める。
失敗率・ランキング・Logs に反映されるのはアプリ起因の失敗だけ。
これらは集計に含まれず、Logs にも出ない。
今後、マーチャントも 設定 ＞ アプリ で、自分のストアに入っている Extension について同じ健全性情報を見られるようになる。各 Extension の現行バージョンに、直近 7 日間の読み込みをもとにステータスが付く。
| ステータス | 失敗率の条件 | 継続期間 | マーチャントへの影響 |
|---|---|---|---|
| 評価なし | 週の読み込みが 10 回未満 | — | ステータス表示なし |
| Warning | 5% 超が失敗していると確信できる | 3 日間 | 設定 ＞ アプリ にステータス表示 |
| Critical | 50% 超が失敗していると確信できる | 2 日間 | ステータス表示 ＋ Shopify 管理画面でアラート |
Operations セクションで Extension mount failure rate を確認。
ランキングの行からそのストアのマウント失敗ログへ。
store／extension／target／result でフィルタして原因を追う。
Shopify・ネットワーク・ブラウザ起因は除外。数字が出たら「自分のコードの問題」として扱ってよい前提の指標。
ランキングもマーチャント向けステータスも、Extension の現在のバージョンが対象。修正版をリリースした後の評価は新バージョンの読み込みで行われると読める。
ランキングは読み込み 10 回以上のインストールのみ。マーチャント向けも週 10 回未満は評価なし。低トラフィックのストアでは数字が出にくい。
ランキングは「ストア × Extension target」、Logs も target で絞り込める。特定の配置場所だけで落ちるケースの特定に使える。
失敗率 50% 超が 2 日続くと Critical となり、マーチャント管理画面にアラートが出る。デプロイ後に Dev Dashboard を見る運用を組み込まないと、マーチャントからの問い合わせで初めて知ることになる。API・Webhook でこの指標を取得できるかは記事に記載なし。