SPREMLJANJE IN OPOZARJANJE
EksperimentalnoGrafana 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
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=pvzahteva. 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.
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.
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. korak
Ustvarite kontaktno točko Webhook v sistemu Grafana Alerting.
3. korak
Nastavite končno točko mostu (bridge endpoint) in konfiguracijo zaščitene avtentikacije.
4. korak
Pred dodelitvijo pravilnika obveščanja uporabite test kontaktne točke s preizkusnim mostom.
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.
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.
python3 -m unittest discover -s tests -vPreverite pričakovani koristni tovor, vedenje pri preverjanju, ravnanje z dvojniki in odgovore na napake. Spodnji laboratorij prikazuje potek lokalno v vašem brskalniku.
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.
FoxBox S2 · kompaktna naprava z dvema modemomaKonfiguracija 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 JSONPreveri 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
