Ga naar inhoud

Logs bekijken

CloudPress bewaart verschillende soorten logs voor een site: de edge-access-logs van de CDN, de access- en error-logs van de webserver van je site, en Shield-beveiligingsgebeurtenissen. De meeste zijn direct in het dashboard te bekijken, en je kunt de ruwe Nginx-logbestanden ook rechtstreeks via SFTP/SSH uitlezen.

Log Beantwoordt Waar te vinden
CDN-access-logs Welke aanvragen de CDN heeft geserveerd, cache hit/miss, statuscodes en waar bezoekers vandaan kwamen Logviewer → tabblad CDN Logs
Error-logs Webserver- en PHP-fouten op je site (5xx-antwoorden, fatale fouten) Logviewer → tabblad Error logs, of logs/error.log
Access-logs Elke aanvraag die de webserver van je site heeft afgehandeld Logviewer → tabblad Toeganglogs, of logs/access.log
Shield-beveiligingsgebeurtenissen Wat Shield blokkeerde, uitdaagde of logde (WAF, bots, rate limits) Shield → Security events

Voordat je begint

  • Een site die klaar is met provisioneren en de status ONLINE toont.
  • Toestemming om de site te bewerken — het bekijken van logs is, net als bestandstoegang, beschikbaar voor gebruikers die de site kunnen bewerken.
  • CDN-access-logs vereisen dat de CDN actief is op de site, en Security events vereisen dat Shield in je abonnement is inbegrepen. De overige logs zijn altijd beschikbaar.

De Logviewer (dashboard)

Open in de linkerzijbalk van de site het menu Analytics & Logs en kies Logviewer. De pagina heeft drie tabbladen: CDN Logs, Error logs en Toeganglogs.

Een tijdsbereik-besturing rechtsboven — Laatste uur, Laatste 6 uur, Laatste 24 uur (de standaard) en Laatste 3 dagen — stuurt de CDN-samenvatting en de tabel aan.

CDN Logs

Het tabblad CDN Logs toont aanvragen die de CDN aan de edge heeft geserveerd. Boven de tabel rapporteert een strook met samenvattingskaarten Totaal aantal requests, Cache-hitpercentage, 4xx-fouten en 5xx-fouten, samen met verdelingen per status en cachestatus en de top-URL's, -landen en -IP's.

Filter de tabel met de velden Status (bijv. 404), Cache (bijv. HIT / MISS), Land (bijv. US) en URL bevat, en klik dan op Toepassen (Opnieuw instellen wist ze). Elke rij is één aanvraag, met kolommen voor Tijdstip, Cache, Code, Extern IP, Land, Edge-locatie, URL, User agent, Request ID, JA4-vingerafdruk en ASN.

Wat je kunt verwachten van CDN-logs

  • De bewaartermijn is 3 dagen. Het kiezen van een breder bereik retourneert "Dat tijdsbereik is te groot." De CDN bewaart maximaal drie dagen aan logs.
  • Bezoekers-IP's zijn geanonimiseerd — het laatste octet wordt op nul gezet, zodat adressen eindigen op .0. Dat is verwacht gedrag, geen bug.
  • De samenvatting kan achterlopen op de tabel. De vier hoofdkaarten zijn echte vensterbrede totalen (en kunnen tot ongeveer een uur achterlopen), terwijl de verdelingen en "top"-lijsten worden berekend uit een steekproef van de meest recente aanvragen — dus ze tellen niet altijd op tot de hoofdcijfers.
  • Als de CDN niet actief is op de site, toont dit tabblad "CDN-logging is niet actief voor deze site." Zie Edge-regels beheren voor de CDN.

Error logs en Toeganglogs

De tabbladen Error logs en Toeganglogs tonen de error- en access-logs van de webserver (Nginx) van je site, gelezen uit de site-container. Dit zijn dezelfde logs als de bestanden error.log en access.log op het volume (zie De ruwe logbestanden uitlezen hieronder) — de tabbladen zijn slechts een snelle weergave in het dashboard van de meest recente regels.

Het tabblad Error logs is de eerste plek om te kijken wanneer een pagina een 500 retourneert of een plugin zich misdraagt. Als er voor de huidige dag niets is, toont het "Geen origin-foutlogs gevonden voor vandaag".

Shield-beveiligingsgebeurtenissen

Als je abonnement Shield bevat, staat het gebeurtenissenlog op een eigen pagina. Open in de zijbalk het menu Shield en kies Security events (de pagina heet Shield security events).

Kies een dag met de Datum-kiezer (deze staat standaard op vandaag). Elke rij is één actie die Shield heeft ondernomen, met deze kolommen:

Kolom Wat het toont
Tijdstip Wanneer de gebeurtenis plaatsvond
Ernst Kritiek, Waarschuwing of Melding
Regel-ID De Shield/WAF-regel die overeenkwam
Land Land van herkomst van de aanvraag
Methode HTTP-methode (GET, POST, …)
Status Geretourneerde HTTP-statuscode

Als Shield niets heeft gelogd voor de gekozen dag, zie je "Geen security events geregistreerd voor deze datum." Voor het afstemmen van wat Shield doet, zie de Shield-handleidingen.

De ruwe logbestanden uitlezen

De volledige Nginx-logs van je site staan in de map logs/ in de root van het volume van de site:

/home/sftpuser/apps/{{ container name }}/wordpress/logs/

Deze bevat access.log (elke aanvraag) en error.log (webserver- en PHP-fouten). Dit zijn de complete bestanden — handig wanneer je meer geschiedenis nodig hebt dan de dashboardtabbladen tonen, of ze live wilt doorzoeken of met tail -f wilt volgen.

Bereik ze met elke methode voor bestandstoegang — SFTP, SSH, de File Manager of Cloud Shell. Zie Toegang tot je bestanden voor hoe je verbinding maakt. Vanuit een SSH- of Cloud Shell-sessie:

# Your shell starts in /home/sftpuser; there's one app directory per site.
cd apps/*/wordpress/logs

tail -n 100 error.log     # the last 100 error-log lines
tail -f access.log        # follow requests live — press Ctrl-C to stop
grep " 500 " access.log   # find requests that returned a 500

Logs uitlezen via de API

Twee van deze logs zijn ook beschikbaar via de REST API:

  • CDN-access-logs — GET /api/sites/:site_id/logs/cdn (en …/logs/cdn/summary). Ondersteunt dezelfde filters status, cache_status, country en url_contains als het dashboard, plus een period van 1h/6h/24h/72h. Vereist dat de CDN actief is (409 cdn_not_active). Zie CDN, Cache & Logs.
  • Shield-beveiligingsgebeurtenissen — GET /api/sites/:site_id/shield/events voor een gegeven date (MM-DD-YYYY). Zie Shield.
curl -H "Authorization: Bearer $CLOUDPRESS_TOKEN" -H "X-Auth-Account: $ACCOUNT_ID" \
  "https://my.cloudpress.com/api/sites/$SITE_ID/logs/cdn?period=24h&status=404"

Verder lezen