검색
← 릴리스 노트

런타임 로그의 캐시 사유 표시

Vercel · 기능추가 · 2026.07.17

런타임 로그에서 요청이 신선한 캐시 히트가 아니었던 이유를 Cache Reason으로 볼 수 있게 됐습니다.

교안에 영향

기존에 캐시 상태만 안내한 문서는 Cache Reason 확인 방법을 함께 반영해야 합니다.

요약

- 런타임 로그에 Cache Reason이 추가되어 캐시 미스 원인을 확인할 수 있습니다. - ISR, Partial Prerendering, Cache-Control 헤더를 사용하는 응답에서도 Cache Reason이 표시됩니다. - 동적으로 매 요청 렌더링되는 응답에는 Cache Reason이 표시되지 않습니다. - Logs 탭과 CLI의 vercel logs, vercel metrics, Vercel plugin의 cdn-caching skill에서 확인할 수 있습니다.

바뀐 것

새 기능 4

  • 런타임 로그에 Cache Reason을 추가해 요청이 신선한 캐시 히트가 아니었던 이유를 보여줍니다.
  • ISR, Partial Prerendering, 그리고 stale-while-revalidate 같은 지시어가 있는 Cache-Control 헤더 응답에서도 Cache Reason을 제공합니다.
  • Logs 탭에서 요청의 cache status와 함께 reason을 확인할 수 있습니다.
  • vercel logs, vercel metrics, Vercel plugin의 cdn-caching skill에서 Cache Reason을 사용할 수 있습니다.

원문 제목 · Runtime logs now show cache reasons