Saltar para o conteúdo
Milão · Como · Desde 2010SIM + SMPP / HTTP
FoxBox
Menu

Monitorização E ALERTA

Experimental

Grafana Alerting
Notificações por SMS.

Traga alertas de painéis para um caminho de notificação de móvel. Comece com um protótipo revisável e uma ponte externa para a API FoxBox HTTP.

COMO SE CONECTA

Grafana AlertingDisparo de regra de alerta
{}Ponte externaValidar · traduzir · desduplicar
▣FoxBoxInterface HTTP documentada
▤Rota SMS configuradaSIM ou serviço externo via Kannel

01 / CASO DE USO

Uma notificação útil,
de um evento existente.

Um alerta Grafana é disparado. Um ponto de contacto do webhook envia o grupo de alerta para uma ponte externa, onde as mensagens são limitadas e normalizadas.

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.

  • Webhook de alerta Grafana; versão de destino 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=pv pedido. 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.
A compatibilidade é uma verificação de implementação.

Nenhuma versão física do firmware FoxBox ou instância de alerta Grafana de destino 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 Grafana Alerting como contexto do projeto.

Encontre a FoxBox certa para esta integração →

03 / INSTALAÇÃO

Comece isoladamente.

  1. 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.

  2. Etapa 2

    Crie um ponto de contacto Webhook no Alerta Grafana.

  3. Etapa 3

    Defina o endpoint da ponte e a configuração de autenticação protegida.

  4. Etapa 4

    Use o teste de ponto de contacto com uma ponte de simulação antes de atribuir uma política de notificação.

Abra o README completo do Alerta Grafana ↗

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.

config.json
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.

Terminal · testes isolados
python3 -m unittest discover -s tests -v

Verifique 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.

Limitação atual

O transporte do ponto de contacto do Grafana, os alertas agrupados e o comportamento de recuperação precisam de validação da instância de destino. 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.

Imagem do catálogo FoxBox S2FoxBox S2 · aparelho compacto com dois modems

Configuração e validação

Configuração técnica: Grafana

Ligação através de uma ponte externa

Crie um ponto de contacto Webhook com HTTP POST, a URL da ponte e a autorização do portador. Mantenha a carga útil do webhook nativo do Grafana. Defina Max Alerts como 20 para o analisador fornecido e mantenha as notificações resolvidas habilitadas. Encaminhe uma política de notificação com escopo restrito para esse ponto de contacto antes de considerar grupos de alerta mais amplos.

A ponte lê impressões digitais de alerta e horários de início/término para distinguir grupos de disparo e resolvidos. Ele limita o tamanho da mensagem e rejeita cargas inadequadas; ele não envia silenciosamente uma lista truncada de cada alerta. Mantenha a credencial da ponte no campo de autorização protegido do Grafana e a credencial do FoxBox apenas no host da ponte.

Exemplo de configuração · substitua os espaços reservados antes de usar

URL: https://bridge.example.invalid/webhooks/grafana
HTTP method: POST
Authorization scheme: Bearer
Authorization credentials: <PRIVATE_BRIDGE_TOKEN>
Max Alerts: 20
Disable resolved message: false
Payload: default Grafana webhook JSON

Valide antes de ativar o transporte

  • Utilizar grupo de disparo sintético, entrega duplicada, grupo resolvido e grupo superdimensionado; verifique a identidade do razão e o comportamento de rejeição com simulação habilitada.

Referências: Grafana webhook notifier

API FoxBox: parâmetros, erros e status · Autenticação do adaptador e tratamento duplicado

↑

Contact US