IBM NS1 Connect canale di avviso

Campi di configurazione

• Nome : nome descrittivo del canale di avviso in Instana (ad esempio, NS1 Production DNS Failover).
• WebhookURL : uno o più endpoint webhook NS1 (minimo 1 richiesto):
  • Formato: https://api.nsone.net/v1/...
  • È possibile aggiungere più URL webhook per ridondanza o diverse zone NS1.
• Intestazioni personalizzate HTTP : Intestazioni opzionali HTTP per l'autenticazione e la configurazione:
  • Le intestazioni comuni includono le chiavi API : X-NSONE-Key: your-api-key
  • Aggiungi più coppie chiave-valore secondo necessità.

Configurazione dei payload personalizzati

Formato payload personalizzato

custom:up = 0
custom:loadavg = 0.9

{
  "up": "0",
  "loadavg": "0.9"
}

Come funziona la modalità di failover

1. Si apre un avviso (l'host o il servizio non funziona correttamente):
   • Il sistema invia un payload personalizzato con up: 0 a NS1.
   • NS1 contrassegna il punto finale come non funzionante e reindirizza il traffico.
2. L'avviso si chiude automaticamente (host o servizio ripristinato):
   • Il sistema ignora la notifica per evitare effetti ping-pong.
   • Questo comportamento impedisce il failback prematuro durante problemi transitori.
3. Allarme chiuso manualmente (intervento dell'operatore):
   • Il sistema modifica automaticamente il up valore da 0 a 1.
   • NS1 contrassegna il punto finale come attivo e ripristina il traffico.
   • Questo approccio garantisce un failback controllato dopo la verifica.

Esempio di configurazione di failover

Per configurare il failover di DNS con NS1:

1. Crea una configurazione di avviso per lo stato di integrità dell'host o del servizio.
2. Aggiungi un payload personalizzato: custom:up = 0.
3. Selezionare il canale di avviso IBM NS1 Connect.
4. Quando l'allerta si attiva, NS1 esegue automaticamente il failover del traffico.
5. Chiudere manualmente l'avviso in Instana quando si è pronti per il failback.

Esempio: notifica di failover di DNS

Configurazione personalizzata del carico utile:

custom:up = 0

Payload inviato a NS1 all'apertura dell'allerta:

{
  "up": "0"
}

Autenticazione chiave API

URL webhook multipli

Tutti gli URL webhook configurati ricevono lo stesso payload per ogni avviso.

Considerazioni sulla progettazione

1. Utilizza i payload personalizzati in modo strategico : includi solo i campi che NS1 deve elaborare.
2. Testare gli scenari di failover : verificare che il failover dell' DNS e funzioni come previsto prima dell'utilizzo in produzione.
3. Controllo manuale del failback : utilizzare la chiusura manuale degli avvisi per un failback controllato dopo la verifica.
4. Monitorare i log di NS1 : controllare i log del webhook NS1 per verificare che la consegna sia avvenuta correttamente.
5. Implementare la ridondanza : configurare più URL webhook per scenari di failover critici.

Suggerimenti per la configurazione degli avvisi

1. Regole di avviso specifiche : crea regole di avviso mirate che attivano azioni di NS1 solo quando necessario.
2. Soglie appropriate : impostare soglie che evitino falsi positivi e failover non necessari.
3. Denominazione chiara : utilizzare nomi descrittivi per i canali di avviso e le configurazioni.
4. Documentazione : documento che mappa i payload personalizzati ai feed di dati dell' NS1.
5. Test : testare prima le configurazioni degli avvisi in un ambiente non di produzione.

Risoluzione dei problemi

Se gli avvisi non arrivano all' NS1:

1. Verifica webhook URL : assicurati che il webhook NS1 URL sia corretto e accessibile.
2. Controlla l'autenticazione : verifica che le chiavi e le intestazioni API siano configurate correttamente.
3. Controllare i payload personalizzati : assicurarsi che i payload personalizzati siano definiti (i payload vuoti non vengono inviati).
4. Controlla i log di NS1 : Controlla i log del webhook NS1 per eventuali errori di consegna.
5. Verifica della connettività : verifica la connettività di rete dagli endpoint Instana agli endpoint NS1.
6. Regole di avviso di revisione : assicurarsi che le regole di avviso si attivino come previsto.

Limitazioni

• Nessuna funzionalità di test : il canale IBM NS1 Connect non supporta il pulsante Test Channel nell'interfaccia utente.
• Nessuna assegnazione di team : il controllo degli accessi basato sui team non è disponibile per questo tipo di canale.
• Payload personalizzati richiesti : gli avvisi vengono inviati a NS1 solo quando sono configurati payload personalizzati.
• Test manuale richiesto : testare l'integrazione attivando avvisi reali o utilizzando l' API del backend.

Perché non c'è un pulsante di prova per il canale NS1 Connect dell' IBM?

La funzionalità di test non è disponibile perché IBM NS1 Connect non fornisce un endpoint API separato per testare le integrazioni webhook. NS1 I webhook sono progettati per ricevere dati di allerta effettivi in produzione. Per testare l'integrazione, attiva un avviso reale o utilizza una configurazione di avviso di prova con soglie appropriate.

Cosa succede se i payload personalizzati non sono configurati?

Se nella configurazione degli avvisi non sono stati configurati payload personalizzati, il canale IBM NS1 Connect non invia notifiche. Questo comportamento impedisce l'invio di dati vuoti o non validi a NS1. Configurare sempre i payload personalizzati previsti da NS1 per il proprio caso d'uso specifico.

In che modo la modalità di failover impedisce gli effetti ping-pong?

Quando un avviso si chiude automaticamente (ad esempio, un host si ripristina), il canale NS1 salta l'invio della notifica. Questo comportamento impedisce il failback immediato che potrebbe causare il rimbalzo del traffico tra endpoint integri e non integri durante problemi transitori. Solo la chiusura manuale degli avvisi attiva il failback, consentendo agli operatori di controllare quando ripristinare il traffico.

È possibile inviare payload diversi a diversi webhook NS1?

No, tutti gli URL webhook configurati ricevono lo stesso payload per ogni avviso. Se sono necessari payload diversi per endpoint NS1 diversi, creare canali di avviso e configurazioni di avviso separati per ciascun caso d'uso.

Come verificare che gli avvisi arrivino correttamente all'indirizzo NS1?

Controlla i log dei webhook nel tuo portale IBM NS1 Connect per verificare che i webhook vengano ricevuti. È inoltre possibile monitorare gli aggiornamenti del feed di dati NS1 per verificare che i dati degli avvisi vengano elaborati correttamente.