Back to blog

How to read Prerender Buddy render logs and cache headers

A field-by-field guide to Prerender Buddy render logs and x-prerender cache, TTL, and timing headers.

Operations
Jul 8, 2026
4 min read

Render logs answer a narrower question than analytics: which crawler-style requests reached the rendering path, what URL was requested, and how did the render or cache respond?

Quick answer

If the server already sends complete HTML, you probably do not need Prerender Buddy. If visitors see a complete JavaScript page but bots receive thin HTML or an empty app shell, Prerender Buddy can help by serving rendered HTML to search engines and AI crawlers.

Log fields

FieldWhat it tells you
URLThe exact public page requested, including path and relevant query string
User agentWhich crawler or testing request reached the integration
Cache statusWhether HTML came from cache, a fresh render, stale fallback, or a quota state
DurationHow long the render path took for that request
HTTP statusWhether the page succeeded, redirected, was missing, or failed
TimestampWhen the request reached Prerender Buddy

Logs do not prove that an external service indexed, cited, or displayed the page. They prove that a request reached the response path.

Cache states

  • HIT: recent cached HTML was served.
  • MISS: a fresh render was requested and counted toward rendering usage.
  • STALE: older HTML was used as a fallback, usually because a fresh response was unavailable.
  • QUOTA_EXCEEDED: fresh rendering capacity was unavailable under the current quota.

An occasional miss is normal. Repeated misses for the same stable URL can indicate aggressive invalidation, query variation, or cache settings that do not match publishing frequency.

Managed-proxy headers

Crawler responses commonly include:

Example
1x-prerender-cache
2x-prerender-cache-ttl
3x-prerender-time

Use them together:

  • x-prerender-cache identifies the cache outcome.
  • x-prerender-cache-ttl describes remaining or applied cache freshness information.
  • x-prerender-time reports render-path timing.

If a crawler request has only the original host's headers and no Prerender Buddy headers, it may have bypassed the managed proxy. Developer middleware integrations can expose different headers, so use dashboard logs and verification as the source of truth.

Patterns worth investigating

  • repeated STALE responses for current content
  • repeated MISS responses caused by tracking parameters
  • QUOTA_EXCEEDED near the start of a billing period
  • crawler requests to assets, APIs, login, or checkout routes
  • status 200 for clearly missing pages
  • recurring 4xx or 5xx on important public URLs
  • a sudden absence of crawler logs after DNS or deployment changes
  • render duration increasing across the same page template

Manual correlation

Run a crawler request and then compare its timestamp with the newest log:

Terminal
1curl -I -A "Googlebot" https://www.example.com/pricing

Confirm the URL, user agent, cache state, status, and time all describe the request you just made.

Read Verify Installation, cache freshness, and HTTP status codes for the next diagnostic step.

Who this is for

  • SaaS founders with already-shipped JavaScript websites
  • React, Vite, Vue, Lovable, Bolt, or Base44 users
  • SEO freelancers checking crawler-readable HTML
  • Agencies maintaining client sites without rebuilding them

You may not need Prerender Buddy if

  • Server HTML is already complete.
  • Static pages crawl correctly.
  • You are already rebuilding with SSR or static generation.
  • You only need an audit, not a rendering fix.

Final recap

How to read Prerender Buddy render logs and cache headers comes down to what search engines and AI crawlers actually receive from your site.

Prerender Buddy does not guarantee rankings or AI citations. It helps with one specific technical problem: making sure crawlers receive readable rendered HTML instead of a thin JavaScript shell.

The first step is to check what bots see.

Check your website

Check what crawlers see to test whether the site sends readable HTML to search engines and AI crawlers.