Ingesta de alertas de herramientas de terceros en OpManager

En entornos empresariales complejos, los equipos de TI suelen depender de múltiples herramientas de monitoreo para gestionar distintos sistemas: servidores, redes, aplicaciones y más. OpManager permite la ingesta de alertas desde estas herramientas de terceros, a través de varios métodos flexibles y estandarizados. Integrar eventos de terceros en OpManager te permite consolidar los datos de eventos y obtener visibilidad centralizada de todo tu entorno de TI, sin importar la fuente.

Este documento de ayuda explica los métodos compatibles y proporciona pasos detallados para que puedas configurar fácilmente la ingesta de eventos.

• REST API
  • Usando form data (datos de formulario)
  • Usando parámetros en la URL (Query parameters)
  • Usando scripts personalizados

REST API

OpManager ofrece APIs REST y Webhooks versátiles que permiten a herramientas de terceros enviar alertas directamente a su sistema de monitoreo. Al ingerir eventos por medio de la API, las organizaciones pueden centralizar alertas de toda su infraestructura de TI, lo que habilita una vista unificada del estado de la red y permite una respuesta más rápida ante incidentes.

La API addEvent permite que aplicaciones de terceros envíen datos de eventos directamente a OpManager utilizando su API REST nativa o capacidades de webhook.

Endpoint: api/json/events/addEvent

Método: POST

Formatos compatibles: Form Data, Query Parameters

Autenticación: API Key

Usando form data (datos de formulario)

Puedes enviar datos de eventos a OpManager realizando una solicitud POST con datos codificados como formulario. Este método es ideal para herramientas que soportan el envío de datos como application/x-www-form-urlencoded.

POST https://<OpManager_Server>:8060/api/json/events/addEvent
Headers: Content-Type: application/x-www-form-urlencoded
Form data: source=Test_Device_MoName severity=1 message=Sample_Critical_Message alarmCode=Sample_AlarmCode entity=Sample_Entity eventType=Sample_EventType apiKey=***

Usando parámetros en la URL (Query parameters)

POST https://<OpManager_Server>:8060/api/json/events/addEvent?source=Test_Device_MoName&severity=1&message=Sample_Critical_Message&alarmCode=Sample_AlarmCode&entity=Sample_Entity&eventType=Sample_EventType&apiKey=***

Para ingresar alertas de dispositivos Cisco Meraki usando payloads JSON, consulta este documento.

Usando scripts personalizados

Los usuarios pueden crear scripts personalizados para reenviar automáticamente eventos desde herramientas de terceros a OpManager como alertas. A continuación, se muestran ejemplos de scripts sobre cómo enviar dichas alertas a OpManager.

Ejemplo: PowerShell (Windows)

# Definir los datos a enviar como un hashtable 
$formData = @{ 
apiKey=@nbsp;"***" 
source=@nbsp;"Windows_Server" 
severity@nbsp;=@nbsp;"1" 
message=@nbsp;"Espacio en disco bajo" 
alarmCode=@nbsp;"Disk_Space_Alert" 
entity@nbsp;=@nbsp;"Server_XYZ" 
eventType=@nbsp;"Performance_Alert" 
} 
 
# Enviar la solicitud POST con datos codificados como formulario
Invoke-RestMethod -Uri "https://<OpManager_Server>:8060/api/json/events/addEvent" ` 
-Method Post ` 
-Body $formData ` 
-ContentType "application/x-www-form-urlencoded" 

Ejemplo: Bash (Linux)

# Detalles del servidor OpManager 
OPMANAGER_HOST="https://<OpManager_Server>:8060" 
API_ENDPOINT="/api/json/events/addEvent" 
 
# API key 
API_KEY="your_api_key_here" 
 
# Datos de formulario 
curl -k -X POST "${OPMANAGER_HOST}${API_ENDPOINT}" \ 
-H "Content-Type: application/x-www-form-urlencoded" \ 
--data "apiKey=${API_KEY}" \ 
--data "source=Windows_Server" \ 
--data "severity=1" \ 
--data "message=Espacio en disco bajo" \ 
--data "alarmCode=Disk_Space_Alert" \ 
--data "entity=Server_XYZ" \ 
--data "eventType=Performance_Alert"