Streaming de logs de telemetria em tempo real

Transmita os logs de acesso do proxy do seu servidor XProxy para o Graylog ou SigNoz em tempo real — monitore vários dispositivos em um só lugar, crie dashboards e receba alertas de erros.

Por que usar streaming centralizado de logs?

Monitoramento unificado — acompanhe o acesso e a integridade de todos os nós do XProxy em tempo real.
Consultas fáceis — filtre por dispositivo, região, ação ou código de erro.
Solução de problemas mais rápida — isole rapidamente erros, picos de tráfego ou comportamentos anormais.

Configure em: XProxy → Configurações Gerais → Logs de Telemetria. Provedores compatíveis: Graylog (GELF UDP) e SigNoz (OTLP/HTTP).

Rotulagem recomendada

Identificador de Host — nome por servidor, ex.: sg-core-01, us-east-02.
Nome do Serviço — agrupe por região ou unidade de negócio, ex.: xproxy-region-a.

Cada log carrega esses rótulos, facilitando a criação de dashboards e filtros entre dispositivos.

Opção A — Graylog

Instalar o Graylog

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

bash

curl x-proxy.io/graylog | bash

Criar uma entrada GELF UDP

Abra Graylog → Sistema → Entradas.
Escolha GELF UDP e clique em Iniciar nova entrada.
Defina o Endereço de bind como 0.0.0.0 e a Porta como 12201.
Clique em Salvar.

Configurar o XProxy para o Graylog

Abra Configurações Gerais → Logs de Telemetria.
Ative a opção Habilitar Telemetria.
Defina o Provedor como Graylog.
Informe o Servidor Graylog como YOUR_GRAYLOG_IP:12201.
Defina o Identificador de Host e o Nome do Serviço (opcional, mas recomendado).
Clique em Salvar e depois em Testar Conexão.

Formulário de configuração do Graylog no XProxy

Exemplos de consulta no 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

Opção B — SigNoz

Instalar o SigNoz (Community)

Requisitos: Ubuntu Server 20.04, 22.04 ou 24.04. Pule esta etapa se estiver usando o SigNoz Cloud.

bash

curl x-proxy.io/signoz | bash

Configurar o XProxy para o SigNoz

Abra Configurações Gerais → Logs de Telemetria.
Ative Habilitar Telemetria e selecione SigNoz como Provedor.
Informe o Endpoint OTLP/HTTP, por exemplo https://ingest.us.signoz.cloud:4318.
Cole a sua Chave de Ingestão (SigNoz Cloud) ou deixe em branco em instalações locais.
Defina o Nome do Serviço (ex.: xproxy-region-a).
Clique em Salvar e depois em Testar Conexão.

Formulário de configuração do SigNoz no XProxy

Exemplos de consulta no 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

Referência de campos de log

Campo	Descrição
`log_date`	Data do log (DD/MM)
`log_time`	Hora do log (HH:MM:SS)
`proxy_service`	Nome do grupo de serviço (ex.: MAIN)
`modem_position`	Índice do dispositivo/slot que atende à solicitação
`proxy_protocol`	HTTP ou SOCKS5
`proxy_port`	Porta de escuta do proxy no XProxy
`proxy_user`	Nome de usuário usado para autenticação (vazio na whitelist de IP)
`client_ip`	IP do cliente que usa o proxy
`destination_host`	Host de destino solicitado via proxy
`destination_port`	Porta de destino
`action`	CONNECT (túnel) ou ACCESS (requisição HTTP)
`error_code`	00000 = sucesso; diferente de zero = erro
`received_bytes`	Bytes do destino para o cliente
`sent_bytes`	Bytes do cliente para o destino

Referência de códigos de erro

00000 — Sucesso (conexão encerrada normalmente)
00001–00009 — Erros de autenticação (ACL/nome de usuário/senha)
00010 — Limite de tráfego excedido
00011–00019 — Erros de conexão (socket/bind/connect)
00020–00029 — Erros internos (ex.: alocação de memória)
00030–00039 — Erros de redirecionamento do proxy HTTP CONNECT
00050–00069 — Erros de redirecionamento do proxy SOCKS5
00090–00099 — Timeouts de conexão / problemas de rede
00100 — Host não encontrado
00200–00299 — Erros do portmapper UDP
00300–00399 — Erros do portmapper TCP
00400–00499 — Erros do proxy SOCKS
00500–00599 — Erros do proxy HTTP

Solução de problemas

Sem dados — verifique se a telemetria está habilitada e se você clicou em Salvar. Gere tráfego por qualquer porta de proxy.
Graylog — confirme se a entrada GELF UDP está em execução na porta 12201 e se o firewall permite UDP 12201.
SigNoz — o endpoint deve incluir a porta 4318 e ser acessível via HTTPS. Verifique a chave de ingestão e a região do workspace.

Was this page helpful?