本文へ移動

レスポンスヘッダー

x-arkor-edge を読んで、Arkor がリクエストをどう配信したかを確認します。

Markdown で表示

プロジェクトからのレスポンスにはすべて、どう配信されたかを示す x-arkor-edge ヘッダーが付きます。ページが思ったより遅いときや、変更が反映されないときに、まず確認してください。

レスポンスを確認する

ブラウザーの開発者ツールでネットワークを開き、ページのリクエストを選択して、レスポンスヘッダーの x-arkor-edge を探します。

ターミナルからは、ブラウザーがページを開くときに送るヘッダーを付けてリクエストします。

terminal
curl -s -o /dev/null -D - https://my-app.arkor.app/blog \
  -H 'sec-fetch-dest: document' -H 'sec-fetch-mode: navigate' | grep -i x-arkor-edge

主なフィールドだけを抜き出すと、次のようになります。

output
x-arkor-edge: shell;enc=br;cont=resume;mw=miss;route=/blog;cache=fresh;seq=3

この 2 つのヘッダーがないと、リクエストはページのナビゲーションとみなされず、代わりにアプリがページをレンダリングします(passthrough;reason=sec-fetch-dest)。

値の意味

値は、リクエストがどう配信されたかを示す語で始まります。

先頭意味
shellページのプリレンダーされたシェルがエッジから送られました。
segmentリンクがプリフェッチした、プリレンダリングされたページの一部を、ビルドが書き出したものからエッジが送りました。アプリはレンダリングしていません。middleware は、その matcher がリクエストに当てはまる場合に先に実行されています。
payloadビルドが完成させたページへのクライアントサイドのナビゲーションで、そのページのペイロードを、ビルドが書き出したものからエッジが送りました。アプリはレンダリングしていません。middleware は、その matcher がリクエストに当てはまる場合に先に実行されています。
datamiddleware のないアプリで、ビルドが完成させた Pages Router のページへのクライアントサイドのナビゲーションで、そのページの props を、ビルドが書き出したものからエッジが送りました。アプリはレンダリングしていません。
static/_next/static のファイルや public/ のファイルなど、ビルドに含まれるファイル。
image/_next/image からの画像。
passthroughアプリがレスポンス全体をレンダリングしました。理由は reason に示されます。
errorArkor がリクエストを配信できませんでした。理由は reason に示されます。
accessアクセス保護がアプリの代わりに応答しました。チャレンジ、入る途中のリダイレクト、401 のいずれかです。
assetビルドのファイルに含まれない /_next/static のファイル。アプリから取得し、できる場合はエッジにキャッシュします。
insights、script、vitalsWeb アナリティクスや Speed Insights へのリクエストに、Arkor が応答しました。

shell の場合:

フィールド意味
cont=resumeシェルの後、ページの残りをアプリがストリーミングしました。
cont=noneページ全体がエッジから送られました。
cache=fresh、cache=staleページはキャッシュから送られ、fresh または stale でした。cache がない場合は、ビルドで作られたシェルです。
seq送られたページの世代。Cache Inspector で各世代を確認できます。
mw=hit、mw=missそのリクエストで middleware が実行されたかどうか。
routeリクエストが一致したルート。

アプリがページをレンダリングした理由

passthrough;reason=理由
sec-fetch-dest、sec-fetch-mode、acceptリクエストがページのナビゲーションではありませんでした(fetch、スクリプト、ターミナルなど)。
rscクライアントサイドのナビゲーション、またはアプリのルーターによるそのプリフェッチ。
segment-prefetchエッジがビルドから送らなかった、ページの一部のプリフェッチ。たとえば、リクエストがたどり着いたルートについてビルドがその部分を書き出していない、ページがビルドの後に再生成されたか stale になった、middleware がプリフェッチのヘッダーを変えた、といった場合です。
rsc-payloadビルドが完成させたページへのクライアントサイドのナビゲーションのうち、エッジがビルドから送らなかったもの。たとえば、ページがビルドの後に再生成されたか stale になった、middleware がリクエストをペイロードを持たないページへ書き換えた、といった場合です。
pages-dataビルドが props を書き出した Pages Router のページへのクライアントサイドのナビゲーションのうち、エッジがビルドから送らなかったもの。たとえば、ページがビルドの後に再生成されたか stale になった、リクエストが HEAD だった、といった場合です。
actionServer Action。
methodGET・HEAD 以外のメソッド。
head-resumedシェルの後をアプリが仕上げるページへの HEAD。ヘッダーはその部分が決めます。
head-expiredキャッシュされた版の有効期限が切れたページへの HEAD。アプリが応答し、次の GET でページが再生成されます。
headエッジがオリジンから取得するファイルへの HEAD。
botアプリの htmlLimitedBots に該当する訪問者(既定では HTML だけを読むクローラー)。Next.js が完全にレンダリングします。既定では Googlebot にはシェルが送られます。
html-limited-botsアプリの htmlLimitedBots がエッジで実行しない形のパターンのため、ユーザーエージェントを送る訪問者はすべて該当しうるものとして扱われ、Next.js が完全にレンダリングします。デプロイのログに警告が出ます。名前を並べただけのリストは実行されます。
bypass-cookie、bypass-queryドラフトモード、またはビルドから配信してはならないその他のリクエスト。
route-not-provedルートにプリレンダーされたシェルがありません。リクエストのたびにレンダリングされます。
pattern-budgetアプリのルーティングのパターン(ルート、ミドルウェアのマッチャー、has や missing の条件)をこのリクエストに対して試すと、エッジが許す時間を超えるため、アプリ自身がルーティングしました。\w+\w+ のように繰り返しが並ぶパターンを長いヘッダーやパスに対して試すと起こります。画像のリクエストは代わりに拒否されます(下の「エラー」を参照)。
middlewaremiddleware 自身がリクエストに応答しました。
middleware-failedページが送られる前に middleware が失敗したか時間切れになったため、アプリが代わりに実行しました。
regenerateキャッシュされたページの期限が切れていたため、このリクエストのためにレンダリングしました。
invalidatedキャッシュされたページが持つタグを、アプリが猶予つきで失効させました(revalidateTag(tag, 'max')、または expire がまだ先のもの)。その後にレンダリングされた版がエッジに届くまでは、アプリがページに応答します。古い版を送り、その裏でレンダリングし直します。
subscription_inactiveチームに有効なプランがありません。プランが復旧するまで、ページはアプリがレンダリングします。

エラー

error;reason=ステータス対処
not-deployed503プロジェクトにまだ公開中のデプロイがありません。最初のビルドが成功するまで待ってください。
unknown-preview404そのアドレスで配信されているプロジェクトはありません。プロジェクト名を確認してください。
unknown-hostname404そのドメインはどのプロジェクトにも追加されていません。カスタムドメインを参照してください。
app-unreachable502アプリが失敗したか、上限を超えました。プロジェクトのログを確認してください。
pattern-budget400画像のリクエストで、アプリのパターン(画像のパターン、ミドルウェアのマッチャー、has や missing の条件)を試すと、エッジが許す時間を超える場合です。多くは長い url やヘッダーが原因です。アプリには代わりに受け取れる画像最適化がないため、リクエストを拒否します。値を短くするか、パターンを単純にしてください。