Configuración de una integración saliente para conectar IBM Cloud Logs con IBM Cloud Event Notifications
Para enviar eventos que se generan cuando se activa una alerta en una instancia de IBM Cloud Logs, debe conectar su instancia de IBM Cloud Logs a Event Notifications configurando una integración saliente.
Requisitos previos
- Más información sobre alertas en IBM Cloud Logs. Para más información, véase Alertas.
- Obtenga información sobre IBM Cloud Event Notifications. Para obtener más información, consulte ¿Qué es IBM Cloud Event Notifications?
- Antes de habilitar las notificaciones para IBM Cloud Logs, asegúrese de que dispone de una instancia Event Notifications y de permisos para configurar recursos en la instancia Event Notifications.
Paso 1. Definir una autorización de servicio a servicio
Se utiliza una autorización de servicio a servicio en la IBM Cloud cuenta para autorizar al IBM Cloud Logs servicio a enviar eventos al Event Notifications servicio.
Debe configurar una autorización de servicio a servicio entre la instancia IBM Cloud Logs y la instancia Event Notifications. Para obtener más información, consulte Creación de una autorización S2S para trabajar con el servicio IBM Cloud Event Notifications.
Paso 2. Configuración de una integración saliente mediante la API
Puede crear una integración saliente utilizando la API. Para más información sobre el método API, consulte Crear una integración saliente.
Sólo puede configurar a través de la API la integración entre una instancia de IBM Cloud Logs y una instancia de Event Notifications que se encuentren en cuentas diferentes.
Por ejemplo, puede utilizar el siguiente comando cURL para crear una integración a través de la 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"
}
}'
Donde
-
API-ENDPOINT: Establezca el punto final de la API para la instancia IBM Cloud Logs. -
type: Define el tipo de integración. Establecido en ibm_event_notifications. -
name: Introduzca un nombre para esta definición de recurso. -
IAM_TOKEN: Introduzca el IAM_TOKEN. Puede ejecutar el siguiente comando para obtener el token IAM:export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'` -
event_notifications_instance_id: Establece el ID de instancia de Event Notifications. -
region_id: Establezca la región en la que está disponible la instancia Event Notifications. -
endpoint_type: Defina si la integración se realiza a través de la red pública o privada. Los valores válidos son:default_or_publicoprivate
Paso 2. Configuración de una integración saliente en la interfaz de usuario
Complete los siguientes pasos para configurar una integración saliente:
- En la consola, haga clic en el icono Menú de navegación
> Lista de recursos.
- Seleccione la instancia de IBM Cloud Logs.
- En la navegación " IBM Cloud Logs ", haga clic en el icono " Integraciones " "
> " Integraciones salientes.
- En la sección de integraciones salientes, busque Event Notifications y haga clic en Añadir.
- En la página Integraciones, haga clic en Añadir nueva.
- Si no existe una autorización IAM entre IBM Cloud Logs y Event Notifications en su cuenta, debe configurar una haciendo clic en Autorizaciones IAM. Siga las indicaciones para otorgar acceso entre los servicios. Para obtener más información, consulte Creación de una autorización S2S para trabajar con el servicio IBM Cloud Event Notifications.
- Escriba un nombre para la integración.
- Seleccione la Event Notifications instancia de servicio que desea conectar a su IBM Cloud Logs instancia.
- Seleccione el Tipo de punto final como público o privado. Para más información, consulte Puntos finales de servicio para Event Notifications
- Para confirmar la conexión, haga clic en Guardar.
Se crea una fuente IBM Cloud Event Notifications con el siguiente nombre:
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>
Por ejemplo, el nombre de la fuente en IBM Cloud Event Notifications tiene el siguiente aspecto:
IBM Cloud Logs - rfdt3147-484f-4dee-b3c7-ab0c85a8e5c7
El nombre de la integración saliente no se utiliza para nombrar la fuente en la instancia IBM Cloud Event Notifications.
Probar la conexión
Después de activar las notificaciones para IBM Cloud Logs, pruebe su conexión para asegurarse de que los eventos generados por IBM Cloud Logs se reenvían a Event Notifications.
En primer lugar, complete los siguientes pasos en la instancia Event Notifications:
-
Compruebe que el origen con nombre
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>, que coincide con el nombre de su integración, se crea en la instancia IBM Cloud Event Notifications.- Seleccionar fuentes.
- Busque la fuente con el nombre
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>.
-
Cree un tema que especifique esta instancia de Cloud Logs como origen y "Tipo de evento" con el ámbito "Evento de prueba".
- Seleccione Temas. A continuación, pulse en Crear.
- Introduzca un nombre de tema, por ejemplo,
CloudLogsInstance-test. - Seleccione la fuente
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>para la instancia cuya integración desea probar. - Seleccione el tipo de evento Evento de prueba.
- Seleccione Añadir una condición > Guardar fuente.
- Pulse Crear.
-
Cree un destino y compruebe que está configurado. Por ejemplo, puede configurar un destino Slack o un correo electrónico.
-
Cree una Suscripción emparejando el tema y el destino.
- Introduzca un nombre, por ejemplo,
Test integration. - Seleccione el tema
CloudLogsInstance-test. - Selecciona un destino.
- Pulse Crear.
- Introduzca un nombre, por ejemplo,
A continuación, en la IBM Cloud Logs UI, complete los siguientes pasos:
- Edite la integración saliente.
- Pulse Probar.
- Compruebe el destino elegido y verifique que se ha enviado el evento de prueba.