PagerDuty Introduzione all'integrazione

Scopri come integrare Oracle Cloud Infrastructure Notifications con PagerDuty in modo da poter attivare PagerDuty incidenti.

panoramica

L'integrazione con PagerDuty prevede i task riportati di seguito.

Creare un endpoint PagerDuty

Per completare questa procedura, è necessario disporre di uno dei ruoli seguenti in PagerDuty: Manager, Amministratore, Amministratore globale o Proprietario account.

Passare a PagerDuty.
Nel menu Configurazione, selezionare Servizi.
Nella pagina Servizi:
1. Se si sta creando un servizio per l'integrazione, selezionare +Add Nuovo servizio.
2. Se si sta aggiungendo l'integrazione a un servizio esistente, selezionare il nome del servizio a cui si desidera aggiungere l'integrazione. Selezionare quindi la scheda Integrazioni e selezionare il pulsante +New Integrazione.
Digitare un nome integrazione nel formato monitoring-tool-service-name.

Se si sta creando un servizio per l'integrazione, in Impostazioni incidente specificare il criterio di escalation, l'urgenza di notifica e il comportamento degli incidenti per il nuovo servizio.
Selezionare il tipo di endpoint preferito dal menu Tipo di integrazione in base alle opzioni riportate di seguito.
- Oracle Cloud Infrastructure Monitoring: se si desidera che vengano pubblicati solo i messaggi tramite allarme (utilizzando il formato del messaggio di allarme). Per questo tipo di endpoint, PagerDuty risponde in base al formato del messaggio:
  - I messaggi che utilizzano i formati di messaggio generici vengono ignorati. Ad esempio, se la regola evento attiva la pubblicazione di un messaggio nell'argomento contenente questa sottoscrizione o se si pubblica direttamente un messaggio nell'argomento utilizzando il servizio Notifiche, non viene creato alcun caso PagerDuty.
  - I messaggi che utilizzano il formato del messaggio di allarme vengono elaborati. Ad esempio, se l'allarme attiva la pubblicazione di un messaggio nell'argomento, che è nel formato del messaggio di allarme, viene creato un incidente PagerDuty.
- Trasformatore eventi personalizzato: se si desidera che i messaggi generino un incidente PagerDuty, indipendentemente dal fatto che provengano da regole evento, allarmi, connettori, annunci console o pubblicazioni dirette. I messaggi inviati a questo endpoint seguono il formato di messaggio generico.
  
  Per ulteriori informazioni su Custom Event Transformer, consultare la documentazione PagerDuty.
Selezionare il pulsante Aggiungi servizio o Aggiungi integrazione per salvare la nuova integrazione.
Si viene reindirizzati alla pagina Integrazioni per il servizio.
Copiare la chiave di integrazione e l'URL di integrazione per la nuova integrazione e conservarla in un luogo sicuro per utilizzarla in un secondo momento.
Esempio di PagerDuty chiave di integrazione e URL di integrazione (al momento della pubblicazione del documento):

Ora si dispone della chiave di integrazione necessaria per creare una sottoscrizione PagerDuty in Notifiche.

Creazione di una sottoscrizione PagerDuty

Per completare questa procedura, è necessario disporre dell'accesso alle notifiche e delle autorizzazioni per creare argomenti e sottoscrizioni. Vedere Protezione delle notifiche (criteri IAM).

Nella pagina di elenco Argomenti selezionare Crea argomento. Per informazioni su come trovare la pagina dell'elenco, vedere Elenco di argomenti.
Nel pannello Crea sottoscrizione, per Protocollo, selezionare PagerDuty.
Il campo URL viene visualizzato con uno spazio che consente di aggiungere la chiave di integrazione.
- Protocollo: selezionare PagerDuty.
- URL:
  Digitare (o copiare e incollare) la parte chiave di integrazione dell'URL per la sottoscrizione PagerDuty. Questa parte è l'endpoint PagerDuty. Le altre parti dell'URL sono non modificabili.
Selezionare Crea.

La sottoscrizione PagerDuty è stata creata. Lo stato rimane "In sospeso" finché non viene ricevuta la conferma.
Conferma il nuovo abbonamento a PagerDuty:
1. Passare a PagerDuty.
2. Accedere all'incidente denominato "Conferma della sottoscrizione a Oracle Notification Service".
3. Selezionare il collegamento URL di conferma.
Esempio di incidente di conferma (al momento della pubblicazione del documento):

