Protokolle und Prüfung
Auf dieser Seite 8 Abschnitte
- Was wo verfügbar ist
- Request-Inspektor für HTTP-Tunnel
- Den Inspektor öffnen
- Die Anfrageliste
- Details zu Anfrage und Antwort
- Eine Anfrage erneut senden
- Die Anfrageprotokollierung aus- und einschalten
- Verbindungsprotokoll für andere Tunnel
- Das Protokoll als CSV herunterladen
- Aktivitätsprotokoll
- Tunnelzustand
- Wenn ein Tunnel stoppt
- Fehlerbehebung
- Verwandte Seiten
Sehen Sie, was auf einem Tunnel passiert: Prüfen Sie die eingehenden HTTP-Anfragen und senden Sie sie erneut, listen Sie die Verbindungen zum Tunnel auf, lesen Sie das Protokoll der Starts, Stopps und Einstellungsänderungen und kontrollieren Sie seinen Zustand im Tagesverlauf. Diese Seite zeigt auch, wo Sie nachsehen, wenn ein Tunnel gestoppt wurde.
Was wo verfügbar ist #
Alle diese Punkte sind Zeilen im Einstellungsbereich des Tunnels: Öffnen Sie unter Meine Tunnel die Seite des Tunneltyps und wählen Sie in der Zeile des Tunnels Einstellungen.
| Zeile | Was sie öffnet | Tunneltypen |
|---|---|---|
| Anfrageprotokoll | Den Request-Inspektor mit den aufgezeichneten Anfragen und Antworten. | HTTP, MCP-Gateway |
| Anfrageprotokoll | Das Verbindungsprotokoll: wer sich wann und wohin verbunden hat. | TCP - UDP, TLS, Dateiserver, Proxy-Server |
| Aktivitätsprotokoll | Starts, Stopps und Einstellungsänderungen des Tunnels. | Jeder Tunneltyp |
| Tunnelzustand | Die Ergebnisse der regelmäßigen Zustandsprüfungen. | Jeder Tunneltyp außer Dateiserver |
| Bandbreitenverkehr | Die Daten, die durch den Tunnel gelaufen sind. Siehe Limits und Ablauf. | Jeder Tunneltyp |
Ein Rotierender Proxy führt seine Anfrageprotokolle pro Client: Verwenden Sie die Schaltfläche Anfrageprotokolle eines Clients. Siehe Rotierender Proxy.
Request-Inspektor für HTTP-Tunnel #
Der Inspektor zeigt die HTTP-Anfragen, die einen HTTP- oder MCP-Gateway-Tunnel erreichen, mit ihren Headern und Bodys sowie den Antworten Ihres Dienstes. Damit können Sie Webhooks und API-Aufrufe debuggen, ohne Protokollierung in Ihren eigenen Code einzubauen. Anfragen werden erst aufgezeichnet, nachdem Sie die Protokollierung eingeschaltet haben, wie unten beschrieben.
Die Aufzeichnung ist keine Byte-für-Byte-Kopie. Ein Body wird bis zu 16 KB gespeichert, und zwar nur bei Textformaten wie JSON, XML, HTML, Klartext und URL-kodierten Formulardaten. Die Werte sensibler Header wie Authorization, Cookie und X-Api-Key werden als [MASKED] gespeichert.
Den Inspektor öffnen #
- Wählen Sie in den Tunneleinstellungen Anfrageprotokoll › Anzeigen, oder
- wählen Sie in der Tunnelliste die Schaltfläche mit dem Tooltip Request- & Response-Protokolle anzeigen. Diese Schaltfläche fordert Sie auf, zuerst den Tunnel zu starten, wenn er gestoppt ist. Bei Tunneln, deren Spalte Server den Wert Lokal oder VPN zeigt, ist sie deaktiviert, mit dem Tooltip „Für Client Relay nicht verfügbar“.
Die Seite Inspector öffnet sich in einem neuen Tab.
Die Anfrageliste #
Die Karte HTTP-Anfragen listet die Anfragen auf, die neuesten zuerst, und lädt beim Scrollen weitere nach. Solange das Badge Live anzeigt, wird die Liste alle 3 Sekunden aktualisiert.
| Spalte | Was sie zeigt |
|---|---|
| Methode | Die HTTP-Methode, zum Beispiel GET oder POST. |
| Endpunkt | Der angeforderte Pfad. |
| Land, IP | Woher die Anfrage kam. |
| Datum/Uhrzeit | Wann sie eingegangen ist, in der Zeit Ihres Browsers. |
| Status | Der HTTP-Statuscode, mit dem Ihr Dienst geantwortet hat. |
| Dauer | Wie lange die Antwort gedauert hat, in Sekunden. |
Ohne Filter deckt die Liste die letzten 24 Stunden ab. Nach Datum filtern bietet Heute, Gestern, Letzte 7 Tage und Benutzerdefinierter Zeitraum und umfasst den heutigen Tag und die sechs Tage davor. Ein Datumsfilter hält die Live-Liste an; wählen Sie Live schalten, um zu ihr zurückzukehren. Prüfprotokolle werden bis zu 7 Tage aufbewahrt.
Details zu Anfrage und Antwort #
Wählen Sie eine Anfrage, um ihre Details zu öffnen.
| Teil | Tab | Was sie zeigt |
|---|---|---|
| Anfrage | Übersicht | Anfrage-ID, Anfrage-IP, Methode, Host, Pfad, vollständige URL, Zeitstempel, URL-Länge und Anzahl der Header. |
| Anfrage | Header | Jeder Anfrage-Header mit seinem Wert. |
| Anfrage | Body | Der Body der Anfrage. JSON wird lesbar formatiert. Kopieren kopiert ihn. |
| Anfrage | IP-Infos | Zeitzone, Kontinent, Land, Stadt, Postleitzahl, Region und Koordinaten der IP-Adresse des Besuchers. |
| Antwort | Übersicht | Antwort-ID, Status, Antwortzeit und Anzahl der Header. |
| Antwort | Header, Body | Was Ihr Dienst zurückgesendet hat. |
Eine Anfrage erneut senden #
Durch das erneute Senden müssen Sie denselben Webhook nicht noch einmal beim Absender auslösen.
- Erneut senden sendet die ausgewählte Anfrage anhand ihrer Aufzeichnung noch einmal. Die Seite zeigt „Anfrage erfolgreich erneut gesendet.“, sobald das erneute Senden angefordert wurde; sie wartet nicht auf das Ergebnis.
- Ändern öffnet Anfrage ändern. Dort können Sie die Methode (GET, POST, PUT, DELETE oder PATCH), den Pfad, die Header (Header hinzufügen) und den Body ändern, bevor Sie Erneut senden wählen.
Die Localtonet-App auf dem Gerät des Tunnels sendet die erneut gesendete Anfrage, die App muss also verbunden sein.
Die Anfrageprotokollierung aus- und einschalten #
Anfragen werden nur erfasst, solange die Protokollierung eingeschaltet ist, und ein Tunnel startet mit ausgeschalteter Protokollierung. Solange sie aus ist, zeigt die Seite „Die Anfrageprotokollierung ist deaktiviert – neue Anfragen werden nicht aufgezeichnet.“ mit der Schaltfläche Protokollierung aktivieren. Protokollierung deaktivieren beendet die Erfassung neuer Anfragen wieder. Schalten Sie die Protokollierung für einen Tunnel aus, der Daten überträgt, die nicht gespeichert werden sollen, etwa Passwörter oder personenbezogene Daten in Request-Bodys. Die Änderung wird im Aktivitätsprotokoll als „HTTP-Webhook-Einstellung geändert.“ vermerkt.
Verbindungsprotokoll für andere Tunnel #
Bei TCP - UDP-, TLS-, Dateiserver- und Proxy-Server-Tunneln öffnet Anfrageprotokoll › Anzeigen den Dialog Anfrageprotokoll. Er listet die Verbindungen zum Tunnel auf, die neuesten zuerst, 30 pro Seite.
| Spalte | Was sie zeigt |
|---|---|
| Besucher-IP | Die Adresse, die sich mit dem Tunnel verbunden hat. |
| Client-IP | Die für die Verbindung aufgezeichnete Client-Adresse. |
| Ziel | Wohin die Verbindung ging. Bei einem Proxy-Tunnel sind das der besuchte Host und Port. |
| Datum | Wann es passiert ist, in der Zeitzone Ihres Kontos. |
Dieses Protokoll enthält nur Verbindungsmetadaten. Es enthält nicht, was über die Verbindung gesendet wurde.
Das Protokoll als CSV herunterladen #
Wählen Sie unter Als CSV herunterladen einen Zeitraum von bis zu 30 Tagen und dann Herunterladen. Der Dateiname beginnt mit RequestLogs-, gefolgt von der internen Kennung des Tunnels, und endet auf .csv. Die Datei hat die Spalten Datum und Uhrzeit, Anfrage-IP, Client-IP, Ziel, Token und Protokoll. Für einen längeren Zeitraum laden Sie mehrere Bereiche nacheinander herunter. Downloads sind auf einen pro Minute begrenzt, warten Sie also zwischen zwei Downloads eine Minute.
Aktivitätsprotokoll #
Aktivitätsprotokoll › Anzeigen listet auf, was mit dem Tunnel selbst passiert ist, die neuesten Einträge zuerst. Jeder Eintrag hat Datum und Uhrzeit in der Zeitzone Ihres Kontos, den Kanal, von dem die Aktion kam, und einen Satz, der sagt, was sich geändert hat.
| Kanal | Die Aktion kam von |
|---|---|
| Web | Dem Dashboard. |
| API | Der API. |
| CLI | Der Befehlszeile. |
| System | Localtonet selbst, zum Beispiel wenn ein Limit erreicht wurde. |
Typische Einträge:
- Tunnel gestartet.
- Tunnel gestoppt.
- Lokaler Port von „3000“ auf „8080“ geändert.
- IP-Beschränkung hinzugefügt: „203.0.113.10“
- Bandbreitenlimit geändert: „10.00 GB“
- Ablaufdatum deaktiviert.
Ein neues oder geändertes Passwort wird nicht in das Protokoll geschrieben. Es erscheint als „Passwort festgelegt.“ oder „Passwort geändert.“
Tunnelzustand #
Tunnelzustand › Anzeigen öffnet den Dialog Zustandsprüfungen. Localtonet prüft den Tunnel alle 10 Minuten. Jedes Quadrat ist eine Prüfung, nach Tageszeit, für den aktuellen Tag.
| Wert | Bedeutung |
|---|---|
| Fehlerfrei | Der Tunnel war bei dieser Prüfung verbunden. |
| Fehlerhaft | Der Tunnel war bei dieser Prüfung nicht verbunden. |
| Unbekannt | Für diese Zeit und für keine frühere Zeit gibt es ein Ergebnis. |
| Keine Daten | Die Zeit ist heute noch nicht erreicht. |
| Verfügbarkeit | Der Anteil der fehlerfreien Prüfungen unter den fehlerfreien und fehlerhaften. |
Wenn der Dialog keine Quadrate anzuzeigen hat, steht dort „Noch keine Prüfungen erfasst. Ergebnisse erscheinen hier, sobald der Tunnel eine Weile gelaufen ist.“
Wenn ein Tunnel stoppt #
Öffnen Sie zuerst das Aktivitätsprotokoll des Tunnels. Der neueste Eintrag „gestoppt“ nennt den Grund.
| Eintrag im Aktivitätsprotokoll | Was passiert ist | Was zu tun ist |
|---|---|---|
| „Tunnel gestoppt.“ | Jemand hat ihn gestoppt. Der Kanal zeigt, woher die Aktion kam, zum Beispiel Web für das Dashboard oder API. | Wählen Sie Starten. |
| „Tunnel gestoppt, weil das Bandbreitenlimit des Tunnels erreicht wurde.“ | Das eigene Bandbreitenlimit des Tunnels wurde erreicht. | Erhöhen Sie das Limit oder setzen Sie die Nutzung zurück. Siehe Limits und Ablauf. |
| „Tunnel gestoppt, weil sein Ablaufdatum erreicht wurde.“ | Das Ablaufdatum des Tunnels ist verstrichen. | Legen Sie ein späteres Datum fest oder schalten Sie es aus. Siehe Limits und Ablauf. |
| „Tunnel gestoppt, weil das Limit für die kostenlose Nutzung erreicht wurde.“ | Das Sitzungslimit des kostenlosen Plans wurde erreicht. | Wählen Sie Starten, um eine weitere Sitzung zu beginnen, oder laden Sie Guthaben auf. Siehe Pläne und Guthaben. |
| „Tunnel gestoppt, weil das gesamte Bandbreitenlimit überschritten wurde.“ | Die Bandbreite des Kontos ist aufgebraucht. | Siehe Pläne und Guthaben. |
| „Tunnel gestoppt, weil er inaktiv war und keine Verbindungen hatte.“ | Localtonet hat einen Tunnel gestoppt, der gestartet, aber nicht verbunden war. | Lassen Sie die Localtonet-App verbunden und wählen Sie Starten, wenn Sie den Tunnel wieder brauchen. |
Zeigt das Protokoll keinen Stopp, die Adresse antwortet aber nicht, prüfen Sie die Spalte Verbindung der Tunnelliste. AUS bedeutet, dass der Tunnel nicht verbunden ist: Starten Sie die Localtonet-App auf dem Gerät. Wenn Sie Starten wählen, während die App offline ist, öffnet das Dashboard einen Dialog mit dem Titel „NAME ist offline“ und dem Text „Warten auf Verbindung der App…“. Der Tunnel startet von selbst, sobald sich die App verbindet; Trotzdem starten schaltet den Tunnel jetzt ein, und er geht online, sobald sich die App verbindet.
Lassen Sie sich benachrichtigen, wenn ein Tunnel ausfällt. Die Seite Webhooks des Dashboards kann eine JSON-POST-Anfrage an Ihre URL senden, wenn ein Tunnel sich verbindet oder trennt. Siehe Webhooks.
Fehlerbehebung #
„Bitte starten Sie zuerst Ihren Tunnel.“
Die Inspektor-Schaltfläche in der Tunnelliste öffnet sich nur bei einem laufenden Tunnel. Starten Sie den Tunnel oder öffnen Sie den Inspektor über Anfrageprotokoll › Anzeigen in den Tunneleinstellungen.
Der Inspektor bleibt leer
Prüfen Sie drei Dinge: Das Banner „Die Anfrageprotokollierung ist deaktiviert“ wird nicht angezeigt; es ist kein Datumsfilter aktiv (wählen Sie Live schalten); und die Anfrage erreicht tatsächlich die Tunneladresse und nicht eine andere Adresse Ihres Dienstes.
„Noch keine Anfragen erfasst.“ oder „Keine Daten gefunden!“
Das Verbindungsprotokoll hat keine Einträge für den Tunnel oder keine im Zeitraum, den Sie für die CSV gewählt haben. Wählen Sie einen anderen Zeitraum.
„Für diesen Tunnel wurden keine Protokolle gefunden.“
Das Aktivitätsprotokoll hat noch keine Einträge. Es füllt sich, wenn der Tunnel gestartet, gestoppt und geändert wird.