Ya está disponible la integración de Capella Webhook Alert

Couchbase Capella™, nuestra oferta de base de datos como servicio, proporciona a los clientes una experiencia totalmente gestionada con rendimiento, escalabilidad, seguridad y capacidad de gestión incorporados. Ahora, con la integración de alertas webhook, los clientes pueden obtener fácilmente alertas de Capella en sus herramientas de terceros y utilizar los flujos de trabajo existentes para rastrear, investigar y resolver problemas de servicio a través de sus diversas cargas de trabajo de una manera centralizada.

Couchbase Capella ya proporciona notificaciones por correo electrónico para las alertas, pero esto por sí solo a veces puede ser limitante para las medianas y grandes empresas. Los SREs y desarrolladores a menudo quieren ser notificados en su herramienta de elección cuando se generan alertas en sus servicios Couchbase Capella. Con esta nueva capacidad, los clientes ahora pueden integrar las alertas de Capella con herramientas como ServiceNow a través de un webhook entrante que pueden configurar en Capella.

¿Qué son los Webhooks?

Los webhooks son retrollamadas HTTP definidas por el usuario. Cuando se produce una alerta en Capella, se realiza una petición HTTP a la URL del webhook configurada por el usuario, enviando la carga útil de la alerta JSON. Esto permite a los clientes invocar comportamientos personalizados en sus aplicaciones de terceros.

Como cliente de Capella, puede utilizar ServiceNow u otro sistema de gestión de incidencias como una única herramienta unificada para gestionar todas las incidencias de forma centralizada para su entorno de TI. Por ejemplo, siempre que se produzca una alerta en Capella, puede crear automáticamente un incidente en ServiceNow del mismo modo que lo hace para los incidentes generados por otras aplicaciones. 

Integrar las alertas de Capella mediante Webhooks  

La función de integración de alertas de Capella es genérica. Puede configurar integraciones de alertas para cualquier herramienta de terceros que admita un webhook entrante. Una integración de alerta requiere la URL de destino para el webhook y la autenticación y autorización básica o de token de portador. 

Estos son algunos de los principales detalles:

• • Cree, edite y elimine la configuración mediante la interfaz de usuario o la API de gestión pública.
  • Autenticación mediante Basic (nombre de usuario/contraseña) o token de portador (token de acceso).
  • Requiere una conexión segura, por lo que la URL del Webhook entrante debe comenzar por https.
  • Requiere suscripción Enterprise o Developer Pro.
  • Disponible tanto para bases de datos como para App Services.
  • En lugar de definir integraciones de alertas de forma repetitiva para cada base de datos o servicio de aplicaciones, puede configurar una única integración de alertas a nivel de proyecto. Puede limitar las notificaciones que envía una integración de alertas excluyendo bases de datos o servicios de aplicaciones específicos.

Los mensajes de notificación que envía una integración de alertas incluyen una carga útil que proporciona todos los detalles de la alerta en un conjunto de objetos JSON fáciles de leer.

Tutorial para recibir alertas de Capella en ServiceNow

Crear un Cuenta de desarrollador de ServiceNowsi lo necesitas. Utilice el API REST programadas y cree un nuevo recurso. Para utilizar la autenticación básica para su webhook, cree un nuevo usuario en ServiceNow con las credenciales que utilizará para la autenticación. Anote la URL y los datos de autenticación.

En Capella, añada un integración de alertas al proyecto con los detalles clave: Nombre, URL del Webhook e información de autenticación. Capella ofrece tanto un INTERFAZ DE USUARIO y un API de gestión de Capella para trabajar con integraciones de alertas. Pruebe la conexión y añada la integración.

Ahora, cuando se produce cualquier alerta de nivel crítico o de advertencia derivada de una métrica en Capella Databases o App Services, se envía automáticamente a ServiceNow.

Configuración en ServiceNow

Crear un Cuenta de desarrollador de ServiceNow si necesitas uno.