Ora che si dispone di una sottoscrizione confermata che fa riferimento all'endpoint PagerDuty, è possibile eseguire il test dell'integrazione pubblicando direttamente un messaggio nel relativo argomento padre.

Test di una sottoscrizione PagerDuty (pubblicazione diretta)

Per completare questa procedura, è necessario disporre dell'accesso alle notifiche e delle autorizzazioni per pubblicare i messaggi. Vedere Protezione delle notifiche (criteri IAM).

1. Nella pagina di elenco Argomenti, trovare l'argomento da utilizzare. Per informazioni su come trovare la pagina dell'elenco o l'argomento, vedere Elenco di argomenti.
2. Dal menu Azioni (tre punti) per l'argomento, selezionare Pubblica messaggio.
3. Nella finestra di dialogo Pubblica messaggio, fornire i valori per i seguenti campi: immettere gli elementi richiesti dal tipo di integrazione.
  
  Per Trasformatore eventi personalizzato, immettere un messaggio e un titolo.
  
  Messaggio di esempio: "È stato rilevato un utilizzo non ottimale. Un'applicazione o un processo può utilizzare più CPU del solito".
  
  Titolo di esempio: "Allarme non ottimale"
  
  Per Oracle Cloud Infrastructure Monitoring, immettere un messaggio contenente un oggetto BLOB JSON con coppie chiave-valore per severity (stringa, obbligatoria) e uno o più dei seguenti elementi: title (stringa), body (stringa) e alarmMetaData (blob o array JSON).
  
  BLOB JSON di esempio:
  { "title": "my test alarm", "body": "my test body", "severity": "warning", "alarmMetaData": { "key1": "value1", "key2": "value2" } }
  
  Il valore severity è flessibile per i test. Per l'ambiente di produzione, utilizzare un valore supportato da PagerDuty, ad esempio critical, error, warning o info.
4. Selezionare Pubblica.
  Viene attivato un incidente PagerDuty contenente il contenuto del messaggio.
  Esempio di incidente PagerDuty attivato (al momento della pubblicazione del documento):
  Esempio del contenuto di un incidente PagerDuty attivato (al momento della pubblicazione del documento):
  È stato confermato che la pubblicazione diretta di un messaggio attiva un incidente PagerDuty. Successivamente, utilizza la nuova sottoscrizione per attivare gli incidenti PagerDuty da allarmi, eventi e connettori.
  Nota
  
  Per controllare l'URL dell'endpoint o altri dettagli della sottoscrizione PagerDuty, vedere Recupero dei dettagli di una sottoscrizione. Per informazioni sulla risoluzione dei problemi relativi ai messaggi pubblicati, vedere Messaggio non ricevuto.
Utilizzare il comando oci ons message publish e i parametri richiesti per pubblicare un messaggio in un argomento:
oci ons message publish --body <message_text> --topic-id <topic_OCID>
Per un elenco completo dei parametri e dei valori per i comandi CLI, vedere Command Line Reference for Notifications.

Eseguire l'operazione PublishMessage per pubblicare un messaggio in un argomento.

Richiesta di esempio per un endpoint PagerDuty di tipo Trasformatore evento personalizzato:

POST /20181201/topics/<topic_OCID>/messages
Host: <topic API endpoint>
<authorization and other headers>
{
  "title": "Non-Optimal Alarm",
  "body": "Non-optimal utilization detected. An application or process may be consuming more CPU than usual."
}

Attiva un incidente PagerDuty

Attivare un incidente in PagerDuty da una sottoscrizione di allarme, evento, connettore o annuncio utilizzando una sottoscrizione in Notifiche.

Quando si crea una sottoscrizione all'allarme, alla regola evento, al connettore o all'annuncio, selezionare l'argomento Notifiche contenente la sottoscrizione PagerDuty. Per istruzioni sulla creazione di queste risorse, vedere:

Nota

Per controllare l'URL dell'endpoint o altri dettagli della sottoscrizione PagerDuty, vedere Recupero dei dettagli di una sottoscrizione.