Ir al contenido principal

Monitor de ejecución de scripts

Monitor any device condition by running a script and evaluating its output against a threshold or string match.

Introducción

Monitoriza todo aquello para lo que puedas escribir un script. Los monitores de scripts ejecutan un script en los dispositivos de destino con una frecuencia programada y evalúan el resultado según una condición que tú defines — si se cumple la condición, Level genera una alerta.

Donde los tipos de monitores integrados cubren condiciones comunes (CPU, memoria, disco, conectividad), los monitores de scripts cubren todo lo demás: estado del firewall, vencimiento de certificados, cumplimiento de licencias, estado de aplicaciones personalizadas, deriva de configuración y cualquier otra característica del dispositivo que puedas obtener con un script. El script se ejecuta localmente en el dispositivo, por lo que no hay sobrecarga por llamadas externas — solo acceso directo y eficiente a lo que el sistema operativo pueda reportar.


🎬 VÍDEO


Monitores de scripts

Level ejecuta el script seleccionado en los dispositivos cubiertos con la frecuencia configurada. Tras cada ejecución, lee la salida completa de la consola y la evalúa según tu Salida del script condición y Valor. Si la condición se cumple durante el número de ejecuciones consecutivas definido por tu Contador de activaciones, se activa una alerta.

La evaluación es simple por diseño: el script produce una salida, el monitor verifica si esa salida coincide con tu condición. El script no necesita terminar con un código específico — lo que importa es la salida.

ℹ️ NOTA: Level evalúa toda la salida del script, no solo la primera o la última línea. Tenlo en cuenta al escribir scripts que produzcan salidas de varias líneas.


Crear el script

Antes de configurar el monitor, escribe y guarda el script que ejecutará. Cualquier lenguaje compatible funciona: PowerShell, Bash, Zsh, Python, Go, Ansible u osquery.

💡 CONSEJO: osquery se ejecuta en Windows, macOS y Linux — un único script de osquery puede gestionar monitores en las tres plataformas sin necesidad de mantener scripts separados por sistema operativo.

El script debe producir un valor o estado que Level pueda evaluar claramente — un número, una cadena como True/False, o una palabra conocida como Enabled. El monitor luego compara esa salida con tu umbral.

Create Script

💡 CONSEJO: Para verificaciones complejas donde se deben evaluar múltiples condiciones dentro del script, genera una palabra clave conocida (como ALERT) cuando la condición indica un estado no saludable, y configura el monitor en ContieneALERT. Esto mantiene la lógica de aprobación/fallo dentro del script, a la vez que simplifica la configuración del monitor.


Configurar un monitor de scripts

Abre la política de monitor de destino y luego añade o edita un monitor de scripts. El Editar monitor el panel se abre a la derecha.

Nombre y tipo

  1. Introduce un nombre en el campo Nombre campo. El nombre aparece en la alerta, así que hazlo descriptivo - «Firewall de Windows desactivado» es inmediatamente accionable; «Monitor de script 4» no lo es.

  2. Establece Tipo a Ejecutar script.

Uptime Monitor

Gravedad

Establece la Gravedad según el impacto de la condición que detecta este script:

  • Información

  • Advertencia

  • Crítico

  • Emergencia

Sistema operativo

Selecciona el sistema operativo en el que debe ejecutarse el script: Windows, macOS, o Linux. El monitor solo se ejecutará en dispositivos que utilicen el sistema operativo seleccionado.

OS Selection

Script

Selecciona el script a ejecutar desde el campo Script campo. Haz clic en el icono de enlace para abrir el script y revisarlo o editarlo. Haz clic en Probar script para ejecutar el script contra los dispositivos de destino de inmediato e inspeccionar la salida sin procesar — útil para confirmar que el script devuelve lo esperado antes de que el monitor entre en funcionamiento.

Script Selection

Salida del script

Salida del script define cómo Level compara la salida de la consola del script con tu Valor. La lista completa de operadores:

  • Igual a — la salida coincide exactamente con el valor

  • No es igual a — la salida no coincide con el valor

  • Contiene — la salida incluye el valor como subcadena

  • No contiene — la salida no incluye el valor

  • Mayor que — la salida (numérica) es mayor que el valor

  • Mayor o igual que — la salida (numérica) es mayor o igual que el valor

  • Menor que — la salida (numérica) es menor que el valor

  • Menor o igual que — la salida (numérica) es menor o igual que el valor

