Ir para o conteúdo
Localtonet Localtonet Painel

Logs e inspeção de requisições

Ajuda com esta página
Nesta página 8 seções
  1. O que está disponível e onde
  2. Inspetor de requisições para túneis HTTP
  3. Abra o inspetor
  4. A lista de requisições
  5. Detalhes da requisição e da resposta
  6. Reenviar uma requisição
  7. Desativar e ativar o registro de requisições
  8. Log de conexões para outros túneis
  9. Baixar o log como CSV
  10. Log de atividades
  11. Saúde do túnel
  12. Quando um túnel para
  13. Solução de problemas
  14. Páginas relacionadas

Veja o que acontece em um túnel: inspecione e reenvie as requisições HTTP que ele recebe, liste as conexões feitas a ele, leia o log de inícios, paradas e alterações de configuração e verifique a saúde dele ao longo do dia. Esta página também mostra onde procurar quando um túnel parou.

O que está disponível e onde #

Tudo isso são linhas do painel de configurações do túnel: abra a página do tipo de túnel em Meus túneis e selecione Configurações na linha do túnel.

LinhaO que abreTipos de túnel
Log de requisiçõesO inspetor de requisições, com as requisições e respostas registradas.HTTP, Gateway MCP
Log de requisiçõesO log de conexões: quem se conectou, quando e para onde.TCP - UDP, TLS, Servidor de arquivos, Servidor proxy
Log de atividadesInícios, paradas e alterações de configuração do túnel.Todos os tipos de túnel
Saúde do túnelOs resultados das verificações de saúde regulares.Todos os tipos de túnel, exceto Servidor de arquivos
Tráfego de bandaOs dados que passaram pelo túnel. Veja Limites e expiração.Todos os tipos de túnel

Um Proxy rotativo mantém os logs de requisições por cliente: use o botão Logs de requisições de um cliente. Veja Proxy rotativo.

Inspetor de requisições para túneis HTTP #

O inspetor mostra as requisições HTTP que chegam a um túnel HTTP ou Gateway MCP, com seus cabeçalhos e corpos e as respostas que o seu serviço deu. Use-o para depurar webhooks e chamadas de API sem adicionar registro ao seu próprio código. As requisições só são registradas depois que você ativa o registro, como descrito abaixo.

O registro não é uma cópia byte a byte. Um corpo é armazenado até 16 KB, e apenas para formatos de texto como JSON, XML, HTML, texto simples e dados de formulário codificados em URL. Os valores de cabeçalhos sensíveis, como Authorization, Cookie e X-Api-Key, são armazenados como [MASKED].

Abra o inspetor #

  • Nas configurações do túnel, selecione Log de requisições › Mostrar, ou
  • na lista de túneis, selecione o botão com a dica Ver logs de requisição e resposta. Se o túnel estiver parado, esse botão pede que você o inicie primeiro. Para túneis cuja coluna Servidor mostra Local ou VPN, ele fica desativado, com a dica "Não disponível para Client Relay".

A página Inspetor abre em uma nova aba.

A lista de requisições #

O cartão Requisições HTTP lista as requisições, da mais recente para a mais antiga, e carrega mais à medida que você rola. Enquanto o selo mostra No ar, a lista é atualizada a cada 3 segundos.

ColunaO que mostra
MétodoO método HTTP, como GET ou POST.
EndpointO caminho que foi solicitado.
País, IPDe onde a requisição veio.
Data e horaQuando chegou, no fuso horário do seu navegador.
StatusO código de status HTTP com o qual o seu serviço respondeu.
DuraçãoQuanto tempo a resposta levou, em segundos.

Sem filtro, a lista cobre as últimas 24 horas. Filtrar por data oferece Hoje, Ontem, Últimos 7 dias e Período personalizado, e cobre hoje e os seis dias anteriores. Um filtro de data pausa a lista ao vivo; selecione Ao vivo para voltar a ela. Os logs de inspeção são mantidos por até 7 dias.

Detalhes da requisição e da resposta #

Selecione uma requisição para abrir os detalhes dela.

ParteAbaO que mostra
RequisiçãoResumoID da requisição, IP da requisição, método, host, caminho, URL completa, carimbo de data e hora, tamanho da URL e número de cabeçalhos.
RequisiçãoCabeçalhosTodos os cabeçalhos da requisição com seus valores.
RequisiçãoCorpoO corpo da requisição. O JSON é formatado para leitura. Copiar o copia.
RequisiçãoDados do IPFuso horário, continente, país, cidade, código postal, região e coordenadas do endereço IP do visitante.
RespostaResumoID da resposta, status, tempo de resposta e número de cabeçalhos.
RespostaCabeçalhos, CorpoO que o seu serviço devolveu.

Reenviar uma requisição #

Reenviar evita que você precise disparar o mesmo webhook de novo no remetente.

  • Reenviar envia de novo a requisição selecionada a partir do registro dela. A página mostra "Requisição reenviada com sucesso." assim que o reenvio foi solicitado; ela não espera o resultado.
  • Modificar abre Modificar requisição, onde você pode alterar o método (GET, POST, PUT, DELETE ou PATCH), o Caminho, os cabeçalhos (Adicionar cabeçalho) e o Corpo antes de selecionar Reenviar.

O app Localtonet no dispositivo do túnel envia a requisição reenviada, então o app precisa estar conectado.

Desativar e ativar o registro de requisições #

As requisições só são capturadas enquanto o registro está ativado, e um túnel começa com o registro desativado. Enquanto ele está desativado, a página mostra "O registro de requisições está desativado - novas requisições não serão capturadas." com o botão Ativar registro. Desativar registro volta a parar a captura de novas requisições. Desative o registro em um túnel que carrega dados que você não quer armazenar, como senhas ou dados pessoais nos corpos das requisições. A alteração é gravada no Log de atividades como "Configuração do webhook HTTP alterada."