Asegúrese de que el rol de usuario está configurado como Admin. Haga clic en Empezar a construir para iniciar sesión en una instancia de desarrollador.

Buscar API REST programadasy haga clic en el botón Nuevo en la parte superior derecha de la página para crear un nuevo recurso. Introduzca el nombre de la API y haga clic en Enviar.

Ahora debería ver su API listada en la página. Haga clic en el nombre de la API para abrir una página de configuración. En la parte inferior de esta página, en Recursosseleccione Nuevo.

Introduzca el nombre que prefiera para el recurso y establezca la opción Método HTTP como POST. Puede utilizar el siguiente script de ejemplo para registrar la solicitud JSON en el archivo Registro del sistema. Para ver más ejemplos de scripts, consulte este ServiceNow enlace.

A continuación se muestra otro ejemplo de script que crea un incidente en el Service Desk=>Incidentes sección:

Haga clic en Explorar la API REST para anotar la URL asignada. Esta es la URL del Webhook que utilizará en Capella para configurar la integración.

• • Para utilizar la autenticación básica para su webhook, necesita crear un nuevo usuario en ServiceNow. 
    • En Administración de usuarios=>Usuarios crear un nuevo usuario. 
    • Busque el usuario recién creado y Establecer contraseña. Genere una nueva contraseña, asegúrese de desmarcar la casilla Es necesario restablecer la contraseñay actualice el usuario. Utilizará estas credenciales de usuario en Capella para configurar la integración.

Las cosas ya están configuradas en ServiceNow. Vamos a la interfaz de Capella.

Instalación en Capella 

• • Inicie sesión en Capella UI. 
  • Seleccione un proyecto en Capella y haga clic en la pestaña "Alertas". 
  • Haga clic en "Añadir integración". 
    • Proporcione un nombre de usuario fácil de usar. 
    • Proporcione la URL del Webhook de ServiceNow, seleccione Autenticación como "Básica" y proporcione el Nombre de Usuario y la Contraseña.
    • Haga clic en "Probar conexión" para validar que la conexión funciona. 
    • La "Conexión de prueba" en Capella enviará una carga útil de alerta JSON de prueba a la URL Webhook en ServiceNow. Salva la integración. 

Revise la alerta de prueba recibida en ServiceNow.

En ServiceNow seleccione Todos => Registro del Sistema => Script Log Statements y filtrar los registros para ver el Capella TestAlert que se recibe.

Resumen

¡Enhorabuena! Ya está configurado para recibir alertas de Capella en tiempo real en ServiceNow. Aunque el procedimiento paso a paso anterior está detallado para ServiceNow, la función de integración de alertas de Capella es genérica. Puede configurar integraciones de alertas para cualquier herramienta de terceros que admita un webhook entrante y autenticación y autorización básicas o de token de portador.

Conclusión

La integración de notificaciones de alerta de Capella puede utilizarse para recibir alertas en la herramienta de terceros que elija. Esto le permite rastrear, investigar y resolver problemas de servicio a través de sus diversas cargas de trabajo de forma centralizada utilizando flujos de trabajo familiares.

He aquí algunos recursos adicionales que pueden resultarle útiles:

• • Capella: Configurar una integración de alertas
  • Capella: API de gestión de Couchbase Capella (v4.0)
  • Capella: Referencia de alerta
  • ServiceNow: Cómo integrar Webhooks en ServiceNow
  • ServiceNow: Scripted REST APIs
  • ServiceNow: Cómo generar token de portador para oAuth 2.0 - Tipo de concesión de autorización

Si es nuevo en Couchbase CapellaPruébela y vea cómo una plataforma de base de datos polivalente puede ayudarle a crear aplicaciones potentes. Puede empezar a trabajar en cuestión de minutos con una prueba gratuita (sin necesidad de tarjeta de crédito). Capella iQ's La IA generativa está integrada y puede ayudarle a empezar a escribir sus primeras consultas con texto en lenguaje natural.