Kernbegrippen
De woordenschat waar de rest van de documentatie van uitgaat: warmers, entry-URL's, diepte, intervallen, warmte en workspaces.
10 min leestijd
Cache Rocket gebruikt een beperkte set termen consistent door de app en deze documentatie heen. Als je die één keer leert, leest al het andere sneller.
Warm en koud
- Koud
- Er bestaat geen bruikbare gecachete kopie. Het volgende request moet door je origin-server opgebouwd worden, wat traag en duur is.
- Warm
- Er bestaat een verse gecachete kopie. Het volgende request komt uit de cache, doorgaans in enkele milliseconden, zonder je applicatie te raken.
- Opwarmen
- Een URL bewust opvragen zodat de gecachete kopie wordt aangemaakt of ververst vóórdat een echte bezoeker die nodig heeft.
- Cold-start-penalty
- De extra tijd die de eerste bezoeker na het verlopen wacht terwijl de pagina wordt opgebouwd. Dit wegnemen is het hele doel van Cache Rocket.
Warmers
Een warmer is een opgeslagen configuratie die beschrijft wát opgewarmd wordt en hoe. Het is het centrale object in Cache Rocket; bijna al het andere hangt eraan.
| Cache-warmer | API-warmer | |
|---|---|---|
| Ook wel | Website-warmer, crawler | API-cache-warmer |
| Warmt op | HTML-pagina's | REST- en GraphQL-endpoints |
| Vindt URL's via | Entry-URL's, sitemaps en het volgen van links | Een expliciete endpointlijst, eventueel uitgeklapt door een configuratiematrix |
| Gebruikelijke methode | GET | GET, POST en andere die je plan toestaat |
| Beheerd onder | Account → Warmers | Account → API-warmers |
| Beschreven in | Cache-warmers | API-warmers |
Een opmerking over het woord “crawler”
Oudere delen van de interface en sommige API-responses noemen warmers *crawlers*, en warm-runs *crawls*. Het betekent hetzelfde. “Warmer” is de huidige naam.
Actief, en wat een run start
Elke warmer heeft een schakelaar Actief. Inactieve warmers behouden hun configuratie maar draaien nooit — handig tijdens het instellen, of om te pauzeren bij onderhoud.
Een actieve warmer draait volgens zijn schema, en kan ook handmatig, door een deploy-webhook of door een CDN-purge gestart worden.
Entry-URL's
Een entry-URL is een startpunt voor een warm-run. Schrijf hem volledig, inclusief het schema:
https://www.example.com ← goed
https://www.example.com/sitemap.xml ← goed, een sitemap
www.example.com ← fout, geen schema
/products ← fout, niet absoluutEntry-URL's moeten een geverifieerde hostname gebruiken. De meeste sites hebben er maar één nodig, omdat linkontdekking en sitemaps de rest doen. Voeg er meer toe om dekking te garanderen van een sectie die slecht vanaf de homepage gelinkt is — een diepe categoriepagina, een landingspagina die alleen via advertenties bereikbaar is, of een tweede subdomein.
Diepte
Diepte beperkt hoeveel linkstappen vanaf een entry-URL de warmer aflegt. Een entry-URL is diepte 0; pagina's die daarnaartoe linken zijn diepte 1; pagina's die vanaf die pagina's gelinkt worden zijn diepte 2.
| Diepte | Bereikt | Goed voor |
|---|---|---|
0 | Alleen je entry-URL's | Een precieze lijst kritieke pagina's, zonder enige ontdekking |
1 | Entry-URL's plus alles waar ze naartoe linken | Homepage en hoofdnavigatie |
2 | Nog één stap — meestal categorie- en overzichtspagina's | Een verstandige standaard voor de meeste sites |
3+ | Losse artikelen en producten | Grote catalogi, als je origin ruimte heeft |
Careful
URL-aantallen groeien ruwweg meetkundig met de diepte. Verhoog met één niveau per keer en controleer het totale aantal URL's op je warmer voordat je verder gaat.
Gebruik je sitemaps, dan heb je vaak minder diepte nodig: de sitemap noemt je diepe pagina's direct, dus die kunnen opgewarmd worden zonder er stap voor stap naartoe te crawlen.
De twee intervallen
Deze worden vaak verward, en ze regelen verschillende dingen.
- Auto-startinterval
- Hoe vaak een nieuwe run begint, in seconden.
3600betekent dat de warmer elk uur een nieuwe ronde over je site start. Dit is de instelling waar je meestal over nadenkt. - Enqueue-interval
- Hoe vaak URL's binnen de opwarmcyclus opnieuw in de wachtrij gezet worden, in seconden. Het regelt het tempo van het werk, niet wanneer een ronde begint. De standaard is prima, tenzij je een specifieke reden hebt.
Kies het auto-startinterval door je af te vragen hoe lang je een pagina koud wilt laten staan. Cachet je CDN een uur, dan houdt elk uur opwarmen alles continu warm. Veel vaker opwarmen dan je cache-TTL voegt alleen belasting toe zonder voordeel.
Rate limits
Max URL's per minuut is de rem, en de belangrijkste veiligheidsinstelling op het formulier, want die bepaalt hoeveel belasting opwarmen aan je origin toevoegt.
| Jouw hosting | Verstandig startpunt |
|---|---|
| Shared hosting of een kleine VPS | 5–10 URL's per minuut |
| Een degelijke dedicated server of managed WordPress-host | 30–60 URL's per minuut |
| Een goed uitgeruste origin achter een CDN | 100+ URL's per minuut |
Begin laag. Verhoog alleen terwijl je de CPU en responstijden van je origin in de gaten houdt. Je plan handhaaft daarnaast eigen plafonds per minuut, dag, week en maand.
Hostnames en verificatie
Een hostname is een domein dat je bij Cache Rocket hebt geregistreerd en waarvan je hebt aangetoond dat je het beheert, zoals www.example.com. Zolang een hostname niet geverifieerd is, mag geen warmer die als doel hebben.
Verificatie is een bewuste maatregel tegen misbruik. Zonder dat zou iemand de dienst op de server van een vreemde kunnen richten en als aanvalsmiddel gebruiken. Details in Hostnameverificatie.
Het resultaat meten
- Eerste laadtijd
- Hoe lang het eerste van de twee requests duurde. Staat voor de ervaring van een bezoeker die op een koude pagina komt.
- Warme laadtijd
- Hoe lang het directe tweede request duurde. Staat voor de ervaring van iedereen die na het opwarmen komt.
- Verbetering
- Het verschil tussen die twee. Dit is het concrete voordeel dat opwarmen voor die URL opleverde.
- Warmtescore
- Het aandeel van je gevolgde URL's dat er goed gecachet uitziet, op basis van tijden en cachegerelateerde responsheaders.
- Koude URL
- Een URL die traag blijft zelfs na het opwarmen — meestal een teken dat die niet cachebaar is, niet dat het opwarmen faalde.
Deze komen samen in Cachegezondheid.
Workspaces en rollen
Standaard staat alles in je persoonlijke account. Op plannen met teams kun je workspaces (organisaties) maken die hun eigen warmers, hostnames, alerts en CDN-integraties bezitten.
Leden krijgen een rol — Owner, Admin, Developer, Finance of Viewer — die bepaalt wat ze kunnen zien en wijzigen. Bureaus gebruiken één workspace per klant. Zie Teams en rollen.
Plannen en functies
- Limieten — numerieke plafonds, zoals hoeveel warmers je mag aanmaken, hoe diep ze mogen crawlen en hoeveel URL's je per maand mag opwarmen.
- Functies — of een mogelijkheid überhaupt beschikbaar is, zoals sitemaps, eigen headers, multi-region opwarming, GraphQL of teams.
Velden voor mogelijkheden die je plan niet bevat zijn verborgen of uitgeschakeld, zodat de interface altijd toont wat je echt kunt gebruiken. Zie Plannen en limieten.
API-sleutels
Een publieke sleutel en geheime sleutel samen geven machines toegang — de WordPress-plugin, deploy-webhooks en de publieke API. De geheime sleutel wordt één keer getoond, direct na het aanmaken, en daarna nooit meer. Beheer ze onder Account → Account. Zie API-sleutels.
Nog onduidelijk over een term?
De Begrippenlijst geeft korte definities van elke term in het product, inclusief het cachingjargon dat Cache Rocket van CDN's overneemt.