Vercel、キャッシュ理由をログ表示へ

ランタイムログにキャッシュの理由が表示されるようになりました

リクエストがなぜフレッシュなキャッシュヒットにならなかったのか、その理由を説明する「キャッシュ理由（Cache Reason）」がランタイムログに表示されます。具体的には、時間ベースやタグベースの再検証などが該当します。キャッシュミスのデバッグやヒトレートの向上に役立ててください。

CDN がキャッシュ可能な応答であれば、キャッシュ理由は表示されます。ISR（Incremental Static Regeneration）やパーシャルプリレンダリング、また stale-while-revalidate などのディレクティブを含む Cache-Control ヘッダーを設定する関数も含まれます。一方、すべてのリクエストで動的に描画される応答にはキャッシュ理由が表示されません。

キャッシュステータスと考えられる理由の対応表は以下の通りです。

• MISS: コールド、リクエストの統合（Request collapsed）、エラー
• BYPASS: ドラフトモード、プリレンダリングバイパス、クローラー
• STALE: 時間ベースの再検証、タグベースの無効化、再検証エラー
• REVALIDATED: タグベースの削除

「Logs」タブを開いてリクエストを選択すると、キャッシュステータスとともにその理由が表示されます。各ステータスと理由には、キャッシュステータスと理由のリファレンスページへのリンクが設定されています。

CLI からの利用

キャッシュ理由は、vercel logs コマンドや Vercel メトリクス、Vercel プラグインの cdn-caching スキルでも確認可能です。

キャッシュステータスと理由の詳細については、以下のページをご覧ください。さらに詳しく知りたい場合は「Read more」から参照してください。