런타임 로그에 캐시 이유 표시 기능 추가
요약
런타임 로그에 캐시 이유(Cache Reason)를 표시하는 기능이 추가되어, 요청이 신선한 캐시 히트가 아닌 구체적인 재검증 사유를 확인할 수 있게 되었습니다. 이 기능을 활용하여 누락된 요청을 디버깅하고 전반적인 캐시 히트율을 개선할 수 있습니다.
핵심 포인트
- 런타임 로그에 캐시 이유(Cache Reason) 표시 기능 추가
- 시간 기반 또는 태그 기반 재검증 사유 확인 가능
- MISS, BYPASS, STALE 등 상태별 구체적 원인 파악 용이
- 디버깅 및 히트율 개선에 활용하여 성능 최적화 가능
이제 런타임 로그에는 요청이 신선한 캐시 히트(fresh cache hit)가 아닌 이유, 예를 들어 시간 기반 또는 태그 기반 재검증을 설명하는 캐시 이유(Cache Reason)가 표시됩니다. 이 캐시 이유를 사용하여 누락된 요청(misses)을 디버깅하고 히트율을 개선하세요.
캐시 이유는 CDN이 캐싱할 수 있는 모든 응답, 여기에는 ISR, Partial Prerendering, 그리고 .과 같은 지시문 헤더를 설정하는 함수가 포함됩니다. 매 요청마다 동적으로 렌더링되는 응답은 캐시 이유를 갖지 않습니다.Cache-Control``stale-while-revalidate`
로그(Logs) 탭을 열고 요청을 선택하면 해당 캐시 상태와 함께 그 이유를 볼 수 있습니다. 각 상태 및 이유는 참고 자료의 항목과 연결됩니다.캐시 상태 및 이유
캐시 이유는 , , 그리고 Vercel 플러그인의 :vercel logs``vercel metricscdn-caching skill에서 사용할 수 있습니다.
`.에 대한 자세한 내용은 캐시 상태 및 이유를 참조하세요.
<table><tbody><tr><td><p>캐시 상태</p></td><td><p>가능한 이유</p></td></tr><tr><td><p>MISS</p></td><td><p>콜드(Cold), 요청 축소(Request collapsed), 오류(Error)</p></td></tr><tr><td><p>BYPASS</p></td><td><p>초안 모드(Draft Mode), 프리렌더 우회(Prerender Bypass), 크롤러(Crawler)</p></td></tr><tr><td><p>STALE</p></td><td><p>시간 기반 재검증(Time-based revalidation), 태그 기반 무효화(Tag-based invalidation), 재검증 오류(Revalidation error)</p></td></tr><tr><td><p>REVALIDATED</p></td><td><p>태그 기반 삭제(Tag-based deletion)</p></td></tr></tbody></table>CLI에서
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기