Streaming de registros de telemetría en tiempo real

Transmita los registros de acceso del proxy desde su servidor XProxy a Graylog o SigNoz en tiempo real: supervise varios dispositivos desde un único lugar, cree paneles y reciba alertas de errores.

¿Por qué utilizar la transmisión de registros centralizada?

Supervisión unificada — vigile el acceso y el estado de todos los nodos XProxy en tiempo real.
Consultas sencillas — filtre por dispositivo, región, acción o código de error.
Resolución de problemas más rápida — aísle rápidamente errores, picos de tráfico o comportamientos anómalos.

Configuración en: XProxy → Ajustes generales → Registros de telemetría. Proveedores compatibles: Graylog (GELF UDP) y SigNoz (OTLP/HTTP).

Etiquetado recomendado

Identificador de host — nombre por servidor; p. ej., sg-core-01, us-east-02.
Nombre del servicio — agrupe por región o unidad de negocio; p. ej., xproxy-region-a.

Cada registro incluye estas etiquetas, lo que facilita la creación de paneles y filtros entre dispositivos.

Opción A — Graylog

Instalar Graylog

Requisitos: Ubuntu Server 20.04 o 22.04, mínimo 2 GB de RAM (4 GB recomendados).

bash

curl x-proxy.io/graylog | bash

Crear una entrada GELF UDP

Abra Graylog → Sistema → Entradas.
Elija GELF UDP y haga clic en Iniciar nueva entrada.
Establezca la dirección de enlace en 0.0.0.0 y el puerto en 12201.
Haga clic en Guardar.

Configurar XProxy para Graylog

Abra Ajustes generales → Registros de telemetría.
Active Activar telemetría.
Establezca el proveedor en Graylog.
Introduzca el servidor Graylog como YOUR_GRAYLOG_IP:12201.
Establezca Identificador de host y Nombre del servicio (opcional, pero recomendado).
Haga clic en Guardar y, a continuación, en Probar conexión.

Formulario de configuración de XProxy para Graylog

Ejemplos de consulta en Graylog

graylog query

# By service/cluster
service_name:xproxy-region-a

# Only errors
error_code:!00000

# By action
action:CONNECT

# By device/slot
modem_position:3

Opción B — SigNoz

Instalar SigNoz (Comunidad)

Requisitos: Ubuntu Server 20.04, 22.04 o 24.04. Omítalo si utiliza SigNoz Cloud.

bash

curl x-proxy.io/signoz | bash

Configurar XProxy para SigNoz

Abra Ajustes generales → Registros de telemetría.
Active Activar telemetría y seleccione SigNoz como proveedor.
Introduzca el endpoint OTLP/HTTP; p. ej., https://ingest.us.signoz.cloud:4318.
Pegue su clave de ingestión (SigNoz Cloud) o déjelo en blanco para instalaciones locales.
Establezca el Nombre del servicio (p. ej., xproxy-region-a).
Haga clic en Guardar y, a continuación, en Probar conexión.

Formulario de configuración de XProxy para SigNoz

Ejemplos de consulta en SigNoz

signoz query

# By service name
service.name = "xproxy-region-a"

# Only errors
attributes.error_code != "00000"

# By action
attributes.action = "CONNECT"

# By device/slot
attributes.modem_position = 3

Referencia de campos de registro

Campo	Descripción
`log_date`	Fecha del registro (DD/MM)
`log_time`	Hora del registro (HH:MM:SS)
`proxy_service`	Nombre del grupo de servicio (p. ej., MAIN)
`modem_position`	Índice de dispositivo/ranura que atiende la solicitud
`proxy_protocol`	HTTP o SOCKS5
`proxy_port`	Puerto de escucha del proxy en XProxy
`proxy_user`	Nombre de usuario utilizado para autenticarse (vacío si se usa lista blanca de IP)
`client_ip`	IP del cliente que usa el proxy
`destination_host`	Host de destino solicitado a través del proxy
`destination_port`	Puerto de destino
`action`	CONNECT (túnel) o ACCESS (solicitud HTTP)
`error_code`	00000 = correcto; distinto de cero = error
`received_bytes`	Bytes del destino al cliente
`sent_bytes`	Bytes del cliente al destino

Referencia de códigos de error

00000 — Correcto (conexión cerrada con normalidad)
00001–00009 — Errores de autenticación (ACL/nombre de usuario/contraseña)
00010 — Límite de tráfico superado
00011–00019 — Errores de conexión (socket/bind/connect)
00020–00029 — Errores internos (p. ej., asignación de memoria)
00030–00039 — Errores de redirección del proxy HTTP CONNECT
00050–00069 — Errores de redirección del proxy SOCKS5
00090–00099 — Tiempos de espera de conexión / problemas de red
00100 — Host no encontrado
00200–00299 — Errores del portmapper UDP
00300–00399 — Errores del portmapper TCP
00400–00499 — Errores del proxy SOCKS
00500–00599 — Errores del proxy HTTP

Resolución de problemas

Sin datos — asegúrese de que la telemetría esté activada y de haber hecho clic en Guardar. Genere tráfico a través de cualquier puerto del proxy.
Graylog — confirme que la entrada GELF UDP se esté ejecutando en el puerto 12201 y que el cortafuegos permita UDP 12201.
SigNoz — el endpoint debe incluir el puerto 4318 y ser accesible mediante HTTPS. Verifique la clave de ingestión y la región del espacio de trabajo.

Was this page helpful?