Introducción
La biblioteca de scripts es donde se crean, organizan y mantienen los scripts que se pueden usar en automatizaciones, monitores de scripts y ejecuciones ad hoc desde el listado de dispositivos o los detalles del dispositivo. Los scripts se guardan una vez y son reutilizables en todo el entorno: cambia un script en la biblioteca y la actualización se refleja en todos los lugares donde se hace referencia a él.
Scripts
Ir a Scripts en la barra lateral.
La barra lateral izquierda tiene tres elementos fijos en la parte superior:
Todos los scripts — muestra todos los scripts de la biblioteca, en todos los grupos
Nuevo script — abre el diálogo Crear script
Scripts sin grupo — scripts que aún no han sido asignados a un grupo
Debajo de esos, la sección Grupos de scripts muestra los grupos personalizados que has creado. Selecciona un grupo para filtrar la tabla y mostrar solo los scripts de ese grupo.
La tabla principal muestra todos los scripts que coinciden con la selección actual. Las columnas incluyen Nombre, Grupo, Descripción, Tipo (idioma) y Creado. Haz clic en cualquier nombre de script para abrirlo en el editor.
Crear un script
Haz clic en + Crear script en la parte superior derecha, o Nuevo script en la barra lateral. Aparece un diálogo solicitando un nombre.
Ingresa un nombre y haz clic en Crear. El editor de scripts se abre de inmediato.
💡 CONSEJO: Nombra los scripts de forma específica: «Deshabilitar cuenta de invitado - Windows» es más fácil de encontrar y reutilizar que «Script de cuenta de invitado». Siempre puedes cambiar el nombre más adelante.
Editor de scripts
Cada script tiene cuatro pestañas en el panel izquierdo: Script, Variables, Automatizaciones vinculadas, y Monitores vinculados.
Los campos configurables:
Nombre del script — el nombre que aparece en la biblioteca y en el selector de acción Ejecutar script.
Descripción — opcional. Se muestra en el listado de scripts. Vale la pena completarlo para bibliotecas compartidas.
Lenguaje — el lenguaje de scripting. Opciones admitidas:
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Tiempo de espera (en segundos) — cuánto tiempo espera Level para que el script se complete antes de marcar la ejecución como fallida. El valor predeterminado es 100 segundos.
Ejecutar como — el contexto de cuenta bajo el que se ejecuta el script:
Opción | Comportamiento |
Sistema local | Se ejecuta como la cuenta SYSTEM: elevada, sin contexto de usuario |
Usuario actual | Se ejecuta como el usuario que ha iniciado sesión: úsalo para operaciones en el contexto del usuario, como aplicar un fondo de pantalla o configurar ajustes por usuario |
El editor de código ocupa el lado derecho de la pantalla. Escribe o pega tu script directamente. Haz clic en {x} en la esquina inferior derecha del editor para insertar una variable, variable del sistema o referencia a un campo personalizado en línea.
Haz clic en Guardar script para guardar. Los cambios no surten efecto hasta que se guardan.
⚠️ ADVERTENCIA: Los cambios no guardados se pierden si navegas fuera del editor. Guarda antes de salir del editor.
Variables
La pestaña Variables muestra las variables del script declaradas para este script. Las variables de script son ranuras de salida con nombre: el script escribe un valor en ellas durante la ejecución, y puedes asignar ese valor a una variable de automatización en el panel Ejecutar script del panel de acción para pasarlo hacia adelante en el flujo de trabajo.
Haz clic en + Agregar nueva variable para definir una nueva variable. Una vez definidas, las variables aparecen en el selector Variables del script de cualquier acción Ejecutar script que hace referencia a este script.
ℹ️ NOTA: Las variables de script capturan la salida de un script. Para pasar datos hacia un script (contexto del dispositivo, valores de campos personalizados, información del sistema), usa el selector {x} en el editor de código para hacer referencia a variables o campos personalizados en línea.
Para la referencia completa sobre cómo asignar variables de script a variables de automatización y usarlas en acciones posteriores, consulta Acción Ejecutar script, Variables de automatización, y Variables del sistema.
Automatizaciones vinculadas
La pestaña Automatizaciones vinculadas muestra todas las automatizaciones que hacen referencia a este script mediante una acción Ejecutar script acción. Haz clic en cualquier nombre de automatización para abrirla.
ℹ️ NOTA: Un script no puede eliminarse mientras tenga automatizaciones vinculadas. Deberás eliminar el script de cada automatización que lo referencia primero, o eliminar esas automatizaciones. La pestaña facilita ver exactamente qué se vería afectado.
Monitores vinculados
La pestaña Monitores vinculados muestra todos los monitores de script que utilizan este script. Se aplica la misma regla de eliminación: desvincula de todos los monitores antes de poder eliminar un script.
Actividad del script
La pestaña Actividad registra cada cambio guardado en el script, incluido el código. Ve a Scripts → [script] → Actividad.
Una entrada de cambio resume lo que se guardó, por ejemplo «guardó 2 cambios en Monitor Osquery - Uptime». Expándela para ver cada cambio individual.
Para una edición de código, el cambio muestra el delta de número de líneas (por ejemplo «+3 −1») y un enlace Ver cambios enlace.
Haz clic en Ver cambios para abrir el panel de diferencias: líneas eliminadas en rojo, líneas agregadas en verde, números de línea y un botón Unificado / Dividido alternar. El encabezado muestra el nombre del script, el técnico y la marca de tiempo.
Para la función completa y la página global de Actividad, consulta Actividad.
💡 CONSEJO: El panel de diferencias es el registro de auditoría para los cambios en los scripts. Úsalo para confirmar exactamente qué cambió antes de que un monitor o una automatización comenzara a comportarse de manera diferente, sin necesidad de restaurar una versión antigua para comparar visualmente.
Organización con grupos de scripts
Los grupos de scripts permiten categorizar los scripts por plataforma, función, equipo o lo que tenga sentido para tu entorno. Los grupos aparecen en la barra lateral bajo Grupos de scripts y como columna en el listado de scripts.
Para crear un grupo, haz clic en el ícono + junto a Grupos de scripts en la barra lateral. Aparece un diálogo solicitando un nombre de grupo.
Para asignar un script a un grupo, abre el menú Acciones (parte superior derecha) y selecciona Asignar a grupo.
💡 CONSEJO: Los grupos de scripts suelen reflejar un propósito o función (Seguridad, Software, Monitores, Utilidades), no la estructura de tus grupos de dispositivos. Organizar por función facilita que todo el equipo encuentre el script adecuado independientemente de en qué dispositivos se ejecute.
Eliminar un script
Abre el menú Acciones y selecciona Eliminar. Aparece un diálogo de confirmación.
⚠️ ADVERTENCIA: La eliminación de scripts no se puede deshacer. Si el script tiene automatizaciones o monitores vinculados, Level bloquea la eliminación: primero elimina todos los vínculos usando las pestañas Automatizaciones vinculadas y Monitores vinculados pestañas.
Ejecución de scripts
Los scripts se pueden ejecutar de varias maneras:
En una automatización — mediante la acción Ejecutar script acción. El script se ejecuta en cada dispositivo de destino como parte del flujo de la automatización. Esta es la forma principal de ejecutar scripts a escala o según un horario. Consulta Acción Ejecutar script para la referencia completa.
Ad hoc desde el listado de dispositivos o detalles del dispositivo — selecciona dispositivos y abre el menú Acciones aparecen tres opciones relacionadas con scripts:
Ejecutar script guardado — elige un script de tu biblioteca. Level crea una nueva automatización de ejecución de script con dos acciones: Esperar aprobación y Ejecutar script.
Ejecutar nuevo script — escribe un nuevo script en el momento. El script se guarda en tu biblioteca y se crea una automatización de ejecución de script para él.
Agregar a ejecución de script reciente — agrega los dispositivos seleccionados a una automatización de ejecución de script existente en lugar de iniciar una nueva.
En un monitor de script — un monitor ejecuta un script según un horario y evalúa su salida para determinar el estado del dispositivo. Consulta Monitores de script para obtener detalles de configuración.
ℹ️ NOTA: Las automatizaciones de ejecución de script son reutilizables. Puedes cambiarles el nombre, moverlas a un grupo, agregar más acciones o ajustar su disparador antes de aprobarlas. El script no se ejecutará hasta que el paso Esperar aprobación se aprueba manualmente. Todas las ejecuciones de scripts se rastrean en Automatizaciones → Ejecuciones de scripts en la barra lateral.
Preguntas frecuentes
¿Cuál es la diferencia entre Ejecutar script guardado, Ejecutar nuevo script y Agregar a ejecución de script reciente? Las tres opciones están en el menú Acciones en el listado de dispositivos y en los detalles del dispositivo. Ejecutar script guardado elige un script existente de la biblioteca y crea una nueva automatización de ejecución de script para él. Ejecutar nuevo script permite escribir un nuevo script en el momento: se guarda en la biblioteca y se crea una automatización de ejecución de script. Agregar a ejecución de script reciente agrega los dispositivos seleccionados a una automatización de ejecución de script existente en lugar de iniciar una nueva. En todos los casos, el script no se ejecutará hasta que el paso Esperar aprobación se aprueba.
¿Cuál es la diferencia entre un script guardado y una acción Shell? Un script guardado vive en la biblioteca y es reutilizable: puedes referenciarlo desde cualquier automatización, monitor o ejecución ad hoc, y los cambios en un lugar actualizan todas las referencias. La acción Shell ejecuta un script escrito en línea dentro de la automatización, sin ninguna entrada en la biblioteca. Usa scripts guardados para todo lo que vayas a ejecutar más de una vez o que quieras mantener con el tiempo.
¿Puedo editar un script sin afectar las automatizaciones que lo usan? Sí. Los cambios en un script guardado surten efecto la próxima vez que se ejecute cualquier automatización que lo referencia; no es necesario actualizar la automatización en sí. La pestaña Automatizaciones vinculadas muestra exactamente qué automatizaciones se verán afectadas.
¿Qué lenguajes admite Level? Ansible, Bash, Go, osquery, PowerShell, Python y Zsh.
¿Puede un script pasar su salida a acciones de automatización posteriores? Sí, de dos maneras. Define variables de script en la pestaña Variables y asígnalas a variables de automatización en el panel Ejecutar script del panel de acción. O usa Asignar salida de acción a variable en las opciones adicionales de la acción para capturar la salida estándar completa del script. Consulta Acción Ejecutar script para más detalles.
¿Quién puede crear y editar scripts? Técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulta Área de trabajo → Permisos para la configuración del control de acceso.
¿Qué les ocurre a las automatizaciones si elimino un script? Level bloquea la eliminación de un script que está vinculado a automatizaciones o monitores activos. Usa las pestañas Automatizaciones vinculadas y Monitores vinculados para ver qué debe desvincularse primero.