Script Output

ℹ️ NOTA: La salida completa de la consola de tu script se convierte en el contenido de la alerta. Cuando se activa una alerta, la salida del script es visible directamente en los detalles de la alerta — así que todo lo que escribas en la consola (nombre del dispositivo, valores detectados, detalles del error) aparecerá allí. Incluir contexto útil en la salida hace que las alertas sean mucho más fáciles de gestionar sin tener que investigar más a fondo.

ℹ️ NOTA: La frecuencia de ejecución controla con qué frecuencia Level evalúa la salida del script. Los contenidos de las alertas no constituyen una serie temporal completa de cada ejecución del script. Para conservar cada lectura y analizarla, haz que el script añada muestras con marca de tiempo a un archivo CSV local en el dispositivo y luego recupera ese archivo después de la evaluación. Ten en cuenta el tamaño del archivo, los permisos y la limpieza.

Valor

Introduce el valor con el que comparar la salida del script en el campo Valor campo. Para operadores numéricos, introduce un número. Para operadores de cadena, introduce la cadena exacta.

Output

💡 CONSEJO: El patrón recomendado es producir ALERT (con cualquier detalle adicional útil para la investigación) cuando una condición indique un estado no saludable, y configura Salida del script a ContieneALERT. Esto funciona bien con salidas de varias líneas, incluye cualquier detalle que añadas después de la palabra clave y mantiene la alerta legible. Configura el monitor en No contieneALERT si deseas invertir la lógica.

Frecuencia de ejecución

Frecuencia de ejecución controla con qué frecuencia se ejecuta el script en los dispositivos de destino. Establece la unidad (Minutos o Horas) y el valor usando el control deslizante o las flechas arriba/abajo. El rango es de 1 a 120 minutos o de 1 a 24 horas.

Run Frequency

⚠️ ADVERTENCIA: Ejecutar scripts con una frecuencia muy alta puede afectar al rendimiento del dispositivo, especialmente en hardware de especificaciones bajas o si el propio script consume muchos recursos. Comienza con un intervalo más largo y redúcelo solo si tu caso de uso realmente requiere una detección más rápida.

Contador de activaciones

Contador de activaciones define cuántas ejecuciones consecutivas del script deben coincidir con la condición antes de que Level cree una alerta. Usa las flechas arriba/abajo para establecer el valor.

Un contador de activaciones de 1 genera una alerta en la primera ejecución que coincida. Los valores más altos requieren que la condición persista durante varias ejecuciones antes de generar la alerta — útil para condiciones que pueden aparecer brevemente por cuestiones de temporización (por ejemplo, un script que se ejecuta durante una operación en curso).

Trigger Count

Resolución automática

Resolver automáticamente la alerta si ya no es aplicable cierra la alerta automáticamente cuando una ejecución posterior del script ya no coincide con la condición. Activado de forma predeterminada.

Deja esta opción activada para condiciones que genuinamente se resuelven (un valor que vuelve a caer por debajo de un umbral, una cadena que ya no aparece en la salida). Desactívala si deseas que las alertas persistan para una revisión manual.

Auto-Resolve

Remediación

Adjunta una o más automatizaciones para ejecutar cuando este monitor se active — aplica una corrección de configuración, reinicia un servicio o notifica a tu equipo.

  1. Haz clic en el campo Remediación campo y selecciona una automatización.

  2. Para añadir más, haz clic en + Añadir otra remediación.

  3. Para eliminar uno, haz clic en × junto a él.

Run script monitor Remediation controls

ℹ️ NOTA: Las remediaciones se ejecutan cuando se crea la alerta, no cuando se resuelve.


Notificaciones

  • Enviar notificaciones al crear la alerta — los destinatarios de la política reciben un correo electrónico cuando se activa la alerta

  • Enviar notificaciones al resolver la alerta — los destinatarios de la política reciben un correo electrónico cuando se resuelve la alerta

Los destinatarios se gestionan a nivel de política de monitor, en la Destinatarios sección.

Notifications

Guardar el monitor

