Configurando uma integração de saída para conectar IBM Cloud Logs com IBM Cloud Event Notifications

Para enviar eventos que são gerados quando um alerta é acionado em uma instância IBM Cloud Logs, é necessário conectar a instância IBM Cloud Logs a Event Notifications configurando uma integração de saída.

Pré-requisitos

Saiba mais sobre alertas em IBM Cloud Logs. Para obter mais informações, consulte Alertas.
Aprenda sobre IBM Cloud Event Notifications. Para obter mais informações, consulte O que é IBM Cloud Event Notifications ?.
Antes de ativar as notificações para IBM Cloud Logs, certifique-se de que você tenha uma instância Event Notifications e permissões para configurar recursos na instância Event Notifications.

Etapa 1. Definir uma autorização de serviço para serviço

Uma autorização de serviço para serviço é usada na conta IBM Cloud para autorizar o serviço IBM Cloud Logs a enviar eventos para o serviço Event Notifications.

Você deve configurar um serviço para autorização de serviço entre a instância IBM Cloud Logs e a instância Event Notifications. Para obter mais informações, consulte Criando uma autorização S2S para trabalhar com o serviço IBM Cloud Event Notifications.

Etapa 2. Configuração de uma integração de saída usando a API

Você pode criar uma integração de saída usando a API. Para obter mais informações sobre o método API, consulte Criar uma integração de saída.

Você só pode configurar via API a integração entre uma instância IBM Cloud Logs e uma instância Event Notifications que estejam localizadas em contas diferentes.

Por exemplo, você pode usar o seguinte comando cURL para criar uma integração via 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"
  }
 }'

em que

API-ENDPOINT: Defina o ponto de extremidade da API para a instância IBM Cloud Logs.
type: Define o tipo de integração. Definido como ibm_event_notifications.
name: Digite um nome para essa definição de recurso.
IAM_TOKEN: Digite o IAM_TOKEN. Você pode executar o seguinte comando para obter o token IAM:
```
export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
```
event_notifications_instance_id: Defina como a ID da instância Event Notifications.
region_id: Defina como a região em que a instância Event Notifications está disponível.
endpoint_type: Defina se a integração passa pela rede pública ou privada. Os valores válidos são: default_or_public,ou private

Etapa 2. Configuração de uma integração de saída na interface do usuário

Conclua as etapas a seguir para configurar uma integração de saída:

No console, clique no ícone Menu de navegação > Lista de recursos.
Selecione sua instância do IBM Cloud Logs.
Na navegação " IBM Cloud Logs, clique no ícone " Integrações, " > " Integrações de saída.
Na seção de integrações de saída, encontre Event Notifications e clique em Adicionar.
Na página Integrações, clique em Adicionar novo.
Se uma autorização do IAM entre IBM Cloud Logs e Event Notifications não existir na sua conta, você deverá configurar uma clicando em Autorizações do IAM. Siga os prompts para conceder acesso entre os serviços. Para obter mais informações, consulte Criando uma autorização S2S para trabalhar com o serviço IBM Cloud Event Notifications.
Insira um nome para a integração.
Selecione a instância de serviço Event Notifications que você deseja conectar à sua instância IBM Cloud Logs.
Selecione o tipo de ponto de extremidade como público ou privado. Para obter mais informações, consulte Pontos de extremidade de serviço para Event Notifications
Para confirmar a conexão, clique em Save (Salvar ).

Uma fonte IBM Cloud Event Notifications é criada com o seguinte nome:

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

Por exemplo, o nome da fonte em IBM Cloud Event Notifications tem a seguinte aparência:

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

O nome da integração de saída não é usado para nomear a origem na instância IBM Cloud Event Notifications.

Teste sua conexão

Depois de ativar as notificações para IBM Cloud Logs, teste sua conexão para garantir que os eventos gerados por IBM Cloud Logs estejam sendo encaminhados para Event Notifications.

Primeiro, conclua as etapas a seguir na instância Event Notifications:

Verifique se a fonte com o nome IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>, que corresponde ao nome de sua integração, foi criada na instância IBM Cloud Event Notifications.
1. Selecione as fontes.
2. Procure a fonte com o nome IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>.
Crie um tópico que especifique essa instância do Cloud Logs como a origem e o "Tipo de evento" com escopo de "Evento de teste".
1. Selecione Tópicos. Em seguida, clique em Criar.
2. Digite um nome de tópico, por exemplo, CloudLogsInstance-test.
3. Selecione a fonte IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> para a instância cuja integração você deseja testar.
4. Selecione o tipo de evento Test Event (Evento de teste ).
5. Selecione Adicionar uma condição > Salvar fonte.
6. Clique em Criar.
Crie um destino e verifique se o destino está configurado. Por exemplo, você pode configurar um destino do Slack ou um e-mail.
Crie uma assinatura associando o tópico e o destino.
1. Digite um nome, por exemplo, Test integration.
2. Selecione o tópico CloudLogsInstance-test.
3. Selecione um destino.
4. Clique em Criar.

Em seguida, na interface do IBM Cloud Logs Conclua as etapas a seguir:

Edite a integração de saída.
Clique em Teste.
Verifique o destino escolhido e verifique se o evento de teste foi enviado.