Problemen oplossen

Problemen vallen in drie groepen, en vaststellen welke je hebt beperkt de oorzaak direct.

Er draait helemaal niets#

1. 1

   Is de warmer Actief?

   Met ruime afstand de meest voorkomende oorzaak. Een inactieve warmer behoudt zijn instellingen en draait nooit.

2. 2

   Is de hostname Geverifieerd?

   Kijk op Account → Hostnames. Verificatie in behandeling blokkeert elke run. Zie Hostnameverificatie.

3. 3

   Komt de hostname van de entry-URL exact overeen met de geverifieerde?

   example.com en www.example.com zijn verschillend. Een warmer die op de niet-geverifieerde vorm wijst draait niet.

4. 4

   Heb je een planlimiet geraakt?

   Kijk op Account → Abonnement. Een opgebruikt dag- of maandbudget stopt het opwarmen tot de periode opnieuw begint.

5. 5

   Blokkeert een opwarmvenster het?

   Staat er een opwarmschema, dan worden geplande starts buiten het venster overgeslagen. Start de warmer handmatig — werkt dat, dan is het venster de oorzaak.

6. 6

   Zit je in de juiste workspace?

   Warmers horen bij een workspace. Kijk naar de kiezer in de zijbalk — de warmer kan bestaan op een plek waar je nu niet kijkt.

Het draait maar URL's geven fouten#

403 Forbidden

Iets blokkeert de crawler bewust — een WAF, een botfilter, Cloudflare bot management of een beveiligingsplugin.

• Sta Cache Rocket-requests toe bij je firewall of CDN.
• Stel een kenmerkende eigen user agent in en sta die toe.
• Verlaag max URL's per minuut — veel botfilters reageren op het requesttempo, niet op de identiteit.
• Controleer op een landenblokkade, als de regio van je warmer afwijkt van waar je normaal vandaan browst.

429 Too Many Requests

Je warmt sneller op dan je server of CDN toestaat. Verlaag max URL's per minuut flink — halveer het, controleer of de fouten stoppen, en verhoog daarna geleidelijk. Handhaaft je host een gedocumenteerde limiet, blijf daar dan ruim onder.

5xx serverfouten

Je origin bezwijkt onder de belasting. Verlaag de rate limit onmiddellijk.

301 / 302 redirects

Je entry-URL's of interne links wijzen naar iets dat doorverwijst. Elke redirect verspilt een request en warmt het verkeerde adres op.

• Gebruik de eindbestemming als entry-URL, met of zonder www zoals je site het echt levert.
• Gebruik altijd https://, nooit http://.
• Zet Herschrijven naar HTTPS aan als interne links nog http gebruiken.
• Volg de conventie van je site voor de afsluitende slash.

404 Not Found

Kapotte interne links, een verouderde sitemap met verwijderde pagina's, of ontdekte URL's die nooit bestonden. Herstel de links, genereer de sitemap opnieuw, of sluit het betreffende patroon uit.

Verkeerd aantal URL's#

Veel minder dan verwacht

• De diepte is te laag. Pagina's verder dan je diepte-instelling worden nooit bereikt.
• Sitemaps staan uit. Die aanzetten is meestal de grootste dekkingswinst.
• Uitsluitingen zijn te ruim. Een regel bedoeld voor /search kan meer opvangen dan je bedoelde.
• Je navigatie is alleen JavaScript. Links die niet in de HTML staan kan een HTTP-fetch niet ontdekken. Overweeg browseropwarming, of voeg sitemaps toe.

Veel meer dan verwacht

• Facet-URL's. Filter- en sorteercombinaties vermenigvuldigen eindeloos. Sluit ze uit, met regex als dat beschikbaar is.
• Sessie- of trackingparameters. URL's die alleen in een queryparameter verschillen worden apart geteld.
• Diepe paginering. Archiefpagina's twintig diep zijn zelden het opwarmen waard.
• De diepte is te hoog. Zet er een niveau af.

Het draait netjes maar niets wordt sneller#

Statuscodes zijn 200, URL's zijn gedekt, en beide laadtijden blijven traag. Het opwarmen werkt — je caching niet. Cache Rocket kan alleen een cache bijvullen die bestaat.

1. 1

   Controleer of de pagina cachebaar is

   Kijk naar de responseheaders. Cache-Control: no-store of private betekent dat hij nooit gecachet wordt, hoe vaak je hem ook opwarmt.

2. 2

   Kijk naar Set-Cookie op publieke pagina's

   Veel caches weigeren een response op te slaan die een cookie zet. Analytics- en sessiecookies op anonieme pagina's zijn een veelvoorkomende oorzaak.

3. 3

   Controleer de cacheregels van je CDN

   Kijk of het pad echt gecachet wordt in plaats van omzeild, en waarop de cachesleutel varieert.

4. 4

   Vergelijk het request van de warmer met een echt request

   Stuurt de warmer een cookie, header of user agent die bezoekers niet sturen, dan vult hij mogelijk een cachevariant die niemand opvraagt.

5. 5

   Kijk naar de lijst koude URL's in Cachegezondheid

   Die noemt precies welke URL's het betreft, wat vaak het patroon blootlegt. Zie Cachegezondheid.

curl -s -o /dev/null -w "%{time_total}s\n" https://www.example.com/
curl -s -o /dev/null -w "%{time_total}s\n" https://www.example.com/

curl -sI https://www.example.com/ | grep -i "cache\|age\|set-cookie"

Integratieproblemen#

Een deploy-webhook geeft 401 terug.

API-sleutels zijn verkeerd, verlopen of vervangen. Controleer of de headernamen exact X-Public-Key en X-Secret-Key zijn, en let op afgekapte waarden. Zie API-sleutels.

Een deploy-webhook lukt maar er wordt niets opgewarmd.

De hostname in de body past bij geen enkele actieve warmer. Controleer de exacte hostname inclusief www, en of de warmer Actief is.

Een CDN-purge wordt geweigerd.

Het token mist purge-rechten of is aan de verkeerde zone-ID gekoppeld. Zie CDN-integraties.

De WordPress-plugin zegt dat de sleutels ongeldig zijn.

Kopieer beide sleutels opnieuw en let op witruimte. Is er sindsdien een nieuwer paar gegenereerd, dan werkt de oude niet meer.

Alerts komen nooit aan.

Test de webhook-URL direct met curl. Controleer of minstens één gebeurtenis is aangevinkt, en of de Slack- of Discord-integratie nog bestaat.

Nog steeds vast?#

Verzamel dit voordat je contact opneemt met support — dat maakt van een lange uitwisseling één antwoord:

• De naam van de warmer en de betrokken hostname.
• Wat je verwachtte, en wat er werkelijk gebeurde.
• Representatieve statuscodes en laadtijden van de resultatenpagina van de warmer.
• Of de hostname Geverifieerd toont.
• Je plannaam, en je abonnements-ID uit de sectie Referenties op de abonnementspagina.