Configurazione di un'integrazione in uscita per collegare IBM Cloud Logs con IBM Cloud Event Notifications

Per inviare gli eventi generati quando viene attivato un avviso in un'istanza IBM Cloud Logs, è necessario collegare l'istanza IBM Cloud Logs a Event Notifications configurando un'integrazione in uscita.

Prerequisiti

Per saperne di più sugli avvisi, consultare IBM Cloud Logs. Per ulteriori informazioni, vedere Avviso.
Imparare a conoscere IBM Cloud Event Notifications. Per ulteriori informazioni, vedere Cos'è IBM Cloud Event Notifications?
Prima di poter abilitare le notifiche per IBM Cloud Logs, assicurarsi di avere un' istanza Event Notifications e i permessi per configurare le risorse dell'istanza Event Notifications.

Passo 1. Definire un'autorizzazione da servizio a servizio

Un'autorizzazione da servizio a servizio viene utilizzata nell'account IBM Cloud per autorizzare il servizio IBM Cloud Logs a inviare eventi al servizio Event Notifications.

È necessario configurare un servizio di autorizzazione tra l'istanza IBM Cloud Logs e l'istanza Event Notifications. Per ulteriori informazioni, vedere Creazione di un'autorizzazione S2S per lavorare con il servizio IBM Cloud Event Notifications.

Passo 2. Configurazione di un'integrazione in uscita tramite API

È possibile creare un'integrazione in uscita utilizzando l'API. Per ulteriori informazioni sul metodo API, vedere Creare un'integrazione in uscita.

È possibile configurare tramite API solo l'integrazione tra un'istanza di IBM Cloud Logs e un'istanza di Event Notifications che si trovano in account diversi.

Ad esempio, si può usare il seguente comando cURL per creare un'integrazione tramite API:

curl -X POST "https://API-ENDPOINT/v1/outgoing_webhooks" \
 -H "Authorization: ${IAM_TOKEN}" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \
 -d '{
  "type": "ibm_event_notifications",
  "name": "<NAME>",
  "ibm_event_notifications": {
   "event_notifications_instance_id": "<EventNotificationsInstanceID>",
   "region_id": "<Region-of-EventNotifications-Instance>",
   "endpoint_type": "default_or_public"
  }
 }'

Dove

API-ENDPOINT: Imposta l'endpoint API per l'istanza di IBM Cloud Logs.
type: Definisce il tipo di integrazione. Impostato su ibm_event_notifications.
name: Inserire un nome per questa definizione di risorsa.
IAM_TOKEN: Inserire lo IAM_TOKEN. È possibile eseguire il seguente comando per ottenere il token IAM:
```
export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
```
event_notifications_instance_id: Imposta l'ID dell'istanza Event Notifications.
region_id: Impostare la regione in cui è disponibile l'istanza di Event Notifications.
endpoint_type: Definire se l'integrazione passa attraverso la rete pubblica o privata. I valori validi sono: default_or_public o private

Passo 2. Configurazione di un'integrazione in uscita nell'interfaccia utente

Completare i seguenti passaggi per configurare un'integrazione in uscita:

Nella console, fare clic sull'icona del menu di navigazione > Elenco risorse.
Selezionare l'istanza di IBM Cloud Logs.
Nella navigazione IBM Cloud Logs, fare clic sull'icona Integrazioni > Integrazioni in uscita.
Nella sezione delle integrazioni in uscita, trovare Event Notifications e fare clic su Aggiungi.
Nella pagina Integrazioni, fare clic su Aggiungi nuovo.
Se nel proprio account non esiste un'autorizzazione IAM tra IBM Cloud Logs e Event Notifications, è necessario configurarla facendo clic su Autorizzazioni IAM. Seguite le richieste per concedere l'accesso tra i servizi. Per ulteriori informazioni, vedere Creazione di un'autorizzazione S2S per lavorare con il servizio IBM Cloud Event Notifications.
Immetti un nome per l'integrazione.
Selezionare l'istanza del servizio Event Notifications che si vuole collegare all'istanza IBM Cloud Logs.
Selezionare il tipo di endpoint come pubblico o privato. Per ulteriori informazioni, vedere Endpoint di servizio per le Event Notifications
Per confermare la connessione, fare clic su Salva.

Viene creata una sorgente IBM Cloud Event Notifications con il seguente nome:

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

Ad esempio, il nome sorgente in IBM Cloud Event Notifications si presenta come segue:

IBM Cloud Logs - rfdt3147-484f-4dee-b3c7-ab0c85a8e5c7

Il nome dell'integrazione in uscita non viene utilizzato per denominare la sorgente nell'istanza IBM Cloud Event Notifications.

Esecuzione di un test sulla connessione

Dopo aver abilitato le notifiche per IBM Cloud Logs, verificare la connessione per assicurarsi che gli eventi generati da IBM Cloud Logs vengano inoltrati a Event Notifications.

Per prima cosa, completare i seguenti passaggi nell'istanza Event Notifications:

Verificare che la sorgente con nome IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>, che corrisponde al nome dell'integrazione, sia creata nell'istanza IBM Cloud Event Notifications.
1. Selezionare le fonti.
2. Cercare la fonte con il nome IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>.
Creare un argomento che specifichi questa istanza di Cloud Logs come origine e "Tipo di evento" con ambito "Evento di prova".
1. Selezionare gli argomenti. Quindi, fai clic su Create.
2. Immettere il nome di un argomento, ad esempio CloudLogsInstance-test.
3. Selezionare l'origine IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> per l'istanza di cui si vuole verificare l'integrazione.
4. Selezionare il tipo di evento Evento di prova.
5. Selezionare Aggiungi una condizione > Salva origine.
6. Fai clic su Crea.
Creare una destinazione e verificare che sia configurata. Ad esempio, è possibile configurare una destinazione Slack o un'e-mail.
Creare una Sottoscrizione che associa l'argomento e la destinazione.
1. Inserire un nome, ad esempio Test integration.
2. Selezionare l'argomento CloudLogsInstance-test.
3. Selezionare una destinazione.
4. Fai clic su Crea.

Quindi, nell'interfaccia IBM Cloud Logs, completare i passaggi seguenti Completare i seguenti passaggi:

Modificare l'integrazione in uscita.
Fare clic su Test.
Controllare la destinazione scelta e verificare che l'evento di prova sia stato inviato.