Naar de inhoud
Localtonet Localtonet Dashboard

Logboeken en verzoekinspectie

Hulp bij deze pagina
Op deze pagina 8 secties
  1. Wat waar beschikbaar is
  2. Verzoekinspector voor HTTP-tunnels
  3. De inspector openen
  4. De verzoeklijst
  5. Details van verzoek en antwoord
  6. Een verzoek opnieuw afspelen
  7. Verzoeklogging uit- en inschakelen
  8. Verbindingslogboek voor andere tunnels
  9. Het logboek downloaden als CSV
  10. Activiteitenlogboek
  11. Tunnelgezondheid
  12. Wanneer een tunnel stopt
  13. Probleemoplossing
  14. Gerelateerde pagina's

Bekijk wat er op een tunnel gebeurt: inspecteer en speel de HTTP-verzoeken die hij ontvangt opnieuw af, bekijk de verbindingen die ermee zijn gemaakt, lees het logboek van starts, stops en instellingswijzigingen en controleer de gezondheid ervan over de dag. Deze pagina laat ook zien waar je moet kijken als een tunnel is gestopt.

Wat waar beschikbaar is #

Dit zijn allemaal rijen in het instellingenpaneel van de tunnel: open de pagina van het tunneltype onder Mijn tunnels en kies Instellingen in de rij van de tunnel.

RijWat het opentTunneltypen
VerzoeklogboekDe verzoekinspector, met de vastgelegde verzoeken en antwoorden.HTTP, MCP-gateway
VerzoeklogboekHet verbindingslogboek: wie er verbond, wanneer en waarmee.TCP - UDP, TLS, Bestandsserver, Proxyserver
ActiviteitenlogboekStarts, stops en instellingswijzigingen van de tunnel.Elk tunneltype
TunnelgezondheidDe resultaten van de regelmatige gezondheidscontroles.Elk tunneltype behalve Bestandsserver
BandbreedteverkeerDe data die door de tunnel is gegaan. Zie Limieten en vervaldatum.Elk tunneltype

Een Roterende proxy bewaart zijn verzoeklogboeken per client: gebruik de knop Verzoeklogboeken van een client. Zie Roterende proxy.

Verzoekinspector voor HTTP-tunnels #

De inspector toont de HTTP-verzoeken die een HTTP- of MCP-gatewaytunnel bereiken, met hun headers en bodies en de antwoorden die je service gaf. Gebruik hem om webhooks en API-aanroepen te debuggen zonder logging aan je eigen code toe te voegen. Verzoeken worden pas vastgelegd nadat je logging hebt ingeschakeld, zoals hieronder beschreven.

De opname is geen kopie byte voor byte. Een body wordt tot 16 KB opgeslagen, en alleen voor tekstformaten zoals JSON, XML, HTML, platte tekst en URL-gecodeerde formuliergegevens. De waarden van gevoelige headers, zoals Authorization, Cookie en X-Api-Key, worden opgeslagen als [MASKED].

De inspector openen #

  • Kies in de tunnelinstellingen Verzoeklogboek › Tonen, of
  • kies in de tunnellijst de knop met de tooltip Verzoek- & responslogboeken bekijken. Deze knop vraagt je eerst de tunnel te starten als hij gestopt is. Voor tunnels waarvan de kolom Server Lokaal of VPN toont, is hij uitgeschakeld, met de tooltip "Niet beschikbaar voor Client Relay".

De pagina Inspector opent in een nieuw tabblad.

De verzoeklijst #

De kaart HTTP-verzoeken toont de verzoeken, de nieuwste eerst, en laadt er meer terwijl je scrolt. Zolang het label Live toont, wordt de lijst elke 3 seconden ververst.

KolomWat het toont
MethodeDe HTTP-methode, zoals GET of POST.
EndpointHet pad dat is opgevraagd.
Land, IPWaar het verzoek vandaan kwam.
Datum/tijdWanneer het binnenkwam, in de tijd van je browser.
StatusDe HTTP-statuscode waarmee je service antwoordde.
DuurHoe lang het antwoord duurde, in seconden.

Zonder filter beslaat de lijst de laatste 24 uur. Filteren op datum biedt Vandaag, Gisteren, Laatste 7 dagen en Aangepaste periode, en beslaat vandaag en de zes dagen daarvoor. Een datumfilter pauzeert de live lijst; kies Ga live om ernaar terug te keren. Inspectielogboeken worden maximaal 7 dagen bewaard.