Haz clic en Actualizar monitor para guardar los cambios, o Añadir monitor al añadir uno nuevo. El monitor comienza a ejecutarse de inmediato, y las ejecuciones posteriores se programan desde el momento de la creación según la frecuencia configurada.


Ejemplos e inspiración

Para ver ejemplos completos paso a paso que muestran cómo escribir un script y configurar el monitor a su alrededor, consulta Ejemplos de monitores de scripts.

La Biblioteca de Level en level.io/library cuenta con una colección seleccionada de scripts y políticas de monitor listos para usar que puedes importar a tu cuenta con un solo clic. Es un buen punto de partida tanto si quieres desplegar algo de inmediato como si solo quieres ver cómo otros han abordado un problema de monitorización en particular.


Buenas prácticas

Usa un ALERT centinela como patrón de salida estándar. El enfoque recomendado: escribe scripts que generen ALERT (con cualquier detalle adicional a continuación) cuando el dispositivo se encuentre en un estado no saludable, luego configura el monitor en ContieneALERT. Esto funciona de manera confiable con salidas de varias líneas, es fácil de identificar en la lista de alertas y mantiene la lógica de aprobación/fallo dentro del script donde corresponde.

Script de PowerShell

if ($condition) {
Write-Output "ALERT: $details"
} else {
Write-Output "OK"
}

Mantén la lógica de evaluación en el monitor para verificaciones simples. Cuando un script produce un único valor limpio — un número, True/False, Enabled/Disabled — configura la comparación en el monitor en lugar de en el script. Esto hace que el monitor sea más fácil de entender y ajustar sin tocar el script.

Comienza con una frecuencia de ejecución más larga. Reducir un intervalo es sencillo; gestionar el impacto en el rendimiento de un script que se ejecuta con demasiada frecuencia es más difícil. La ejecución con alta frecuencia puede afectar a dispositivos de especificaciones bajas, especialmente si el script realiza un trabajo significativo.

Usa osquery para cobertura multiplataforma. osquery se ejecuta en Windows, macOS y Linux y expone el estado del dispositivo a través de una interfaz similar a SQL. Un único script de osquery puede a menudo reemplazar tres scripts separados específicos por sistema operativo.

Prueba antes de desplegar. Usa Probar script para ejecutar el script contra un dispositivo de destino e inspeccionar la salida sin procesar antes de que el monitor entre en funcionamiento. Esto detecta sorpresas en el formato de salida — espacios en blanco adicionales, saltos de línea inesperados, salida de varias líneas — antes de que rompan silenciosamente tu monitor.


Preguntas frecuentes

  • ¿Quién puede crear y editar monitores de scripts? Los técnicos con acceso a la política de monitor correspondiente. Los ajustes de permisos se gestionan en Espacio de trabajo → Permisos.

  • ¿En qué se diferencia un monitor de scripts de ejecutar un script mediante una automatización? Una automatización ejecuta un script en respuesta a un desencadenador (una programación, una alerta, una acción manual). Un monitor de scripts ejecuta un script de forma recurrente específicamente para evaluar el estado del dispositivo y generar una alerta si se cumple una condición. Usa monitores para verificaciones de estado continuas y automatizaciones para tareas reactivas o puntuales.

  • ¿Puedo usar el mismo script en varios monitores? Sí. Un único script puede ser referenciado por tantos monitores como sea necesario, en diferentes políticas. Si actualizas el script, todos los monitores que lo utilicen incorporarán el cambio en su próxima ejecución.

  • Mi monitor de scripts no genera alertas aunque sé que la condición es verdadera. ¿Qué debo comprobar? Usa Probar script para ejecutar el script contra un dispositivo de destino e inspeccionar la salida sin procesar. Problemas comunes: la salida tiene espacios en blanco al principio o al final que rompen una comparación exacta de Igual a coincidan, la salida es de varias líneas y el valor coincidente se está perdiendo, o el script se está ejecutando en dispositivos que no coinciden con el sistema operativo esperado.

  • ¿Qué ocurre con las alertas abiertas de un monitor de scripts si elimino el monitor? Las alertas existentes permanecen activas. Eliminar un monitor no cierra las alertas que ya creó — resuélvelas manualmente.

¿Ha quedado contestada tu pregunta?