Monitorização E ALERTA
ExperimentalPRTG Network Monitor
Notificações por SMS.
Adicione um caminho de SMS aos alertas de sensor que sua equipa já usa. Comece com um protótipo revisável e uma ponte externa para a API FoxBox HTTP.
COMO SE CONECTA
01 / CASO DE USO
Uma notificação útil,
de um evento existente.
Um sensor muda de estado. Um modelo de notificação PRTG passa um evento controlado para a ponte para formatação de SMS.
A integração adiciona um caminho de notificação por SMS separado. Ele não estabelece a disponibilidade do serviço nem substitui o processo existente de resposta a incidentes e escalonamento.
02 / REQUISITOS
Antes de começar.
- Modelo de notificação HTTP PRTG; versão instalada para validar
- Um host separado para a ponte de integração. Nada está instalado no firmware do FoxBox.
- Python 3 para a ponte e um ambiente isolado para o primeiro teste.
- Uma interface HTTP FoxBox compatível com o documentado
app=ws,op=pvpedido. A versão do dispositivo e do firmware deve ser confirmada. - Para qualquer teste ao vivo posterior: um destinatário aprovado, credenciais corretas e uma rota de SMS validada. As rotas SIM requerem cobertura; serviços externos requerem acesso à Internet e configuração do fornecedor.
Nenhuma versão física do firmware FoxBox ou instância alvo do PRTG Network Monitor foi verificada de ponta a ponta para este protótipo.
Qual FoxBox se enquadra nessa integração?
Escolha o formato, número de modems e rede que Precisa. Mantenha o PRTG Network Monitor como contexto do projeto.
Encontre a FoxBox certa para esta integração →03 / INSTALAÇÃO
Comece isoladamente.
Prepare a ponte.
Descarregue o pacote de origem. Siga seu README raiz para configurar a ponte externa no modo de simulação, usando espaços reservados e um destino de teste local.
Etapa 2
Crie um modelo de notificação Executar ação HTTP no PRTG.
Etapa 3
Mapeie a URL fornecida e o modelo de corpo para o terminal da ponte.
Etapa 4
Atribua o modelo a um gatilho de notificação do sensor de teste e inspecione a resposta de simulação.
04 / REVER O CÓDIGO
Nada escondido
por trás do exemplo.
Os ficheiros abaixo vêm do pacote de origem de integração para download. Revise a ponte completa e o guia de integração antes de usar o exemplo.
Loading source…05 / VALIDAR O CAMINHO
Teste o exemplo.
Em seguida, teste a implementação.
Execute o conjunto isolado do repositório a partir do diretório do repositório extraído. Seu transporte simulado não envia SMS nem comprova entrega de móvel.
python3 -m unittest discover -s tests -vVerifique a carga útil esperada, o comportamento de validação, o tratamento duplicado e as respostas de erro. O laboratório abaixo ilustra o fluxo localmente no seu navegador.
A expansão do espaço reservado do PRTG e o comportamento da autenticação HTTP requerem validação na versão alvo do PRTG. Um teste simulado bem-sucedido não é evidência de que um SMS chegou.
06 / RESOLUÇÃO DE PROBLEMAS
Torne as falhas visíveis.
A ponte rejeita a carga útil.
Verifique o mapeamento do campo de integração em relação à configuração fornecida. Use os exemplos sintéticos primeiro. Não copie o conteúdo ou as credenciais do evento de produção nos logs de suporte.
A pedido expira.
Confirme a acessibilidade, o TLS e o formato de pedido esperado. Não reenvie automaticamente uma pedido SMS ambígua: a primeira pedido pode já ter sido aceita.
A API aceitou a pedido, mas nenhum SMS chegou.
A aceitação da pedido não é uma confirmação de entrega. Verifique o status documentado da mensagem FoxBox e as condições da rede móvel no dispositivo real; o protótipo não pode confirmar a entrega.
Um evento duplicado é enviado.
Revise as configurações de chave de evento de ponte e de desduplicação. Valide eventos agrupados e de recuperação no software de destino antes de ativar notificações em tempo real.
DA INTEGRAÇÃO AO HARDWARE
Escolha o formato.
Valide o ajuste.
Comece com S1 para um modem, S2 para dois ou SR para implementação em rack. A integração por si só não determina a capacidade do modem ou os requisitos de resiliência.
FoxBox S2 · aparelho compacto com dois modemsConfiguração e validação
Configuração técnica: PRTG
Ligação através de uma ponte externa
Em um modelo de notificação, habilite Executar ação HTTP e selecione POST. Envie os campos do formulário abaixo para a ponte PRTG externa. Use um modelo Down e um modelo Up separado e anexe-os aos acionadores de notificação de sensor apropriados. Armazene a credencial na configuração de notificação privada.
Essa configuração passa deliberadamente um ID de sensor numérico e um estado fixo, em vez de espaços reservados de texto livre sem escape. Ele usa uma janela duplicada limitada: um novo incidente no mesmo sensor dentro dessa janela pode ser suprimido. Se suas operações exigirem incidentes rápidos separados, adicione uma identidade de incidente num adaptador customizado antes de entrar em operação.
Exemplo de configuração · substitua os espaços reservados antes de usar
URL: https://bridge.example.invalid/webhooks/prtg
Method: POST
Content-Type: application/x-www-form-urlencoded
bridge_token=<PRIVATE_BRIDGE_TOKEN>&sensor_id=%sensorid&status=Down&event_id=%sensorid-Down
# Recovery template: replace both fixed Down values with Up.Valide antes de ativar o transporte
- Check Down, repetido Down, Up e um segundo Down genuíno; valide exatamente o que a janela duplicada configurada suprime.
Referências: PRTG custom notifications · PRTG placeholders
API FoxBox: parâmetros, erros e status · Autenticação do adaptador e tratamento duplicado
