Logs e inspeção de requisições
Nesta página 8 seções
- O que está disponível e onde
- Inspetor de requisições para túneis HTTP
- Abra o inspetor
- A lista de requisições
- Detalhes da requisição e da resposta
- Reenviar uma requisição
- Desativar e ativar o registro de requisições
- Log de conexões para outros túneis
- Baixar o log como CSV
- Log de atividades
- Saúde do túnel
- Quando um túnel para
- Solução de problemas
- 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.
| Linha | O que abre | Tipos de túnel |
|---|---|---|
| Log de requisições | O inspetor de requisições, com as requisições e respostas registradas. | HTTP, Gateway MCP |
| Log de requisições | O log de conexões: quem se conectou, quando e para onde. | TCP - UDP, TLS, Servidor de arquivos, Servidor proxy |
| Log de atividades | Inícios, paradas e alterações de configuração do túnel. | Todos os tipos de túnel |
| Saúde do túnel | Os resultados das verificações de saúde regulares. | Todos os tipos de túnel, exceto Servidor de arquivos |
| Tráfego de banda | Os 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.
| Coluna | O que mostra |
|---|---|
| Método | O método HTTP, como GET ou POST. |
| Endpoint | O caminho que foi solicitado. |
| País, IP | De onde a requisição veio. |
| Data e hora | Quando chegou, no fuso horário do seu navegador. |
| Status | O código de status HTTP com o qual o seu serviço respondeu. |
| Duração | Quanto 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.
| Parte | Aba | O que mostra |
|---|---|---|
| Requisição | Resumo | ID 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ção | Cabeçalhos | Todos os cabeçalhos da requisição com seus valores. |
| Requisição | Corpo | O corpo da requisição. O JSON é formatado para leitura. Copiar o copia. |
| Requisição | Dados do IP | Fuso horário, continente, país, cidade, código postal, região e coordenadas do endereço IP do visitante. |
| Resposta | Resumo | ID da resposta, status, tempo de resposta e número de cabeçalhos. |
| Resposta | Cabeçalhos, Corpo | O 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.
| Coluna | O que mostra |
|---|---|
| IP do visitante | O endereço que se conectou ao túnel. |
| IP do cliente | O endereço do cliente registrado para a conexão. |
| Destino | Para onde a conexão foi. Em um túnel proxy, é o host e a porta visitados. |
| Data | Quando 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.
| Canal | A ação veio de |
|---|---|
| Web | O painel. |
| API | A API. |
| CLI | A linha de comando. |
| Sistema | O 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.
| Valor | Significado |
|---|---|
| Saudável | O túnel estava conectado nessa verificação. |
| Com falha | O túnel não estava conectado nessa verificação. |
| Desconhecido | Não há resultado para esse horário nem para nenhum horário anterior. |
| Sem dados | O horário ainda não chegou hoje. |
| Disponibilidade | A 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 atividades | O que aconteceu | O 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.