Ga naar de inhoud
Milaan · Como · Sinds 2010SIM + SMPP / HTTP
FoxBox
Menu

BEWAKING & ALARMEN

Experimenteel

PRTG Network Monitor
SMS-meldingen.

Voeg een sms-pad toe aan de sensorwaarschuwingen die uw team al gebruikt. Begin met een te beoordelen prototype en een externe brug naar de FoxBox HTTP API.

HOE HET VERBINDT

PRTG Network MonitorSensorstatus gewijzigd
{}Externe bridgeValideren · vertalen · duplicaten verwijderen
▣FoxBoxGedocumenteerde HTTP-interface
▤Geconfigureerde SMS-routeSIM of externe dienst via Kannel

01 / GEBRUIKSSITUATIE

Een nuttige melding,
van ​​een bestaande gebeurtenis.

Een sensor verandert van status. Een PRTG-notificatiesjabloon geeft een gecontroleerde gebeurtenis door aan de bridge voor sms-opmaak.

De integratie voegt een apart SMS-notificatiepad toe. Het garandeert geen beschikbaarheid van de service en vervangt uw bestaande incidentrespons- en escalatieproces niet.

02 / VEREISTEN

Voordat u begint.

  • PRTG HTTP-notificatiesjabloon; geïnstalleerde versie ter validatie
  • Een aparte host voor de integratiebridge. Er is niets geïnstalleerd op de FoxBox-firmware.
  • Python 3 voor de bridge en een geïsoleerde omgeving voor de eerste test.
  • Een FoxBox HTTP-interface die compatibel is met de gedocumenteerde app=ws, op=pv verzoek. Apparaat- en firmwareversie moeten worden bevestigd.
  • Voor elke latere livetest: een goedgekeurde ontvanger, correcte inloggegevens en een gevalideerde sms-route. SIM-routes vereisen dekking; externe services vereisen internettoegang en providerconfiguratie.
Compatibiliteit is een implementatiecontrole.

Er is geen fysieke FoxBox-firmwareversie of doel-PRTG Network Monitor-instantie volledig geverifieerd voor dit prototype.

Welke FoxBox is geschikt voor deze integratie?

Kies het gewenste formaat, aantal modems en netwerk. Houd PRTG Network Monitor als projectcontext.

Vind de juiste FoxBox voor deze integratie →

03 / INSTALLATIE

Begin in isolatie.

  1. Bereid de bridge voor.

    Download het broncodepakket. Volg de README in het hoofdbestand om de externe bridge in testmodus te configureren, met behulp van placeholders en een lokale testbestemming.

  2. Stap 2

    Een sjabloon voor een 'Execute HTTP Action'-melding maken in PRTG.

  3. Stap 3

    Koppel de opgegeven URL en body-sjabloon aan het bridge-eindpunt.

  4. Stap 4

    Wijs het sjabloon toe aan een testsensor-meldingstrigger en inspecteer de reactie tijdens de test.

Open de volledige PRTG Network Monitor README ↗

04 / DE CODE CONTROLEREN

Niets verborgen
achter het voorbeeld.

De onderstaande bestanden zijn afkomstig uit het downloadbare integratiebronpakket. Raadpleeg de volledige bridge- en integratiehandleiding voordat u het voorbeeld gebruikt.

config.json
Loading source…

05 / HET PAD VALIDEREN

Test het voorbeeld.
Test vervolgens de implementatie.

Voer de geïsoleerde suite van de repository uit vanuit de uitgepakte repositorymap. De gesimuleerde transportlaag verzendt geen sms-berichten en bewijst geen mobiele levering.

Terminal · geïsoleerde tests
python3 -m unittest discover -s tests -v

Controleer de verwachte payload, het validatiegedrag, de afhandeling van duplicaten en foutreacties. De onderstaande laboefening illustreert de workflow lokaal in uw browser.

Huidige beperkingen

PRTG-placeholderuitbreiding en HTTP-authenticatiegedrag vereisen validatie in de Doel-PRTG-versie. Een succesvolle test is geen bewijs dat er een sms is aangekomen.

06 / PROBLEEMOPLOSSING

Maak fouten zichtbaar.

De bridge weigert de payload.

Controleer de toewijzing van integratievelden aan de hand van de meegeleverde configuratie. Gebruik eerst de synthetische voorbeelden. Kopieer geen inhoud van productie-events of inloggegevens naar supportlogs.

De aanvraag verloopt.

Controleer de bereikbaarheid, TLS en het verwachte aanvraagformaat. Verstuur een onduidelijke sms-aanvraag niet automatisch opnieuw: de eerste aanvraag is mogelijk al geaccepteerd.

De API accepteerde het verzoek, maar er is geen sms ontvangen.

Een aanvraag accepteren is geen leveringsbevestiging. Controleer de gedocumenteerde FoxBox-berichtstatus en de mobiele netwerkcondities op het daadwerkelijke apparaat; het prototype kan de levering niet bevestigen.

Een dubbele gebeurtenis wordt verzonden.

Beoordeel de bridge event-key en deduplicatie-instellingen. Valideer gegroepeerde en herstelgebeurtenissen in de doelsoftware voordat u live meldingen inschakelt.

VAN INTEGRATIE NAAR HARDWARE

Kies het formaat.
Valideer de pasvorm.

Begin met S1 voor één modem, S2 voor twee, of SR voor een rack-implementatie. De integratie alleen bepaalt niet de modemcapaciteit of de vereisten voor redundantie.

Afbeelding uit de FoxBox S2-catalogusFoxBox S2 · compact apparaat met twee modems

Configuratie en validatie

Technische configuratie: PRTG

Verbinding via een externe bridge

Schakel in een notificatiesjabloon 'HTTP-actie uitvoeren' in en selecteer POST. Verzend de onderstaande formuliervelden naar de externe PRTG-brug. Gebruik een 'Down'-sjabloon en een apart 'Up'-sjabloon en koppel deze vervolgens aan de juiste sensornotificatietriggers. Sla de inloggegevens op in de privénotificatieconfiguratie.

Deze configuratie geeft bewust een numerieke sensor-ID en een vaste status door in plaats van niet-geëscapte vrije tekstplaceholders. Er wordt gebruik gemaakt van een beperkt duplicatievenster: een nieuw incident op dezelfde sensor binnen dat venster kan worden onderdrukt. Als uw werkzaamheden afzonderlijke, snelle incidenten vereisen, voeg dan een incident-ID toe in een aangepaste adapter voordat u live gaat.

Configuratievoorbeeld · vervang placeholders vóór gebruik

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.

Valideer voordat u transport inschakelt

  • Controleer op 'Down', herhaaldelijk 'Down', 'Up' en een tweede echte 'Down'; valideer precies wat het geconfigureerde duplicatievenster onderdrukt.

Referenties: PRTG custom notifications · PRTG placeholders

FoxBox API: parameters, fouten en status · Adapterauthenticatie en afhandeling van duplicaten

↑

Contact US