Operar
Alertas
Cada agent vigila su propio host y le dice al panel cuándo un recurso se calienta o un agent se queda callado. Tú defines los umbrales; ConnXL levanta, escala y resuelve las alertas y puede enviarlas a Slack, Teams, Discord o tu propio webhook.
6 min de lectura
Qué se monitorea
Cada instancia de agent reporta el estado de su host — CPU, memoria y disco. Cada métrica tiene dos umbrales:
- Advertencia — por defecto
85%. El recurso se está quedando justo. - Crítico — por defecto
95%. Actúa ahora.
Cámbialos por agent desde la tarjeta de umbrales en la página de runtime del agent, o desactiva una métrica que no te importe. Los umbrales se evalúan en el agent con un poco de histéresis, así que una alerta no oscila cuando un valor ronda justo la línea, y un nuevo ajuste se aplica en vivo por el canal de configuración — sin reinicio.
El ciclo de vida de una alerta
- Levantada — una métrica cruza su umbral de advertencia. Se muestra en el banner de alertas del agent, la columna de estado y la campana de la barra superior.
- Escalada — una alerta de nivel de advertencia cruza el umbral crítico.
- Resuelta — la métrica vuelve a caer por debajo de la advertencia. La alerta se cierra por sí sola.
- Agent offline — si un agent deja de latir durante más de 10 minutos se marca como offline; se despeja automáticamente en el momento en que el agent se reconecta.
Canales de notificación
Las alertas viven en el panel por defecto. Para que se envíen a algún sitio, añade un canal de notificación bajo los webhooks de tu organización. Se admiten cinco tipos — slack, teams, discord, custom (cualquier endpoint HTTPS) y email — y cada canal se suscribe a los eventos que le importan:
- Eventos de alerta — levantada, escalada y resuelta.
- Estado del agent — un agent que se queda offline o que vuelve online.
- Actualización disponible — un agent está ejecutando un build más antiguo que la última versión publicada (una vez por agent y versión).
- Fallos de función — un lote de llamadas fallidas, con la función, un recuento y un error de muestra.
Los webhooks personalizados están firmados y protegidos
Las cargas de un canal personalizado están firmadas con HMAC para que tu receptor pueda verificar que vinieron de ConnXL, y el destino se comprueba para evitar que los webhooks alcancen direcciones de red privadas. Usa Send test para disparar un evento de muestra mientras lo conectas.
Los canales de email escriben en el idioma de cada destinatario
Un canal de tipo email no tiene URL: envía a una lista de miembros de la organización que tú eliges (si la dejas vacía, va a todos los administradores). Cada persona recibe la alerta en su propio idioma, y cada una puede silenciar los correos de alerta por su cuenta en Organización → Mis preferencias. En Miembros y roles se explica cómo se elige ese idioma.
Registros y exportaciones
Cada llamada de función que ejecuta un agent se reporta de vuelta como un evento de uso — nunca los datos, solo los metadatos. El panel agrupa esos eventos en analíticas que puedes leer en pantalla o descargar como una hoja de cálculo. Esta página también cubre el visor de registros del proceso del agent, aparte, para diagnosticar una función rota.
Solución de problemas
Soluciones orientadas a tareas para los problemas con los que te vas a encontrar de verdad: una fórmula en blanco, un código de error de Excel, un agent que no reconecta, y fallos de inscripción — más dónde mirar para saber más.