Saltar al contenido
Localtonet Localtonet Panel

Registros e inspección de solicitudes

Ayuda con esta página
En esta página 8 secciones
  1. Qué hay disponible y dónde
  2. Inspector de solicitudes para túneles HTTP
  3. Abre el inspector
  4. La lista de solicitudes
  5. Detalles de la solicitud y la respuesta
  6. Reproducir una solicitud
  7. Desactivar y activar el registro de solicitudes
  8. Registro de conexiones de otros túneles
  9. Descargar el registro como CSV
  10. Registro de actividad
  11. Salud del túnel
  12. Cuando un túnel se detiene
  13. Solución de problemas
  14. Páginas relacionadas

Mira qué ocurre en un túnel: inspecciona y reproduce las solicitudes HTTP que recibe, consulta las conexiones realizadas hacia él, lee el registro de inicios, paradas y cambios de configuración, y comprueba su estado de salud a lo largo del día. Esta página también indica dónde mirar cuando un túnel se ha detenido.

Qué hay disponible y dónde #

Todo esto son filas del panel de configuración del túnel: abre la página del tipo de túnel en Mis túneles y selecciona Configuración en la fila del túnel.

FilaQué abreTipos de túnel
Registro de solicitudesEl inspector de solicitudes, con las solicitudes y respuestas registradas.HTTP, Gateway MCP
Registro de solicitudesEl registro de conexiones: quién se conectó, cuándo y hacia dónde.TCP - UDP, TLS, Servidor de archivos, Servidor proxy
Registro de actividadInicios, paradas y cambios de configuración del túnel.Todos los tipos de túnel
Salud del túnelLos resultados de las comprobaciones de salud periódicas.Todos los tipos de túnel excepto Servidor de archivos
Tráfico de ancho de bandaLos datos que han pasado por el túnel. Consulta Límites y caducidad.Todos los tipos de túnel

Un Proxy rotativo guarda sus registros de solicitudes por cliente: usa el botón Registros de solicitudes de un cliente. Consulta Proxy rotativo.

Inspector de solicitudes para túneles HTTP #

El inspector muestra las solicitudes HTTP que llegan a un túnel HTTP o de Gateway MCP, con sus encabezados y cuerpos y las respuestas que dio tu servicio. Úsalo para depurar webhooks y llamadas a la API sin añadir registros a tu propio código. Las solicitudes solo se registran después de activar el registro, como se describe más abajo.

El registro no es una copia byte a byte. Un cuerpo se guarda hasta 16 KB, y solo para formatos de texto como JSON, XML, HTML, texto sin formato y datos de formulario codificados en URL. Los valores de los encabezados sensibles, como Authorization, Cookie y X-Api-Key, se guardan como [MASKED].

Abre el inspector #

  • En la configuración del túnel, selecciona Registro de solicitudes › Mostrar, o
  • en la lista de túneles, selecciona el botón con la descripción emergente Ver registros de solicitudes y respuestas. Este botón te pide que inicies primero el túnel si está detenido. En los túneles cuya columna Servidor muestra Local o VPN está desactivado, con la descripción emergente "No disponible para Client Relay".

La página Inspector se abre en una pestaña nueva.

La lista de solicitudes #

La tarjeta Solicitudes HTTP muestra las solicitudes, las más recientes primero, y carga más al desplazarte. Mientras la insignia muestra En vivo, la lista se actualiza cada 3 segundos.

ColumnaQué muestra
MétodoEl método HTTP, como GET o POST.
EndpointLa ruta que se solicitó.
País, IPDe dónde procedía la solicitud.
Fecha y horaCuándo llegó, en la hora de tu navegador.
EstadoEl código de estado HTTP con el que respondió tu servicio.
DuraciónCuánto tardó la respuesta, en segundos.

Sin filtro, la lista abarca las últimas 24 horas. Filtrar por fecha ofrece Hoy, Ayer, Últimos 7 días y Rango personalizado, y cubre hoy y los seis días anteriores. Un filtro de fecha pausa la lista en vivo; selecciona Ver en vivo para volver a ella. Los registros de inspección se conservan hasta 7 días.

