Para que Portail ZAPP reciba las alertas de una herramienta de supervisión, se declara esa herramienta como origen. Cada origen tiene su propia clave de integración: la herramienta la envía con cada evento y Portail ZAPP rechaza cualquier envío sin una clave válida.
La pantalla Orígenes de supervisión está reservada a los grupos Administradores de supervisión, Administradores del Service Desk y Administradores. Se abre desde la Consola de alertas (botón Orígenes de supervisión).
La lista de orígenes
La lista muestra, para cada origen, su nombre, su estado (Activo o Desactivado), su Caudal máx./min, sus Alertas abiertas y la fecha de su Último evento. Una etiqueta Clave revocada señala un origen cuya clave ha sido revocada.
Crear un origen
Haz clic en Nuevo origen e indica:
- Nombre y Descripción;
- Caudal máximo (eventos por minuto): por encima, los eventos de este origen se rechazan. El valor por defecto es 120;
- Formato de los eventos: cómo escribe la herramienta sus envíos (ver más abajo).
Al guardar, la Clave de integración se muestra una sola vez: «Copia esta clave ahora: no se volverá a mostrar.» El botón Copiar la pone en el portapapeles. La página muestra también la dirección que hay que indicar en la herramienta y un ejemplo de envío. Haz clic en He copiado la clave cuando la tengas a buen recaudo.
Portail ZAPP nunca conserva la clave en claro. Si se pierde, regénérala (ver más abajo).
Los formatos reconocidos
| Formato | Para qué herramientas |
|---|---|
| Estándar (PagerDuty Events v2) | Zabbix (tipo de medio PagerDuty), Datadog, Nagios, Centreon, PRTG y la mayoría de las herramientas, que pueden enviar este formato. En la herramienta, elige la integración PagerDuty (Events API v2) e indica la dirección y la clave del origen como «routing key» o «integration key» |
| Prometheus Alertmanager | Un receptor webhook en Alertmanager, con send_resolved para que la resolución cierre la alerta |
| Azure Monitor (esquema de alerta común) | Una acción Webhook en un grupo de acciones de Azure, con el esquema de alerta común activado |
| CloudEvents 1.0 | Las integraciones a medida |
| Correspondencia libre (JSON) | Una herramienta antigua que solo envía JSON libre: indicas dónde encontrar cada información |
Los formatos reconocidos funcionan sin configuración. La ficha del origen muestra, en el bloque Conectar la herramienta de supervisión, la Dirección del punto de entrada propia de su formato y los pasos que hay que seguir.
Enviar la clave: la herramienta la envía en el encabezado «Authorization: Bearer» o «X-Routing-Key». Usa el parámetro routing_key de la dirección solo si la herramienta no puede añadir encabezados, como el webhook de Azure Monitor: una dirección puede aparecer en los registros de un proxy.
La correspondencia libre
Con el formato Correspondencia libre (JSON), la ficha muestra la Correspondencia de campos. Para cada información, indica la ruta donde se lee en el JSON de la herramienta: nombres separados por puntos y el índice de una matriz entre corchetes (hosts[0].name).
- Resumen y Host son obligatorios;
- Clave de deduplicación, Gravedad, Fecha, Componente, Grupo y Clase son opcionales. Sin clave de deduplicación, la sustituye una huella del host, del componente y de la clase;
- Campo acción, Valores que resuelven y Valores que reconocen indican cuándo un envío resuelve o reconoce la alerta;
- Matriz de alertas (opcional): si la herramienta envía varias alertas a la vez;
- Detalles conservados (vacío: todo): la información que se guarda en los detalles sin procesar de la alerta;
- Tabla de gravedades: una línea por valor de la herramienta, por ejemplo
Disaster=critical.
Probar con un ejemplo
El bloque Probar con un ejemplo de la ficha comprueba la conexión antes de confiar en ella: pega un envío real de la herramienta y haz clic en Probar. El envío se lee exactamente como en el punto de entrada, con el formato y la correspondencia introducidos. El resultado muestra los Eventos leídos (acción, clave, resumen, host, gravedad, componente) o los Errores de lectura. No se guarda nada.
Desactivar un origen, regenerar o revocar su clave
En la ficha de un origen:
- desmarca Origen activo (eventos aceptados) para rechazar sus eventos sin tocar su clave;
- Regenerar la clave crea una clave nueva, que se muestra una sola vez. La anterior deja de funcionar de inmediato: recuerda actualizar la herramienta;
- Revocar la clave rechaza los eventos del origen hasta la próxima regeneración.
Después
Una vez conectado el origen, sus alertas llegan a la Consola de alertas. Para vincularlas a los CI de la CMDB y abrir incidentes automáticamente, ver «Automatizar el tratamiento de las alertas».