Details van verzoek en antwoord #

Kies een verzoek om de details te openen.

OnderdeelTabbladWat het toont
VerzoekOverzichtVerzoek-ID, IP van het verzoek, methode, host, pad, volledige URL, tijdstempel, URL-lengte en het aantal headers.
VerzoekHeadersElke verzoekheader met zijn waarde.
VerzoekBodyDe body van het verzoek. JSON wordt opgemaakt om te lezen. Kopiëren kopieert hem.
VerzoekIP-infoTijdzone, continent, land, plaats, postcode, regio en coördinaten van het IP-adres van de bezoeker.
AntwoordOverzichtAntwoord-ID, status, responstijd en het aantal headers.
AntwoordHeaders, BodyWat je service heeft teruggestuurd.

Een verzoek opnieuw afspelen #

Door opnieuw af te spelen hoef je dezelfde webhook niet nog een keer bij de afzender te activeren.

  • Opnieuw afspelen verstuurt het geselecteerde verzoek opnieuw vanuit zijn opname. De pagina toont "Verzoek succesvol opnieuw afgespeeld." zodra het opnieuw afspelen is aangevraagd; ze wacht niet op het resultaat.
  • Wijzigen opent Verzoek wijzigen, waar je de methode (GET, POST, PUT, DELETE of PATCH), het Pad, de headers (Header toevoegen) en de Body kunt aanpassen voordat je Opnieuw afspelen kiest.

De Localtonet-app op het apparaat van de tunnel verstuurt het opnieuw afgespeelde verzoek, dus de app moet verbonden zijn.

Verzoeklogging uit- en inschakelen #

Verzoeken worden alleen vastgelegd zolang logging aan staat, en een tunnel start met logging uit. Zolang die uit staat, toont de pagina "Logging van verzoeken is uitgeschakeld - nieuwe verzoeken worden niet vastgelegd." met de knop Logging inschakelen. Logging uitschakelen stopt het vastleggen van nieuwe verzoeken weer. Schakel logging uit voor een tunnel met gegevens die je niet wilt opslaan, zoals wachtwoorden of persoonsgegevens in verzoekbodies. De wijziging wordt in het Activiteitenlogboek geschreven als "HTTP-webhookinstelling gewijzigd."

Verbindingslogboek voor andere tunnels #

Bij TCP - UDP-, TLS-, Bestandsserver- en Proxyservertunnels opent Verzoeklogboek › Tonen het dialoogvenster Verzoeklogboek. Het toont de verbindingen met de tunnel, de nieuwste eerst, 30 per pagina.

KolomWat het toont
IP van bezoekerHet adres dat met de tunnel verbond.
Client-IPHet clientadres dat voor de verbinding is vastgelegd.
BestemmingWaar de verbinding naartoe ging. Bij een proxytunnel is dit de host en poort die zijn bezocht.
DatumWanneer het gebeurde, in de tijdzone van je account.

Dit logboek bevat alleen metadata van verbindingen. Het bevat niet wat er via de verbinding is verstuurd.

Het logboek downloaden als CSV #

Kies onder Downloaden als CSV een periode van maximaal 30 dagen en kies Downloaden. De bestandsnaam begint met RequestLogs-, gevolgd door de interne identificatie van de tunnel, en eindigt op .csv. Het bestand heeft de kolommen Datum en tijd, IP van verzoek, Client-IP, Bestemming, Token en Protocol. Download voor een langere periode meerdere periodes na elkaar. Downloads zijn beperkt tot één per minuut, dus wacht een minuut tussen twee downloads.

Activiteitenlogboek #

Activiteitenlogboek › Tonen toont wat er met de tunnel zelf is gebeurd, de nieuwste eerst. Elk item heeft de datum en tijd in de tijdzone van je account, het kanaal waar de actie vandaan kwam en een zin die zegt wat er is gewijzigd.

KanaalDe actie kwam van
WebHet dashboard.
APIDe API.
CLIDe opdrachtregel.
SysteemLocaltonet zelf, bijvoorbeeld wanneer een limiet is bereikt.

Typische items:

  • Tunnel gestart.
  • Tunnel gestopt.
  • Lokale poort gewijzigd van “3000” naar “8080”.
  • IP-beperking toegevoegd: “203.0.113.10”
  • Bandbreedtelimiet gewijzigd: “10.00 GB”
  • Vervaldatum uitgeschakeld.