Detalles de la solicitud y la respuesta #

Selecciona una solicitud para abrir sus detalles.

PartePestañaQué muestra
SolicitudResumenID de la solicitud, IP de la solicitud, método, host, ruta, URL completa, marca de tiempo, longitud de la URL y número de encabezados.
SolicitudEncabezadosTodos los encabezados de la solicitud con su valor.
SolicitudCuerpoEl cuerpo de la solicitud. El JSON se formatea para facilitar la lectura. Copiar lo copia.
SolicitudInfo de IPZona horaria, continente, país, ciudad, código postal, región y coordenadas de la dirección IP del visitante.
RespuestaResumenID de la respuesta, estado, tiempo de respuesta y número de encabezados.
RespuestaEncabezados, CuerpoLo que devolvió tu servicio.

Reproducir una solicitud #

Reproducir te ahorra tener que volver a activar el mismo webhook en el emisor.

  • Reproducir envía de nuevo la solicitud seleccionada a partir de su registro. La página muestra "Solicitud reproducida correctamente." en cuanto se ha solicitado la reproducción; no espera el resultado.
  • Modificar abre Modificar solicitud, donde puedes cambiar el método (GET, POST, PUT, DELETE o PATCH), la Ruta, los encabezados (Añadir encabezado) y el Cuerpo antes de seleccionar Reproducir.

La app de Localtonet del dispositivo del túnel envía la solicitud reproducida, así que la app debe estar conectada.

Desactivar y activar el registro de solicitudes #

Las solicitudes solo se capturan mientras el registro está activado, y un túnel empieza con el registro desactivado. Mientras está desactivado, la página muestra "El registro de solicitudes está desactivado: no se capturarán nuevas solicitudes." con el botón Activar registro. Desactivar registro vuelve a dejar de capturar solicitudes nuevas. Desactiva el registro en un túnel que transporte datos que no quieres que se almacenen, como contraseñas o datos personales en los cuerpos de las solicitudes. El cambio se escribe en el Registro de actividad como "Ajuste del webhook HTTP cambiado."

Registro de conexiones de otros túneles #

En los túneles TCP - UDP, TLS, Servidor de archivos y Servidor proxy, Registro de solicitudes › Mostrar abre el cuadro de diálogo Registro de solicitudes. Muestra las conexiones realizadas hacia el túnel, las más recientes primero, 30 por página.

ColumnaQué muestra
IP del visitanteLa dirección que se conectó al túnel.
IP del clienteLa dirección del cliente registrada para la conexión.
DestinoAdónde fue la conexión. En un túnel de proxy es el host y el puerto visitados.
FechaCuándo ocurrió, en la zona horaria de tu cuenta.

Este registro contiene solo metadatos de la conexión. No incluye lo que se envió por ella.

Descargar el registro como CSV #

En Descargar como CSV, elige un rango de fechas de hasta 30 días y selecciona Descargar. El nombre del archivo empieza por RequestLogs-, seguido del identificador interno del túnel, y termina en .csv. Tiene las columnas Fecha y hora, IP de la solicitud, IP del cliente, Destino, Token y Protocolo. Para un periodo más largo, descarga varios rangos uno tras otro. Las descargas están limitadas a una por minuto, así que espera un minuto entre dos de ellas.

Registro de actividad #

Registro de actividad › Mostrar muestra lo que ha ocurrido en el propio túnel, lo más reciente primero. Cada entrada tiene la fecha y la hora en la zona horaria de tu cuenta, el canal del que procedía la acción y una frase que indica qué cambió.

CanalLa acción procedía de
WebEl panel.
APILa API.
CLILa línea de comandos.
SistemaEl propio Localtonet, por ejemplo cuando se alcanzó un límite.

Entradas típicas:

  • Túnel iniciado.
  • Túnel detenido.
  • Puerto local cambiado de "3000" a "8080".
  • Restricción de IP añadida: "203.0.113.10"
  • Límite de ancho de banda cambiado: "10.00 GB"
  • Fecha de caducidad desactivada.

