Creazione di un'attività di notifica

1. Nel titolo, indicare un titolo per la destinazione.
2. Nella casella Descrizione, fornire una descrizione.
3. Per configurare Webhook, completare i seguenti passaggi:
   1. Selezionare Webhook come type.
   2. Selezionare un'opzione dall'elenco Method per specificare il metodo HTTP per la destinazione. Le opzioni disponibili sono POST, PUT e PATCH.
   3. Nel campo Webhook URL , inserire l'endpoint di destinazione HTTP (S).
   4. Opzionale: Fare clic su Aggiungi + per includere intestazioni aggiuntive di HTTP.
4. Per configurare PagerDuty,, procedere come segue:
   1. Selezionare PagerDuty come tipo.
   2. Inserite il vostro pagerduty integration routing key nel campo Routing key . Per ulteriori informazioni su pagerduty integration, consultare la sezione Servizi e integrazioni.
      Nota: per l'integrazione con PagerDuty,, selezionare Events API v2 come tipo di integrazione.
5. Per configurare Slack, completare i seguenti passaggi:
   1. Selezionare Slack come tipo.
   2. Nel campo Token , inserire il token API di Slack.
   3. Nel campo Channel ID , inserite il vostro Channel ID. Per ulteriori informazioni su questo argomento Token and Channel ID, consulta la guida "Come ottenere e utilizzare rapidamente un token per un bot API di Slack ".
      Nota: utilizzare l'ID del canale, non il nome del canale. Ad esempio: C1234567890.
6. Per configurare Amazon Simple Notification Service, completare i seguenti passaggi:
   Nota: Per abilitare Amazon SNS for Engagement, è necessario creare il segreto del client AWS e fare riferimento al segreto nel file YAML della risorsa personalizzata di analisi. Per ulteriori informazioni, vedere Attivazione di Amazon SNS.
   1. Selezionare Amazon SNS come tipo.
   2. Nel campo ARN argomento, inserire l'ARN dell'argomento Amazon SNS.
   3. Nel campo ARN ruolo, immettere l'ARN del ruolo Amazon SNS.
7. Per configurare il bridge Kafka HTTP, completare i passaggi seguenti:
   1. Selezionare Webhook come type.
   2. Selezionare un'opzione dall'elenco Method per specificare il metodo HTTP per la destinazione. Le opzioni disponibili sono POST, PUT e PATCH.
   3. Nel campo Webhook URL , inserire l'endpoint di destinazione HTTP (S).

      http://<route-name>.apps.<cluster-name>.<namespace>.com/topics/<topic-name>

      Per ulteriori informazioni sulla Kafka HTTP Bridge configurazione, consultare la sezione "Connessione tramite HTTP con un bridge Kafka ".
   4. Fare clic su Aggiungi + per aggiungere un'intestazione a HTTP.
   5. Nel file Name , inserire content-type.
   6. Nel campo Value , inserire application/vnd.kafka.json.v2+json.
   7. Definire il payload JSON da inviare all'argomento Kafka nell'azione di attivazione della regola.
   Nota: verificare l'impostazione di Kafka e regolare il formato del payload, se necessario. L'esempio seguente mostra un formato di messaggio JSON richiesto da alcune implementazioni di Kafka :

   {
        "records": [
           {
               "key": "my-key",
               "value": "my-value"
           }
       ]
   }

8. Per configurare IBM MQ, procedere come segue:
   1. Selezionare Webhook come type.
   2. Selezionare un'opzione dall'elenco Method per specificare il metodo HTTP per la destinazione. Le opzioni disponibili sono POST, PUT e PATCH.
   3. Nel campo Webhook URL , inserire l'endpoint di destinazione HTTP (S).

      https://<host>:<port>/ibmmq/rest/v3/messaging/qmgr/<your_qm_name>/queue/<your_queue_name>/message

      Per ulteriori informazioni su IBM MQ messaging REST API, consultare l'API REST di messaggistica di IBM MQ.
   4. Fare clic su Aggiungi + per aggiungere un'intestazione a HTTP.
   5. Nel file Name , inserire content-type.
   6. Nel campo Value , inserire il valore del tipo di contenuto utilizzato, ad esempio: text/plain;charset=utf-8.
   7. Fare clic su Aggiungi + per aggiungere una seconda intestazione HTTP.
   8. Nel file Name , inserire authorization.
   9. Nel campo Value , inserire Basic <base64encodedstring>.

      dove:

      • base64encodedstring è la codifica in base 64 di username:password .
   10. Fare clic su Aggiungi + per aggiungere una terza intestazione HTTP.
   11. Nel file Name , inserire ibm-mq-rest-csrf-token.
   12. Il campo del valore può essere lasciato vuoto.
       Nota: assicurarsi che questa intestazione sia inclusa, anche se il campo del valore è vuoto, poiché il Queue Manager di IBM MQ rifiuta il payload in sua assenza.
