Docs
Ctrl K
Volver al sitio Pedí una demo
DocsOperaciónFlujos

Flujos

.md

Armá a tu medida una cadena de pasos - un disparador, consultas a tus datos, condiciones, esperas y acciones como avisar, mandar un email o crear un ticket.

En esta página
Para qué sirveCuándo usarloQuién puede quéCómo se crea un flujo, paso a pasoReglas generalesDatos básicosDisparadoresTipos de pasoLímites y frenosProbar, ejecutar y activarHistorial y versionesCómo se evitan los avisos duplicadosEjemplosProblemas comunes

Para qué sirve#

Un flujo es una automatización que armás vos paso a paso. Siempre tiene la misma forma: algo lo dispara, y después se recorre un camino de pasos. Por ejemplo: "cada 5 minutos, contá los errores; si son más de 100, avisá por Slack".

Las automatizaciones de plantilla cubren los casos más comunes; los flujos son para lo que no cubren.

Cuándo usarlo#

  • Avisar de algo que ningún perfil de alerta cubre (por ejemplo, un indicador de negocio que baja).
  • Esperar y volver a mirar antes de avisar ("si en 15 minutos sigue mal, avisá").
  • Disparar una acción cuando se abre o se cierra un incidente, o cuando llega un evento de negocio.
  • Probar una dirección de tu red desde un gateway (ver Chequeos sintéticos).

Quién puede qué#

Rol Qué puede hacer
Administración Todo: crear, editar, activar, pausar, probar, ejecutar, restaurar versiones y eliminar. Es quien ve Flujos en el menú.
Sistemas Puede hacer todo menos eliminar y crear canales o contactos.
Negocio No tiene acceso. El historial puede mostrar datos reales de tus consultas.

Cómo se crea un flujo, paso a paso#

  1. En Flujos, tocá Nuevo flujo.
  2. Elegí el disparador: qué hace que el flujo arranque (ver abajo).
  3. Poné un nombre y, si querés, para qué sirve.
  4. Tocá el disparador y completalo. Después usá el + para sumar pasos: consultar datos, una condición, esperar o una acción. Tocá cada paso para configurarlo.
  5. Abrí Límites y frenos y ajustalos (ver abajo).
  6. Tocá Probar sin mandar nada: simula el recorrido sin mandar avisos, emails ni tickets.
  7. Tocá Crear el flujo. Queda en borrador. Cuando estés conforme, tocá Activar.

El flujo se guarda solo si está completo y es válido: cada paso que queda incompleto se marca con el motivo. Cada guardado crea una versión nueva.

Al terminar, tenés tres pestañas: Armado, Historial y Versiones.

Reglas generales#

  • Cada ejecución recorre un solo camino, un paso a la vez. No hay ramas en paralelo. Las dos ramas de una condición pueden volver a juntarse en un paso.
  • Un flujo tiene hasta 40 pasos.
  • Solo cuenta lo que pasa después de activar: activarlo nunca dispara por lo que ya pasó.
  • Pausar frena los disparos nuevos; lo que ya había arrancado termina.
  • Los destinos (canales y contactos) tienen que existir de antemano. Un flujo no acepta una dirección o una URL escrita a mano: así un flujo no puede mandar datos a un destino que un administrador no haya creado.
  • Si alguien deja la empresa, sus flujos siguen funcionando.

Datos básicos#

Campo Para qué sirve Valor por defecto Valores válidos Impacto
Nombre del flujo Cómo lo ves en Automatizaciones. Vacío (obligatorio) 3 a 80 caracteres: letras, números, espacios y . , : ; ( ) / · _ -; no puede repetirse —
Para qué sirve (opcional) Una nota para el equipo. Vacío Hasta 500 caracteres —

Disparadores#

Disparador Cuándo arranca Qué configurás
Por horario Cada tantos minutos, o en días y horas fijas. Cada N minutos (1 a 1.440; corre en múltiplos exactos, por ejemplo cada 15 minutos son las :00, :15, :30 y :45; por defecto 5), o días y horas (al menos un día y de 1 a 24 horas; por defecto lunes a viernes a las 09:00, en el horario de tu cuenta).
Incidente Cuando se abre o se cierra un incidente. Evento (se abre o se cierra) y un filtro: severidad, tipo, servicios, servidores y una palabra que tiene que aparecer en el título. Lo que dejes vacío vale para cualquiera.
Anomalía Cuando aparece una anomalía (automática o propia). Servicios (hasta 50) y nombres de anomalía (hasta 50). Vacío = cualquiera.
Evento de negocio Cuando llega un evento de negocio. Nombre del evento (por ejemplo pago_confirmado) y hasta 5 filtros por servicio, canal o atributo.

