Configurare l'indicizzazione degli incidenti di PagerDuty nell'agente SRE di Azure

Connetti l'account PagerDuty affinché l'agente rilevi automaticamente gli incidenti PagerDuty e li analizzi.

Tempo: ~5 minuti

Prerequisiti

  • Un agente SRE di Azure in stato in esecuzione
  • Un account PagerDuty con almeno un servizio configurato
  • Una chiave API utente PagerDuty (non una chiave API generale) - vedere Chiavi di accesso api PagerDuty
  • Ruolo collaboratore o superiore nella risorsa agente SRE

Tipi di chiave API PagerDuty

PagerDuty offre due tipi di chiavi API:

Tipo di chiave Description Funziona con l'agente SRE?
Chiave API generale Usato per il lavoro di sviluppo e per l'accesso generale alle API. No: non può riconoscere gli incidenti per conto dell'agente
Chiave API utente Associato a un account utente e a un indirizzo di posta elettronica specifici Sì : obbligatorio per l'integrazione dell'agente SRE

Importante

È necessario usare una chiave API utente per l'integrazione dell'agente SRE. Le chiavi API generali non consentono all'agente di riconoscere correttamente gli eventi imprevisti perché mancano il contesto utente (indirizzo di posta elettronica) necessario per il riconoscimento degli eventi imprevisti.

Creare una chiave API utente in PagerDuty

  1. Accedi al tuo account PagerDuty.
  2. Vai a Impostazioni utente>Accesso API.
  3. Selezionare Crea token utente API.
  4. Specificare una descrizione per la chiave, ad esempio "Integrazione agente SRE".
  5. Copiare la chiave API utente generata.

Passaggio 1: Aprire la piattaforma eventi imprevisti

  1. Passare a sre.azure.com e selezionare l'agente.
  2. Nella barra laterale espandere Generatore.
  3. Selezionare Piattaforma incidenti.

Checkpoint: si vede l'intestazione "Piattaforma incidenti" con un menu a discesa della piattaforma.

Passaggio 2: Selezionare PagerDuty

  1. Selezionare il menu a tendina Piattaforma incidenti.
  2. Selezionare PagerDuty.

Se si connette un'altra piattaforma, è prima necessario disconnetterla. L'agente si connette a una piattaforma di gestione degli incidenti alla volta.

Checkpoint: Il modulo PagerDuty viene visualizzato con un'intestazione verde e un campo chiave API.

Passaggio 3: Immettere la chiave API PagerDuty

Immettere la chiave di accesso all'API REST nel campo .

L'agente convalida immediatamente la chiave chiamando l'API PagerDuty.

Suggerimento

Per creare una chiave API utente, passare a User Settings>API Access in PagerDuty e selezionare Create API User Token (Crea token utente API). Per usufruire di tutte le funzionalità (prendere in carico, risolvere, aggiungere note), assicurati che il tuo account utente disponga dei permessi di scrittura.

Checkpoint: Non viene visualizzato alcun errore di convalida sotto il campo chiave. Il pulsante Salva diventa attivo.

Se viene visualizzato "La chiave di accesso non è valida. Riprovare, verificare la chiave in PagerDuty alla voce Integrazioni>Chiavi di Accesso API. Rigenerare la chiave se è scaduta.

Passaggio 4: Abilitare il piano di risposta di avvio rapido

La casella di controllo Piano di risposta di avvio rapido è abilitata per impostazione predefinita. Questa opzione crea un piano di risposta che:

  • Corrisponde agli incidenti PagerDuty con priorità P1
  • Viene eseguito in modalità completamente autonoma
  • Vengono illustrati tutti i servizi interessati

Lasciare selezionata questa opzione per iniziare con la gestione automatica degli eventi imprevisti P1. Se si deseleziona, non vengono visualizzati eventi imprevisti fino a quando non si crea manualmente un piano di risposta.

Passaggio 5: Salvare e connettersi

  1. Seleziona Salva.
  2. Attendere che l'indicatore di connettività mostri "PagerDuty è connesso". Questo passaggio richiede in genere da 30 secondi a 2 minuti.

Avviso

Se viene visualizzato "Connessione a PagerDuty non riuscita", verifica che la chiave API sia corretta, non sia scaduta e disponga delle autorizzazioni di lettura degli incidenti.

Checkpoint: L'indicatore di connettività mostra uno stato verde "PagerDuty è connesso".

Passaggio 6: verificare che vengano visualizzati incidenti

  1. Nella barra laterale selezionare Attività.
  2. Selezionare Eventi imprevisti.
  3. Attendere 1-2 minuti affinché lo scanner completi il primo ciclo.

Gli eventi imprevisti pagerDuty che corrispondono ai filtri del piano di risposta vengono visualizzati nella griglia di panoramica degli eventi imprevisti.

Checkpoint: gli incidenti PagerDuty vengono visualizzati con colonne per ID, Intestazione, Priorità, Stato, Stato agente, Data creazione, Servizio interessato e Gestore.

Modificare o disconnettere PagerDuty

Modificare le impostazioni di connessione

  1. Andare a Builder>Piattaforma di gestione degli incidenti.
  2. Seleziona Modifica.
  3. Modificare la chiave API o altre impostazioni.
  4. Seleziona Salva.

Disconnettere PagerDuty

  1. Andare a Builder>Piattaforma di gestione degli incidenti.
  2. Selezionare Disconnetti.
  3. Confermare la disconnessione.

Dopo la disconnessione, l'agente interrompe la scansione degli incidenti di PagerDuty. I piani di risposta vengono mantenuti e riattivati quando ci si riconnette.

Risoluzione dei problemi

Issue Soluzione
"La chiave di accesso non è valida" Verificare la chiave nelle chiavi di accesso dell'API > Integrazioni > in PagerDuty
"Connessione a PagerDuty non riuscita" Controllare le autorizzazioni delle chiavi. La chiave richiede come minimo l'accesso in lettura agli incidenti
Non vengono visualizzati eventi imprevisti dopo la configurazione Attendere 1-2 minuti per il primo ciclo di analisi
Necessità di passare da un'altra piattaforma Disconnettere prima la piattaforma corrente
L'indicatore di connettività rimane "Connessione" Consenti fino a 2 minuti. Se si verifica il timeout, immettere nuovamente la chiave API

Contenuti correlati

  • Last updated on