Ayuda y guíasMonitores avanzados › Multi-step / API monitoring

Multi-step / API monitoring

5 min de lectura · Monitores avanzados

La monitorización multipaso ejecuta como un único monitor una secuencia de solicitudes HTTP: inicia sesión, guarda un token, lo usa en el siguiente paso y verifica la respuesta mediante JSONPath. Es ideal para monitorizar API y flujos de inicio de sesión donde una sola solicitud no basta. Disponible en los planes Pro y Business para monitores HTTP.

¿Dónde lo configuro?

  1. Abra la página de detalle de un monitor HTTP.
  2. En la sección Multi-step / API monitoring, pegue la lista JSON de pasos y haga clic en Guardar.
  3. Un campo vacío devuelve el monitor a una comprobación simple clásica.

Formato del paso

Los pasos son una lista JSON (máx. 10). Cada paso es un objeto con estos campos:

  • url - la dirección del paso (obligatorio). Puede contener una variable, p. ej. .
  • method - GET, POST, PUT, PATCH, DELETE, HEAD (GET por defecto).
  • headers - un objeto de cabeceras (opcional).
  • body - el cuerpo de la solicitud como texto (opcional).
  • expect_status - estado HTTP esperado (200 por defecto).
  • expect_contains - texto que debe estar presente en la respuesta.
  • expect_jsonpath + expect_value - una ruta en la respuesta JSON y el valor esperado.
  • save - un objeto variable → JSONPath; el valor se guarda para los pasos posteriores.
  • name - una etiqueta de paso mostrada en el mensaje de error (opcional).

Ejemplo: inicio de sesión + verificación

[
  {
    "name": "login",
    "method": "POST",
    "url": "https://api.example.com/auth/login",
    "headers": { "Content-Type": "application/json" },
    "body": "{\"user\": \"demo\", \"pass\": \"...\"}",
    "expect_status": 200,
    "save": { "token": "data.access_token" }
  },
  {
    "name": "profile",
    "url": "https://api.example.com/me",
    "headers": { "Authorization": "Bearer " },
    "expect_jsonpath": "user.active",
    "expect_value": "True"
  }
]

JSONPath

Admite notación de puntos e índices de array: data.items[0].id, user.name, prefijo opcional $..

Cómo se decide el estado: el monitor está Up solo si todos los pasos pasan. Al primer fallo pasa a Down y el error indica el número y la etiqueta del paso fallido. Tiempo de respuesta = la suma de todos los pasos.

Conviene saber

  • Un monitor multipaso se ejecuta solo desde la región principal (se omite el consenso multirregión).
  • Las direcciones de destino no deben apuntar a la red interna (la misma protección que los monitores normales).
  • Las variables de save solo son válidas dentro de una única comprobación.
¿Te ha resultado útil esta guía?