Detalles que conviene saber:

  • Un incidente que arranca dentro de una ventana de mantenimiento no dispara el flujo.
  • Los eventos se leen con un retraso chico: uno que llega con más de 45 segundos de atraso no dispara.
  • Después de un corte del sistema se corre un solo turno, el último, si fue hace menos de una hora.
  • Para los chequeos de sitios web usá la plantilla, no un flujo.

Tipos de paso#

Todos los pasos tienen Cómo se llama este paso (hasta 80 caracteres) y Qué pasa después (el paso siguiente, o "Termina acá"). Renombrar un paso no rompe las variables que lo usan.

Ejecutar una consulta#

Mira tus datos y deja el resultado a mano para los pasos que siguen.

Campo Para qué sirve Valor por defecto Valores válidos Impacto
Consulta La pregunta a tus datos, armada con el asistente o escrita a mano (ver Explorar). Vacía Hasta 4.000 caracteres Es texto fijo: no admite variables. Una consulta pesada tarda más (tope: 60 segundos por consulta). Solo lee datos, no cambia nada.
Cuánto tiempo hacia atrás mira El período. — 1 minuto a 44.640 (31 días); atajos: 5 min, 15 min, 1 hora, 6 horas, 1 día, 7 días Si la consulta trae su propio período (por ejemplo last 2h), manda ese. Más período = más datos leídos.
Si este paso falla Qué hacer ante un error. Cortar el flujo Cortar el flujo / Seguir igual "Seguir igual" continúa aunque no haya resultado.

Lo que deja disponible: valor (el número principal), filas, total, maximo, minimo, unidad, tabla (hasta 10 filas como texto), primera.<columna> (una columna de la primera fila), desde, hasta y truncado (si se cortó por el tope de filas).

Condición#

Decide el camino: si se cumple, sigue por Sí; si no, por No. Si falta el dato, la comparación no se cumple (tampoco "distinto").

Campo Para qué sirve Valor por defecto Valores válidos Impacto
Cuántas reglas tienen que cumplirse Todas o alguna. Todas Todas se cumplen / Alguna se cumple "Alguna" dispara más.
Regla: Dato Qué se compara. — Variables del flujo, del disparador o de un paso anterior Solo se pueden usar pasos que corren siempre antes.
Regla: Condición Cómo se compara. — Mayor, mayor o igual, menor, menor o igual, igual, distinto, contiene, no contiene, vacío, no vacío Los textos no distinguen mayúsculas.
Regla: Valor Con qué se compara. — Un número o un texto de hasta 200 caracteres —

Hasta 10 reglas por condición.

Esperar#

Campo Para qué sirve Valor por defecto Valores válidos Impacto
Cuánto espera Minutos antes de seguir. — 1 a 1.440 minutos Mientras espera no consume nada, pero cuenta para el tiempo máximo de la ejecución: si la espera no entra, el flujo no se puede guardar.

Acción#

Hace algo hacia afuera. Elegís Qué hace:

Acción Qué hace Qué pide Observaciones
Avisar por un canal Un mensaje por Telegram, Slack, Teams o webhook. Un canal de Integraciones, asunto (hasta 200) y mensaje (hasta 3.000). Telegram solo con chat fijo. En Teams un valor no puede armar un link.
Mandar un email Un correo a los contactos que elijas. De 1 a 20 contactos, asunto y mensaje. Solo a contactos que ya existen; los inactivos hacen fallar el envío.
Crear un ticket Abre un ticket en la herramienta conectada. Un canal de tickets (Jira), título (hasta 200), mensaje y severidad (crítica, alta o media). Si lo disparó un incidente, el ticket es el del incidente y no se duplica.
Llamar a un webhook Manda un mensaje con datos a un sistema tuyo. Un canal de tipo webhook, asunto, mensaje y hasta 20 "datos extra" (nombre y valor, hasta 1.000 caracteres). Los datos extra viajan en el campo datos del mensaje.
Chequear desde un gateway Pide a un gateway que pruebe una dirección de tu red. Gateway, dirección o puerto y tiempos. Ver Chequeos sintéticos.

Todos tienen Si este paso falla: Cortar el flujo (por defecto) o Seguir igual.

Variables en los textos. En asunto, mensaje, título y datos extra podés tocar Insertar una variable y elegir de la lista (por ejemplo, la causa del incidente, el nombre del flujo o valor de una consulta anterior). Se escriben entre llaves dobles, por ejemplo {{pasos.conteo.valor}}. Solo se reemplazan datos: no se evalúan expresiones ni código. Si no hay dato se escribe "sin dato".

