I webhook consegnano dati ad altre applicazioni, attivate da determinati eventi mediante HTTP POST. Ogni volta che si verifica un evento, l'origine invia una richiesta HTTP all'applicazione di destinazione configurata per il webhook.

VMware Edge Network Intelligence supporta i webhook e consente agli amministratori di:
  • Selezionare gli eventi imprevisti in base ai criteri di corrispondenza.
  • Inviare gli eventi imprevisti selezionati e le relative informazioni al ricevitore webhook configurato ospitato dal sistema di terze parti.

Ricevendo le notifiche, i sistemi di terze parti possono segnalarli o attivare workflow automatizzati o inviare automaticamente notifiche agli utenti finali in tempo reale.

Procedura

  1. Nel riquadro di spostamento, fare clic su Il mio account (My Account) > Impostazioni amministratore (Admin Settings).
  2. Nella finestra Impostazioni amministratore (Admin Settings) fare clic su Integrazione esterna (External Integration) quindi sulla scheda Webhook.
  3. Nella pagina Webhook fare clic su Aggiungi configurazione webhook (Add Webhook Configuration).
    Immettere i seguenti parametri:
    Opzione Descrizione
    Nome (Name) Immettere un nome per il webhook.
    URL webhook Immettere un URL HTTPS valido. L'URL funge da applicazione di destinazione per i webhook.
    Codice di risposta Immettere un codice di stato della risposta HTTP previsto per ciascun destinatario di webhook.
    Codice di autenticazione Specificare un codice di autenticazione per ciascun destinatario di webhook configurato, utilizzato per calcolare un codice HMAC per ogni richiesta webhook inviata al destinatario corrispondente. Per la maggior parte dei ricevitori webhook, il codice HMAC è incorporato in un'intestazione HTTP X-Webhook-Signature, insieme a un parametro di versione, che identifica una data e ora e l'algoritmo di firma.
    Fare clic su Aggiungi avviso (Add Alert) per configurare gli eventi imprevisti che devono inviare informazioni al ricevitore del webhook.
    Tipo di avviso Descrizione Modello JSON Invia avvisi per
    Occorrenza evento imprevisto Spostare il dispositivo di scorrimento sulla posizione ON per attivare l'occorrenza degli eventi imprevisti.

    VMware Edge Network Intelligence recapita notifiche di avviso a ciascun destinatario di webhook tramite un payload JSON contenuto nel corpo di una richiesta POST HTTP in uscita.

    Il modello JSON è costituito dai seguenti parametri:
    • ID
    • Descrizione
    • Priorità
    • Numero di dispositivi interessati
    • Cause principali dell'avviso
    • Passi successivi suggeriti
    • Intervallo di tempo
    • Collegamento evento imprevisto
    Di seguito è disponibile un esempio di modello JSON Payload: 
    {
     "id": "p-1131935905",
     "description": "DHCP protocol/latency issues affected clients",
     "priority": "2",
     "affected": "237 out of 2358 devices affected (10.1%)",
     "rootcauses": "Server is not reachable or Server is not configured",
     "nextsteps": "Please check if DHCP server is reachable from clients VLAN",
     "timeInterval": "07:15 - 08:15 on 7/19 PDT"
     "incidentLink": "https://company.bogus/campus/ui/analysis#/incidents/SERVERS.dnsServerQoE_5minRunAvg?fr=1642_164300&incident-id=p1234"
}
    		 Scegliere i parametri come la priorità e gli eventi per i quali è necessario inviare avvisi.
    Interruzioni del crawler Spostare il dispositivo di scorrimento sulla posizione ON per identificare il crawler in cui si verificano problemi di interruzione.
    Il modello JSON è costituito dai seguenti parametri:
    • ID
    • Nome (Name)
    • Indirizzi IP
    • Problema
    Di seguito è disponibile un esempio di modello JSON Payload: 
    {
    id: "623e00b144fe5ed7959f44bd", 
    name: "Crawler-9",
    ips: ["192.0.2.0"], 
    issue: "Lost WAN/SPAN connectivity"
}
    		 Fare clic sul link + Aggiungi crawler (+ Add Crawler) e aggiungere i crawler per i quali è necessario inviare gli avvisi.
  4. Fare clic su Salva (Save). Nella scheda Webhook vengono visualizzati i webhook creati.

risultati

Ogni volta che viene attivato un evento imprevisto, viene inviato un messaggio di avviso insieme alle informazioni rilevanti all'URL di destinazione.

Nella scheda Webhook, è possibile fare clic su un webhook esistente per visualizzare i dettagli configurati, lo stato dell'ultima notifica e la cronologia delle notifiche degli eventi imprevisti.