Una contraseña nueva o modificada no se escribe en el registro. Aparece como "Contraseña establecida." o "Contraseña cambiada."

Salud del túnel #

Salud del túnel › Mostrar abre el cuadro de diálogo Comprobaciones de salud. Localtonet comprueba el túnel cada 10 minutos. Cada cuadrado es una comprobación, por hora del día, del día actual.

ValorSignificado
CorrectoEl túnel estaba conectado en esa comprobación.
Con fallosEl túnel no estaba conectado en esa comprobación.
DesconocidoNo hay resultado para esa hora ni para ninguna anterior.
Sin datosEsa hora aún no ha llegado hoy.
DisponibilidadLa proporción de comprobaciones correctas entre las correctas y las que fallaron.

Cuando el cuadro de diálogo no tiene cuadrados que mostrar, indica "Aún no hay comprobaciones registradas. Los resultados aparecerán aquí cuando el túnel lleve un tiempo en ejecución."

Cuando un túnel se detiene #

Abre primero el Registro de actividad del túnel. La entrada "detenido" más reciente indica el motivo.

Entrada del Registro de actividadQué ocurrióQué hacer
"Túnel detenido."Alguien lo detuvo. El canal indica de dónde procedía la acción, por ejemplo Web para el panel o API.Selecciona Iniciar.
"Túnel detenido porque se alcanzó el límite de ancho de banda del túnel."Se alcanzó el Límite de ancho de banda propio del túnel.Sube el límite o restablece el uso. Consulta Límites y caducidad.
"Túnel detenido porque llegó su fecha de caducidad."Pasó la Fecha de caducidad del túnel.Fija una fecha posterior o desactívala. Consulta Límites y caducidad.
"Túnel detenido porque se alcanzó el límite de uso gratuito."Se alcanzó el límite de sesión del plan Gratis.Selecciona Iniciar para empezar otra sesión, o añade Saldo. Consulta Planes y saldo.
"Túnel detenido porque se superó el límite total de ancho de banda."Se ha agotado el ancho de banda de la cuenta.Consulta Planes y saldo.
"Túnel detenido porque estaba inactivo y no tenía conexiones."Localtonet detuvo un túnel que se había iniciado pero no estaba conectado.Mantén la app de Localtonet conectada y selecciona Iniciar cuando necesites el túnel de nuevo.

Si el registro no muestra ninguna parada pero la dirección no responde, revisa la columna Conexión de la lista de túneles. NO significa que el túnel no está conectado: inicia la app de Localtonet en el dispositivo. Cuando seleccionas Iniciar con la app sin conexión, el panel abre un cuadro de diálogo titulado "NAME está desconectado" con el texto "Esperando a que se conecte la app…". El túnel se inicia solo en cuanto la app se conecta; Iniciar de todos modos activa el túnel ahora y se pone en marcha cuando la app se conecta.

Entérate cuando un túnel se caiga. La página Webhooks del panel puede enviar una solicitud POST con JSON a tu URL cuando un túnel se conecta o se desconecta. Consulta Webhooks.

Solución de problemas #

"Primero inicia tu túnel."

El botón del inspector de la lista de túneles solo se abre para un túnel en ejecución. Inicia el túnel, o abre el inspector con Registro de solicitudes › Mostrar en la configuración del túnel.

El inspector sigue vacío

Comprueba tres cosas: que no se muestre el aviso "El registro de solicitudes está desactivado"; que no haya ningún filtro de fecha activo (selecciona Ver en vivo); y que la solicitud realmente llegue a la dirección del túnel, no a otra dirección de tu servicio.

"Aún no hay solicitudes registradas." o "¡No se encontraron datos!"

El registro de conexiones no tiene entradas para el túnel, o ninguna en el rango de fechas que elegiste para el CSV. Elige otro rango.

"No se encontraron registros para este túnel."

El Registro de actividad todavía no tiene entradas. Se va llenando a medida que el túnel se inicia, se detiene y se modifica.

Soporte