Límites y frenos#

Sirven para que un flujo no mande de más. Las pruebas no cuentan para ninguno.

Campo Para qué sirve Valor por defecto Valores válidos Impacto
Tope por minuto del flujo Máximo de ejecuciones por minuto de este flujo. 6 1 a 60 Lo que pasa de ese tope se frena y no se ejecuta (queda en "Disparos frenados" del historial). La cuenta entera admite 60 ejecuciones por minuto sumando todos los flujos.
Período de calma Minutos sin repetir acciones después de una acción real. 0 (sin calma) 0 a 1.440 Evita el mismo aviso una y otra vez. Lymen sugiere 30 minutos para incidentes, 60 para anomalías y 15 para eventos. Sin calma, un flujo disparado por incidentes puede repetir avisos.
Tiempo máximo de una ejecución Cuánto puede durar una ejecución. 60 minutos 1 a 2.880 Pasado ese tiempo queda como "Se pasó del tiempo máximo". Las esperas tienen que entrar.

Probar, ejecutar y activar#

Botón Qué hace Impacto
Probar sin mandar nada Corre el flujo en modo simulado: las consultas y las condiciones son reales, pero no se manda nada (ni avisos, ni emails, ni tickets). Seguro. Si hay cambios sin guardar, se guardan solos antes. Hasta 5 pruebas por minuto por usuario.
Activar / Pausar Pone en marcha o frena los disparos. Solo se puede activar un flujo guardado.
Ejecutar ahora · manda de verdad Corre el flujo en el momento. Los avisos, emails y tickets salen de verdad. Pide confirmación. Cuenta para el tope por minuto, pero no para la calma.
Eliminar (solo Administración) Borra el flujo con sus versiones e historial. No se puede deshacer.

Historial y versiones#

  • Historial: una fila por ejecución (cuándo, qué la disparó, tipo, estado, cuánto duró, acciones). Se puede filtrar por tipo (prueba o real) y cancelar una en curso. También lista los disparos frenados y por qué (tope del flujo, tope de la cuenta o calma). El historial se conserva, por defecto, 30 días. Todo valor que parezca un secreto (contraseñas, tokens, direcciones con clave) se oculta, pero no pongas secretos en los textos.
  • Versiones: cada guardado crea una. Podés abrir cualquiera y Restaurarla. Una ejecución queda atada a la versión con la que arrancó: editar no cambia lo que ya está corriendo.
Estado de una ejecución Significa
En cola, Corriendo, Esperando En curso.
Terminó bien / Falló Resultado final.
Cancelada La cancelaron a mano.
Se pasó del tiempo máximo Superó el tope.
Frenada Nunca arrancó por un freno.

Cómo se evitan los avisos duplicados#

Si un paso se reintenta o el sistema se reinicia, Lymen no repite un envío que ya salió. Un paso que falla se reintenta hasta 4 veces (esperando 30 segundos, 2 minutos y 8 minutos) si el motivo es pasajero. En algunos destinos (Telegram, Slack, Teams) no hay forma de saber si un envío interrumpido salió; en ese caso el paso falla con "no se sabe si salió" en vez de arriesgarse a duplicar.

Ejemplos#

  • Errores altos. Disparador: horario, cada 5 minutos → Consulta: contar errores de los últimos 5 minutos → Condición: valor mayor que 100 → (Sí) Acción: avisar por Slack con "Hay {{pasos.conteo.valor}} errores". Calma: 30 minutos.
  • Abrir un ticket cuando se cae algo grave. Disparador: incidente que se abre, severidad crítica → Acción: crear un ticket en Jira.
  • Esperar antes de avisar. Incidente que se abre → Esperar 15 minutos → Consulta: ver si sigue habiendo errores → Condición → Acción: email a la guardia.

Problemas comunes#

  • No puedo guardar. Algún paso está incompleto o una variable apunta a un paso que no corre siempre antes. El panel del paso lo explica.
  • No hay canales o contactos para elegir. Creá el canal en Integraciones o el contacto en Contactos; el enlace se abre en otra pestaña.
  • Disparos frenados en el historial. Se alcanzó el tope por minuto o el período de calma. Ajustalos en Límites y frenos.
  • El flujo no se dispara por un incidente. Puede ser que arrancó en una ventana de mantenimiento o que el filtro es muy restrictivo.
  • "Otra persona guardó este flujo". Dos personas editaron a la vez. Podés volver a abrirlo, perdiendo tus cambios sin guardar.