Een nieuw of gewijzigd wachtwoord wordt niet in het logboek geschreven. Het verschijnt als "Wachtwoord ingesteld." of "Wachtwoord gewijzigd."

Tunnelgezondheid #

Tunnelgezondheid › Tonen opent het dialoogvenster Gezondheidscontroles. Localtonet controleert de tunnel elke 10 minuten. Elk vierkantje is één controle, per tijdstip van de dag, voor de huidige dag.

WaardeBetekenis
GezondDe tunnel was bij die controle verbonden.
OngezondDe tunnel was bij die controle niet verbonden.
OnbekendEr is geen resultaat voor dat tijdstip of voor een eerder tijdstip.
Geen gegevensHet tijdstip is vandaag nog niet aangebroken.
UptimeHet aandeel gezonde controles onder de gezonde en ongezonde.

Als het dialoogvenster geen vierkantjes heeft om te tonen, staat er "Nog geen controles vastgelegd. Resultaten verschijnen hier zodra de tunnel een tijdje heeft gedraaid."

Wanneer een tunnel stopt #

Open eerst het Activiteitenlogboek van de tunnel. Het nieuwste "gestopt"-item geeft de reden.

Item in het ActiviteitenlogboekWat er is gebeurdWat je moet doen
"Tunnel gestopt."Iemand heeft hem gestopt. Het kanaal toont waar de actie vandaan kwam, bijvoorbeeld Web voor het dashboard of API.Kies Starten.
"Tunnel gestopt omdat de bandbreedtelimiet van de tunnel is bereikt."De eigen Bandbreedtelimiet van de tunnel is bereikt.Verhoog de limiet of zet het verbruik terug. Zie Limieten en vervaldatum.
"Tunnel gestopt omdat de vervaldatum is bereikt."De Vervaldatum van de tunnel is verstreken.Stel een latere datum in of schakel hem uit. Zie Limieten en vervaldatum.
"Tunnel gestopt omdat de limiet voor gratis gebruik is bereikt."De sessielimiet van het Gratis-abonnement is bereikt.Kies Starten om een nieuwe sessie te beginnen, of voeg Saldo toe. Zie Abonnementen en saldo.
"Tunnel gestopt omdat de totale bandbreedtelimiet is overschreden."De bandbreedte van het account is opgebruikt.Zie Abonnementen en saldo.
"Tunnel gestopt omdat hij inactief was en geen verbindingen had."Localtonet heeft een tunnel gestopt die was gestart maar niet verbonden was.Houd de Localtonet-app verbonden en kies Starten wanneer je de tunnel weer nodig hebt.

Als het logboek geen stop toont maar het adres niet antwoordt, controleer dan de kolom Verbinding van de tunnellijst. UIT betekent dat de tunnel niet verbonden is: start de Localtonet-app op het apparaat. Als je Starten kiest terwijl de app offline is, opent het dashboard een dialoogvenster met de titel "NAME is offline" en de tekst "Wachten tot de app verbinding maakt…". De tunnel start vanzelf zodra de app verbinding maakt; Toch starten zet de tunnel nu aan, en hij gaat live zodra de app verbinding maakt.

Laat je waarschuwen als een tunnel uitvalt. De pagina Webhooks van het dashboard kan een JSON POST-verzoek naar je URL sturen wanneer een tunnel verbinding maakt of verbreekt. Zie Webhooks.

Probleemoplossing #

"Start eerst je tunnel."

De inspectorknop in de tunnellijst opent alleen voor een draaiende tunnel. Start de tunnel, of open de inspector met Verzoeklogboek › Tonen in de tunnelinstellingen.

De inspector blijft leeg

Controleer drie dingen: de banner "Logging van verzoeken is uitgeschakeld" wordt niet getoond; er is geen datumfilter actief (kies Ga live); en het verzoek bereikt echt het tunneladres, niet een ander adres van je service.

"Nog geen verzoeken vastgelegd." of "Geen gegevens gevonden!"

Het verbindingslogboek heeft geen items voor de tunnel, of geen in de periode die je voor de CSV hebt gekozen. Kies een andere periode.

"Geen logboeken gevonden voor deze tunnel."

Het Activiteitenlogboek heeft nog geen items. Het vult zich naarmate de tunnel wordt gestart, gestopt en gewijzigd.

Support