Preskoči na vsebino
Milano · Como · Od leta 2010SIM + SMPP / HTTP
FoxBox
Meni

SPREMLJANJE IN OPOZARJANJE

Eksperimentalno

Grafana Alerting
SMS-obvestila.

Prenesite obveščanje z nadzornih plošč na pot mobilnega obveščanja. Začnite s prototipom, ki ga je mogoče pregledati, in zunanjim vmesnikom (bridge) do HTTP API-ja sistema FoxBox.

NAČIN POVEZOVANJA

Grafana AlertingSprožitev pravila za opozarjanje
{}Zunanji mostPreverite · prevedite · odstranite podvojene vnose.
▣FoxBoxDokumentiran vmesnik HTTP
▤Konfigurirana pot SMSKartica SIM ali zunanja storitev prek sistema Kannel

01 / Primer uporabe

Koristno obvestilo.
iz obstoječega dogodka.

Sproži se opozorilo v sistemu Grafana. Prek kontaktne točke »webhook« se skupina opozoril pošlje na zunanji vmesnik (most), kjer se sporočila združijo in normalizirajo.

Integracija doda ločeno pot za obveščanje SMS. Ne vzpostavlja razpoložljivosti storitev ali nadomešča vašega obstoječega procesa odzivanja na incidente in eskalacije.

02 / Zahteve

Preden začnete.

  • Spletni kavelj (webhook) za Grafana Alerting; ciljna različica za preverjanje
  • Ločen gostitelj za integracijski vmesnik. V strojno-programsko opremo (firmware) naprave FoxBox ni nameščeno ničesar.
  • Python 3 za vmesnik (bridge) in izolirano okolje za prvi preizkus.
  • Vmesnik HTTP naprave FoxBox, združljiv z dokumentiranim app=ws, op=pv zahteva. Potrebna je potrditev naprave in različice vdelane programske opreme (firmware).
  • Za morebitne kasnejše preizkuse v živo: odobreni prejemnik, pravilne poverilnice in potrjena SMS pot. Poti SIM zahtevajo pokritost; zunanje storitve zahtevajo dostop do interneta in konfiguracijo ponudnika.
Združljivost je predmet preverjanja ob uvajanju.

Za ta prototip ni bila v celoti preverjena nobena različica strojne programske opreme (firmware) za fizično napravo FoxBox niti ciljna instanca sistema Grafana Alerting.

Kateri model FoxBox je primeren za to integracijo?

Izberite želeni format, število modemov in omrežje. Kot kontekst projekta ohranite Grafana Alerting.

Poiščite pravi FoxBox za to integracijo →

03 / Namestitev

Začnite ločeno.

  1. Pripravite most.

    Prenesite paket izvorne kode. Sledite navodilom v datoteki README v korenski mapi za konfiguracijo zunanjega mostu v načinu »suhega teka« (dry-run) z uporabo nadomestnih znakov in lokalnega testnega cilja.

  2. 2. korak

    Ustvarite kontaktno točko Webhook v sistemu Grafana Alerting.

  3. 3. korak

    Nastavite končno točko mostu (bridge endpoint) in konfiguracijo zaščitene avtentikacije.

  4. 4. korak

    Pred dodelitvijo pravilnika obveščanja uporabite test kontaktne točke s preizkusnim mostom.

Odprite celotno datoteko README za Grafana Alerting ↗

04 / Pregled kode

Nič ni skrito
za primerom.

Spodnje datoteke izvirajo iz paketa virov za integracijo, ki je na voljo za prenos. Pred uporabo primera preberite celoten priročnik za povezovanje in integracijo.

config.json
Loading source…

05 / Preverjanje poti

Preizkusite primer.
Nato preizkusite uvedbo.

Zaženite izoliran nabor testov iz razpakiranega imenika repozitorija. Njegov simulirani prenosni mehanizem (mock transport) ne pošilja sporočil SMS in ne potrjuje dostave prek mobilnega omrežja.

Terminal · izolirani testi
python3 -m unittest discover -s tests -v

Preverite pričakovani koristni tovor, vedenje pri preverjanju, ravnanje z dvojniki in odgovore na napake. Spodnji laboratorij prikazuje potek lokalno v vašem brskalniku.

Trenutna omejitev

Prenos prek kontaktne točke (contact-point) v Grafani, združena opozorila in vedenje ob obnovitvi zahtevajo preverjanje ciljne instance. Uspešen test s simuliranimi podatki (mock test) ni dokaz, da je sporočilo SMS dejansko prispelo.

06 / Odpravljanje težav

Poskrbite, da bodo napake vidne.

Most zavrne koristni tovor.

Preverite preslikavo integracijskega polja glede na priloženo konfiguracijo. Najprej uporabite sintetične primere. Ne kopirajte vsebine produkcijskih dogodkov ali poverilnic v dnevnike podpore.

Zahteva poteče (časovna omejitev).

Preverite dosegljivost, TLS in pričakovani format zahteve. Dvosmiselne zahteve SMS ne pošiljajte samodejno znova: morda je bila prva zahteva že sprejeta.

API je sprejel zahtevo, vendar sporočilo SMS ni prispelo.

Sprejem zahteve ne pomeni potrditve dostave. Preverite dokumentiran status sporočila v sistemu FoxBox in stanje mobilnega omrežja na dejanski napravi; prototip ne more potrditi dostave.

Poslan je podvojen dogodek.

Pregled nastavitev ključa dogodka mostu in deduplikacije. Preden omogočite obvestila v živo, preverite združene in obnovitvene dogodke v ciljni programski opremi.

Od integracije do strojne opreme

Izberite format.
Preverite ustreznost (fit).

Začnite z S1 za en modem, S2 za dva ali SR za namestitev v omarico. Sama integracija ne določa zahtev glede zmogljivosti ali odpornosti modema.

Slika izdelka FoxBox S2 iz katalogaFoxBox S2 · kompaktna naprava z dvema modemoma

Konfiguracija in validacija

Tehnična nastavitev: Grafana

Povezava prek zunanjega vmesnika (mostu)

Ustvarite kontaktno točko Webhook z uporabo metode HTTP POST, URL-naslova vmesnika in avtorizacije tipa »Bearer«. Ohranite izvorno vsebino (payload) sporočila Webhook sistema Grafana. Za priloženi razčlenjevalnik nastavite največje število opozoril na 20 in ohranite omogočena razrešena obvestila. Preden razmislite o širših skupinah opozoril, usmerite ozko omejen pravilnik o obveščanju tej kontaktni točki.

Most prebere prstne odtise opozoril in začetne/končne čase, da loči skupine sprožitve in razrešene skupine. Omejuje velikost sporočila in zavrača neprimerne koristne obremenitve; ne pošilja tiho okrnjenega seznama vseh opozoril. Poverilnice mostu naj bodo v zaščitenem polju za avtorizacijo Grafane, poverilnice FoxBox pa samo na gostitelju mostu.

Primer konfiguracije · pred uporabo zamenjajte označena mesta (rezervirana polja)

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

Preveri pred aktiviranjem transportnega kanala

  • Uporabite sintetično skupino za sprožitev, podvojeno dostavo, razrešeno skupino in preveliko skupino; preverite identiteto glavne knjige in vedenje zavrnitve z omogočenim poskusnim zagonom.

Reference: Grafana webhook notifier

API za FoxBox: parametri, napake in status · Avtentikacija adapterja in obravnava podvojenih vnosov

↑

Contact US