Log e ispezione delle richieste
In questa pagina 8 sezioni
- Cosa è disponibile e dove
- Ispettore delle richieste per i tunnel HTTP
- Apri l'ispettore
- L'elenco delle richieste
- Dettagli di richiesta e risposta
- Ripetere una richiesta
- Disattivare e attivare la registrazione delle richieste
- Registro delle connessioni per gli altri tunnel
- Scarica il registro come CSV
- Registro attività
- Salute del tunnel
- Quando un tunnel si ferma
- Risoluzione dei problemi
- Pagine correlate
Scopri cosa succede su un tunnel: ispeziona e ripeti le richieste HTTP che riceve, elenca le connessioni fatte verso di esso, leggi il registro di avvii, arresti e modifiche alle impostazioni e controlla il suo stato di salute nell'arco della giornata. Questa pagina indica anche dove guardare quando un tunnel si è fermato.
Cosa è disponibile e dove #
Sono tutte voci del pannello delle impostazioni del tunnel: apri la pagina del tipo di tunnel sotto I miei tunnel e seleziona Impostazioni nella riga del tunnel.
| Voce | Cosa apre | Tipi di tunnel |
|---|---|---|
| Registro richieste | L'ispettore delle richieste, con le richieste e le risposte registrate. | HTTP, Gateway MCP |
| Registro richieste | Il registro delle connessioni: chi si è connesso, quando e verso dove. | TCP - UDP, TLS, File server, Server proxy |
| Registro attività | Avvii, arresti e modifiche alle impostazioni del tunnel. | Ogni tipo di tunnel |
| Salute del tunnel | I risultati dei controlli di salute periodici. | Ogni tipo di tunnel tranne File server |
| Traffico di banda | I dati che sono passati attraverso il tunnel. Vedi Limiti e scadenza. | Ogni tipo di tunnel |
Un Proxy a rotazione conserva i suoi registri delle richieste per ogni client: usa il pulsante Registro richieste di un client. Vedi Proxy a rotazione.
Ispettore delle richieste per i tunnel HTTP #
L'ispettore mostra le richieste HTTP che raggiungono un tunnel HTTP o Gateway MCP, con i loro header e body e le risposte date dal tuo servizio. Usalo per fare il debug di webhook e chiamate API senza aggiungere log al tuo codice. Le richieste vengono registrate solo dopo che attivi la registrazione, come descritto più sotto.
La registrazione non è una copia byte per byte. Un body viene salvato fino a 16 KB, e solo per formati di testo come JSON, XML, HTML, testo semplice e dati di form codificati nell'URL. I valori degli header sensibili, come Authorization, Cookie e X-Api-Key, vengono salvati come [MASKED].
Apri l'ispettore #
- Nelle impostazioni del tunnel, seleziona Registro richieste › Mostra, oppure
- nell'elenco dei tunnel, seleziona il pulsante con il tooltip Visualizza i log di richieste e risposte. Questo pulsante ti chiede di avviare prima il tunnel se è fermo. Per i tunnel la cui colonna Server mostra Locale o VPN è disattivato, con il tooltip "Non disponibile per Client Relay".
La pagina Inspector si apre in una nuova scheda.
L'elenco delle richieste #
La scheda Richieste HTTP elenca le richieste, le più recenti per prime, e ne carica altre mentre scorri. Finché il badge mostra Live, l'elenco si aggiorna ogni 3 secondi.
| Colonna | Cosa mostra |
|---|---|
| Metodo | Il metodo HTTP, come GET o POST. |
| Endpoint | Il percorso richiesto. |
| Paese, IP | Da dove proviene la richiesta. |
| Data e ora | Quando è arrivata, nel fuso orario del tuo browser. |
| Stato | Il codice di stato HTTP con cui ha risposto il tuo servizio. |
| Durata | Quanto ha impiegato la risposta, in secondi. |
Senza filtro l'elenco copre le ultime 24 ore. Filtra per data offre Oggi, Ieri, Ultimi 7 giorni e Intervallo personalizzato, e copre oggi e i sei giorni precedenti. Un filtro per data mette in pausa l'elenco in tempo reale; seleziona Vai live per tornarci. I log di ispezione vengono conservati per un massimo di 7 giorni.
Dettagli di richiesta e risposta #
Seleziona una richiesta per aprirne i dettagli.
| Parte | Scheda | Cosa mostra |
|---|---|---|
| Richiesta | Riepilogo | ID della richiesta, IP della richiesta, metodo, host, percorso, URL completo, timestamp, lunghezza dell'URL e numero di header. |
| Richiesta | Header | Ogni header della richiesta con il suo valore. |
| Richiesta | Body | Il body della richiesta. Il JSON è formattato per essere leggibile. Copia lo copia. |
| Richiesta | Info IP | Fuso orario, continente, paese, città, codice postale, regione e coordinate dell'indirizzo IP del visitatore. |
| Risposta | Riepilogo | ID della risposta, stato, tempo di risposta e numero di header. |
| Risposta | Header, Body | Ciò che il tuo servizio ha restituito. |
Ripetere una richiesta #
Ripetere una richiesta ti evita di far scattare di nuovo lo stesso webhook presso il mittente.
- Ripeti invia di nuovo la richiesta selezionata a partire dalla sua registrazione. La pagina mostra "Richiesta ripetuta con successo." non appena la ripetizione è stata richiesta; non attende il risultato.
- Modifica apre Modifica richiesta, dove puoi cambiare il metodo (GET, POST, PUT, DELETE o PATCH), il Percorso, gli header (Aggiungi header) e il Body prima di selezionare Ripeti.
La richiesta ripetuta viene inviata dall'app Localtonet sul dispositivo del tunnel, quindi l'app deve essere connessa.
Disattivare e attivare la registrazione delle richieste #
Le richieste vengono acquisite solo mentre la registrazione è attiva, e un tunnel parte con la registrazione disattivata. Finché è disattivata, la pagina mostra "La registrazione delle richieste è disattivata: le nuove richieste non verranno acquisite." con il pulsante Attiva registrazione. Disattiva registrazione interrompe di nuovo l'acquisizione di nuove richieste. Disattiva la registrazione per un tunnel che trasporta dati che non vuoi salvare, come password o dati personali nei body delle richieste. La modifica viene scritta nel Registro attività come "Impostazione del webhook HTTP modificata."
Registro delle connessioni per gli altri tunnel #
Sui tunnel TCP - UDP, TLS, File server e Server proxy, Registro richieste › Mostra apre la finestra Registro richieste. Elenca le connessioni fatte verso il tunnel, le più recenti per prime, 30 per pagina.
| Colonna | Cosa mostra |
|---|---|
| IP del visitatore | L'indirizzo che si è connesso al tunnel. |
| IP del client | L'indirizzo del client registrato per la connessione. |
| Destinazione | Dove è andata la connessione. Per un tunnel proxy sono l'host e la porta visitati. |
| Data | Quando è avvenuta, nel fuso orario del tuo account. |
Questo registro contiene solo i metadati delle connessioni. Non contiene ciò che è stato inviato attraverso la connessione.
Scarica il registro come CSV #
Sotto Scarica come CSV, scegli un intervallo di date fino a 30 giorni e seleziona Scarica. Il nome del file inizia con RequestLogs-, seguito dall'identificatore interno del tunnel, e termina con .csv. Ha le colonne Data e ora, IP richiesta, IP del client, Destinazione, Token e Protocollo. Per un periodo più lungo, scarica più intervalli uno dopo l'altro. I download sono limitati a uno al minuto, quindi attendi un minuto tra l'uno e l'altro.
Registro attività #
Registro attività › Mostra elenca cosa è successo al tunnel stesso, le voci più recenti per prime. Ogni voce ha data e ora nel fuso orario del tuo account, il canale da cui proviene l'azione e una frase che dice cosa è cambiato.
| Canale | L'azione proviene da |
|---|---|
| Web | La dashboard. |
| API | L'API. |
| CLI | La riga di comando. |
| Sistema | Localtonet stesso, per esempio quando è stato raggiunto un limite. |
Voci tipiche:
- Tunnel avviato.
- Tunnel arrestato.
- Porta locale cambiata da "3000" a "8080".
- Restrizione IP aggiunta: "203.0.113.10"
- Limite di banda cambiato: "10.00 GB"
- Data di scadenza disattivata.
Una password nuova o modificata non viene scritta nel registro. Compare come "Password impostata." o "Password cambiata."
Salute del tunnel #
Salute del tunnel › Mostra apre la finestra Controlli di salute. Localtonet controlla il tunnel ogni 10 minuti. Ogni quadrato è un controllo, per ora del giorno, relativo al giorno corrente.
| Valore | Significato |
|---|---|
| Integro | Il tunnel era connesso a quel controllo. |
| Non integro | Il tunnel non era connesso a quel controllo. |
| Sconosciuto | Non c'è alcun risultato per quell'ora né per nessuna ora precedente. |
| Nessun dato | L'ora non è ancora arrivata oggi. |
| Uptime | La quota di controlli integri tra quelli integri e non integri. |
Quando la finestra non ha quadrati da mostrare, dice "Nessun controllo registrato. I risultati compaiono qui dopo che il tunnel è rimasto in esecuzione per un po'."
Quando un tunnel si ferma #
Apri prima il Registro attività del tunnel. La voce "arrestato" più recente indica il motivo.
| Voce del Registro attività | Cosa è successo | Cosa fare |
|---|---|---|
| "Tunnel arrestato." | Qualcuno lo ha fermato. Il canale mostra da dove proviene l'azione, per esempio Web per la dashboard o API. | Seleziona Avvia. |
| "Tunnel arrestato perché è stato raggiunto il limite di banda del tunnel." | È stato raggiunto il Limite di banda del tunnel stesso. | Alza il limite o azzera il consumo. Vedi Limiti e scadenza. |
| "Tunnel arrestato perché è stata raggiunta la data di scadenza." | La Data di scadenza del tunnel è passata. | Imposta una data successiva o disattivala. Vedi Limiti e scadenza. |
| "Tunnel arrestato perché è stato raggiunto il limite di utilizzo gratuito." | È stato raggiunto il limite di sessione del Piano Gratuito. | Seleziona Avvia per iniziare un'altra sessione, oppure aggiungi Saldo. Vedi Piani e Saldo. |
| "Tunnel arrestato perché è stato superato il limite di banda totale." | La banda dell'account è esaurita. | Vedi Piani e Saldo. |
| "Tunnel arrestato perché era inattivo e senza connessioni." | Localtonet ha fermato un tunnel che era stato avviato ma non connesso. | Tieni l'app Localtonet connessa e seleziona Avvia quando ti serve di nuovo il tunnel. |
Se il registro non mostra alcun arresto ma l'indirizzo non risponde, controlla la colonna Connessione dell'elenco dei tunnel. OFF significa che il tunnel non è connesso: avvia l'app Localtonet sul dispositivo. Quando selezioni Avvia mentre l'app è offline, la dashboard apre una finestra con il titolo "NAME è offline" e il testo "In attesa della connessione dell'app…". Il tunnel parte da solo appena l'app si connette; Avvia comunque attiva subito il tunnel, che va online quando l'app si connette.
Fatti avvisare quando un tunnel va giù. La pagina Webhook della dashboard può inviare una richiesta POST JSON al tuo URL quando un tunnel si connette o si disconnette. Vedi Webhook.
Risoluzione dei problemi #
"Prima avvia il tuo tunnel."
Il pulsante dell'ispettore nell'elenco dei tunnel si apre solo per un tunnel in esecuzione. Avvia il tunnel, oppure apri l'ispettore con Registro richieste › Mostra nelle impostazioni del tunnel.
L'ispettore resta vuoto
Controlla tre cose: il banner "La registrazione delle richieste è disattivata" non è visibile; non c'è alcun filtro per data attivo (seleziona Vai live); e la richiesta raggiunge davvero l'indirizzo del tunnel, non un altro indirizzo del tuo servizio.
"Nessuna richiesta registrata." oppure "Dati non trovati!"
Il registro delle connessioni non ha voci per il tunnel, o non ne ha nell'intervallo di date scelto per il CSV. Scegli un altro intervallo.
"Nessun registro trovato per questo tunnel."
Il Registro attività non ha ancora voci. Si riempie man mano che il tunnel viene avviato, arrestato e modificato.