Log de conexões para outros túneis #

Em túneis TCP - UDP, TLS, Servidor de arquivos e Servidor proxy, Log de requisições › Mostrar abre a caixa de diálogo Log de requisições. Ela lista as conexões feitas ao túnel, da mais recente para a mais antiga, 30 por página.

ColunaO que mostra
IP do visitanteO endereço que se conectou ao túnel.
IP do clienteO endereço do cliente registrado para a conexão.
DestinoPara onde a conexão foi. Em um túnel proxy, é o host e a porta visitados.
DataQuando aconteceu, no fuso horário da sua conta.

Este log guarda apenas metadados da conexão. Ele não contém o que foi enviado pela conexão.

Baixar o log como CSV #

Em Baixar como CSV, escolha um período de até 30 dias e selecione Baixar. O nome do arquivo começa com RequestLogs-, seguido do identificador interno do túnel, e termina com .csv. Ele tem as colunas Data e hora, IP da requisição, IP do cliente, Destino, Token e Protocolo. Para um período maior, baixe vários intervalos, um após o outro. Os downloads são limitados a um por minuto, então espere um minuto entre dois deles.

Log de atividades #

Log de atividades › Mostrar lista o que aconteceu com o próprio túnel, da mais recente para a mais antiga. Cada entrada tem a data e a hora no fuso horário da sua conta, o canal de onde a ação veio e uma frase que diz o que mudou.

CanalA ação veio de
WebO painel.
APIA API.
CLIA linha de comando.
SistemaO próprio Localtonet, por exemplo quando um limite foi atingido.

Entradas típicas:

  • Túnel iniciado.
  • Túnel parado.
  • Porta local alterada de "3000" para "8080".
  • Restrição de IP adicionada: "203.0.113.10"
  • Limite de banda alterado: "10.00 GB"
  • Data de expiração desativada.

Uma senha nova ou alterada não é gravada no log. Ela aparece como "Senha definida." ou "Senha alterada."

Saúde do túnel #

Saúde do túnel › Mostrar abre a caixa de diálogo Verificações de saúde. O Localtonet verifica o túnel a cada 10 minutos. Cada quadrado é uma verificação, por hora do dia, do dia atual.

ValorSignificado
SaudávelO túnel estava conectado nessa verificação.
Com falhaO túnel não estava conectado nessa verificação.
DesconhecidoNão há resultado para esse horário nem para nenhum horário anterior.
Sem dadosO horário ainda não chegou hoje.
DisponibilidadeA proporção de verificações saudáveis entre as saudáveis e as com falha.

Quando a caixa de diálogo não tem quadrados para mostrar, ela diz "Nenhuma verificação registrada ainda. Os resultados aparecem aqui depois que o túnel estiver rodando por um tempo."

Quando um túnel para #

Abra primeiro o Log de atividades do túnel. A entrada "parado" mais recente informa o motivo.

Entrada do Log de atividadesO que aconteceuO que fazer
"Túnel parado."Alguém o parou. O canal mostra de onde a ação veio, por exemplo Web para o painel ou API.Selecione Iniciar.
"Túnel parado porque o limite de banda do túnel foi atingido."O Limite de banda do próprio túnel foi atingido.Aumente o limite ou zere o uso. Veja Limites e expiração.
"Túnel parado porque a data de expiração foi atingida."A Data de expiração do túnel passou.Defina uma data posterior ou desative-a. Veja Limites e expiração.
"Túnel parado porque o limite de uso gratuito foi atingido."O limite de sessão do plano Gratuito foi atingido.Selecione Iniciar para começar outra sessão ou adicione saldo. Veja Planos e saldo.
"Túnel parado porque o limite total de banda foi excedido."A banda da conta foi totalmente usada.Veja Planos e saldo.
"Túnel parado porque estava inativo e sem conexões."O Localtonet parou um túnel que foi iniciado, mas não estava conectado.Mantenha o app Localtonet conectado e selecione Iniciar quando precisar do túnel de novo.

Se o log não mostra nenhuma parada, mas o endereço não responde, verifique a coluna Conexão da lista de túneis. DESL significa que o túnel não está conectado: inicie o app Localtonet no dispositivo. Quando você seleciona Iniciar com o app offline, o painel abre uma caixa de diálogo com o título "NAME está offline" e o texto "Aguardando o app se conectar…". O túnel inicia sozinho assim que o app se conecta; Iniciar mesmo assim liga o túnel agora, e ele fica no ar quando o app se conecta.

Seja avisado quando um túnel cair. A página Webhooks do painel pode enviar uma requisição POST em JSON para a sua URL quando um túnel se conecta ou se desconecta. Veja Webhooks.

Solução de problemas #

"Inicie seu túnel primeiro."

O botão do inspetor na lista de túneis só abre para um túnel em execução. Inicie o túnel ou abra o inspetor com Log de requisições › Mostrar nas configurações do túnel.

O inspetor continua vazio

Verifique três coisas: o aviso "O registro de requisições está desativado" não aparece; nenhum filtro de data está ativo (selecione Ao vivo); e a requisição realmente chega ao endereço do túnel, e não a outro endereço do seu serviço.

"Nenhuma requisição registrada ainda." ou "Dados não encontrados!"

O log de conexões não tem entradas para o túnel, ou nenhuma no período que você escolheu para o CSV. Escolha outro período.

"Nenhum log encontrado para este túnel."

O Log de atividades ainda não tem entradas. Ele se enche à medida que o túnel é iniciado, parado e alterado.

Suporte