9. Per configurare IBM Cloud Event Notification Service, completare i seguenti passaggi:
   Nota: Le destinazioni di IBM Cloud Event Notification Service non sono collegate alle destinazioni di API Connect. È necessario configurare la destinazione in IBM Cloud Event Notification Service prima di configurare Engagement in API Connect.
   1. Selezionare Webhook come type.
   2. Selezionare POST dall'elenco Method per specificare il metodo HTTP per la destinazione.
   3. Nel campo Webhook URL , inserire l'endpoint di destinazione HTTP (S).

      {base_url}/v1/instances/{instance_id}/notifications 

      dove:

      url_base

      Inserire il percorso di base URL

      instance_id

      Inserire l'identificatore corrispondente all'istanza

      Per ulteriori informazioni su IBM Cloud Event Notification Service, consultare l'API delle notifiche degli eventi.
   4. Fare clic su Aggiungi + per aggiungere un'intestazione a HTTP.
   5. Nel file Name , inserire content-type.
   6. Nel campo Value , inserire application/json.
   7. Fare clic su Aggiungi + per aggiungere una seconda intestazione HTTP.
   8. Nel file Name , inserire Authorization.
   9. Nel campo Value , inserire il token IAM.
   10. Definire il payload JSON da inviare al servizio di notifica nell'azione di attivazione della regola. Per ulteriori informazioni, consulta l'API delle notifiche degli eventi.

1. Nel campo Titolo, indicare il nome Title per la regola.
2. Nella sezione Pianificazione, specificare una pianificazione per l'esecuzione di questa regola. È possibile specificare una pianificazione definendo un intervallo di tempo o una stringa cron.
3. Fare clic su Avanti per selezionare i dati e definire la query.
4. Nella sezione Seleziona dati, selezionare un'opzione dall'elenco Origine dati in base ai dati su cui si desidera eseguire la regola.
5. Nella sezione Query, definire la metrica di aggregazione che si desidera utilizzare per la query. L'impostazione predefinita è un conteggio dei record corrispondenti. È inoltre possibile utilizzare aggregazioni matematiche per i campi numerici, come il valore massimo o la media su un periodo di tempo.
6. Nei campi Intervallo di tempo dei dati per l'ultimo, inserire l'intervallo di tempo in base all'intervallo di tempo in cui si desidera eseguire la ricerca degli elementi di dati corrispondenti.
7. Fare clic su Aggiungi filtro + per selezionare fino a 7 filtri di dati in base ai dati che si desidera includere durante l'esecuzione della query. È possibile utilizzare uno qualsiasi dei campi del record dell'evento di analisi.
8. Fare clic su Aggiungi gruppo per + per selezionare un gruppo in base a come si desidera raggruppare i dati selezionati e ottimizzare i criteri di destinazione. Ad esempio, una regola che corrisponde a 10 eventi API con un codice di stato 500 in un periodo di 24 ore può utilizzare " Group by su " api_name per richiamare 10 eventi corrispondenti per una singola API, anziché un totale di tutti gli eventi per tutte le API.
9. Fare clic su Avanti per configurare i trigger.

Aggiungere i trigger + :

1. Fare clic su Aggiungi trigger +. È possibile aggiungere fino a 5 trigger.
2. Nella sezione Dettagli trigger, fornire un 'Title per il trigger e quindi selezionare il livello di gravità e la condizione di trigger dagli elenchi corrispondenti.
3. Dall'elenco a discesa Gravità, selezionare un'opzione.
4. Nella sezione Condizione di attivazione, impostare una condizione come necessario.

   Definire il target numerico, che consente a una singola regola di avere più trigger con gravità e condizioni di attivazione diverse. Quando i criteri specificati sono soddisfatti, ogni trigger può attivare fino a 3 azioni, che poi invocano endpoint diversi o con payload diversi.

Aggiungere azioni:

1. Fare clic su Aggiungi azione + per configurare l'azione da eseguire quando i criteri di attivazione sono soddisfatti.
2. Nella sezione Azione scatenante, fornire un title per l'azione,
3. Dall'elenco Destinazione, selezionare la destinazione da richiamare quando i criteri sono soddisfatti.
4. Abilitare il throttling e definire la finestra di throttling per evitare che vengano invocati più trigger per la stessa regola nello stesso periodo di tempo.
5. Nella sezione Payload (Carico utile), fornire un oggetto del messaggio e un valore del carico utile. È possibile aggiungere variabili di contesto nel campo Payload in base alle informazioni sul carico utile dell'attività che si desidera visualizzare nella destinazione. Per ulteriori informazioni, consultare la sezione "Variabili di contesto nel payload dell'attività".
   Nota: L'oggetto del messaggio non viene inviato all'endpoint HTTP. Il valore del payload funge da corpo HTTP dell'attività di notifica inviata all'endpoint di destinazione