レスポンスヘッダー
x-arkor-edge を読んで、Arkor がリクエストをどう配信したかを確認します。
プロジェクトからのレスポンスにはすべて、どう配信されたかを示す 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 がリクエストに当てはまる場合に先に実行されています。 |
data | middleware のないアプリで、ビルドが完成させた Pages Router のページへのクライアントサイドのナビゲーションで、そのページの props を、ビルドが書き出したものからエッジが送りました。アプリはレンダリングしていません。 |
static | /_next/static のファイルや public/ のファイルなど、ビルドに含まれるファイル。 |
image | /_next/image からの画像。 |
passthrough | アプリがレスポンス全体をレンダリングしました。理由は reason に示されます。 |
error | Arkor がリクエストを配信できませんでした。理由は reason に示されます。 |
access | アクセス保護がアプリの代わりに応答しました。チャレンジ、入る途中のリダイレクト、401 のいずれかです。 |
asset | ビルドのファイルに含まれない /_next/static のファイル。アプリから取得し、できる場合はエッジにキャッシュします。 |
insights、script、vitals | Web アナリティクスや 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 だった、といった場合です。 |
action | Server Action。 |
method | GET・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+ のように繰り返しが並ぶパターンを長いヘッダーやパスに対して試すと起こります。画像のリクエストは代わりに拒否されます(下の「エラー」を参照)。 |
middleware | middleware 自身がリクエストに応答しました。 |
middleware-failed | ページが送られる前に middleware が失敗したか時間切れになったため、アプリが代わりに実行しました。 |
regenerate | キャッシュされたページの期限が切れていたため、このリクエストのためにレンダリングしました。 |
invalidated | キャッシュされたページが持つタグを、アプリが猶予つきで失効させました(revalidateTag(tag, 'max')、または expire がまだ先のもの)。その後にレンダリングされた版がエッジに届くまでは、アプリがページに応答します。古い版を送り、その裏でレンダリングし直します。 |
subscription_inactive | チームに有効なプランがありません。プランが復旧するまで、ページはアプリがレンダリングします。 |
エラー
error;reason= | ステータス | 対処 |
|---|---|---|
not-deployed | 503 | プロジェクトにまだ公開中のデプロイがありません。最初のビルドが成功するまで待ってください。 |
unknown-preview | 404 | そのアドレスで配信されているプロジェクトはありません。プロジェクト名を確認してください。 |
unknown-hostname | 404 | そのドメインはどのプロジェクトにも追加されていません。カスタムドメインを参照してください。 |
app-unreachable | 502 | アプリが失敗したか、上限を超えました。プロジェクトのログを確認してください。 |
pattern-budget | 400 | 画像のリクエストで、アプリのパターン(画像のパターン、ミドルウェアのマッチャー、has や missing の条件)を試すと、エッジが許す時間を超える場合です。多くは長い url やヘッダーが原因です。アプリには代わりに受け取れる画像最適化がないため、リクエストを拒否します。値を短くするか、パターンを単純にしてください。 |