런타임 로그에 캐시 사유가 표시됨

Vercel 런타임 로그에는 이제 요청이 신선한 캐시 히트가 아닌 이유를 설명하는 **캐시 사유(Cache Reason)**가 표시된다. 시간 기반 또는 태그 기반 재검증 같은 캐시 미스 원인을 파악해 조회율을 개선할 수 있다.

이 기능은 ISR, Partial Prerendering, Cache-Control 헤더를 설정한 함수 등 CDN이 캐시할 수 있는 모든 응답에 나타난다. 매 요청마다 동적으로 렌더링되는 응답은 캐시 사유가 표시되지 않는다.

캐시 상태별 가능한 사유:

• MISS: Cold, Request collapsed, Error
• BYPASS: Draft Mode, Prerender Bypass, Crawler
• STALE: Time-based revalidation, Tag-based invalidation, Revalidation error
• REVALIDATED: Tag-based deletion

로그 탭에서 요청을 선택하면 캐시 상태와 함께 사유를 확인할 수 있다. CLI에서도 vercel logs, vercel metrics 명령어로 캐시 사유를 조회할 수 있으며, Vercel 플러그인의 cdn-caching 스킬로 트래픽 전체에서 각 사유별 발생 빈도를 파악할 수 있다.