Áú»¢¶Ä²©

3 Scripts

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general

En la secci¨®n Alertas ¡ú Scripts se pueden configurar y mantener scripts globales definidos por el usuario.

Los scripts globales, seg¨²n el alcance configurado y tambi¨¦n los permisos del usuario, est¨¢n disponibles para su ejecuci¨®n:

• desde el men¨² de equipo en varias ubicaciones de la interfaz (Tablero, Problemas, ?ltimos datos, Mapas, etc.)
• desde el men¨² de eventos
• se puede ejecutar como una operaci¨®n de acci¨®n

Los scripts se ejecutan ¨²nicamente en el agente Áú»¢¶Ä²©, el servidor Áú»¢¶Ä²© (proxy) o el servidor Áú»¢¶Ä²©. Consulte tambi¨¦n Ejecuci¨®n de comando.

Tanto el agente de Áú»¢¶Ä²© como los scripts remotos del proxy de Áú»¢¶Ä²© est¨¢n deshabilitados de forma predeterminada. Pueden habilitarse mediante:

• Para comandos remotos ejecutados en el agente Áú»¢¶Ä²©:
  • agregar un par¨¢metro AllowKey=system.run[<command>,*] para cada comando permitido en la configuraci¨®n del agente, * representa el modo de espera y no espera;
• Para comandos remotos ejecutados en el proxy Áú»¢¶Ä²©:
  • Advertencia: no es necesario habilitar los comandos remotos en el proxy Áú»¢¶Ä²© si se ejecutan comandos remotos en el agente Áú»¢¶Ä²© que es monitoreado por el proxy Áú»¢¶Ä²©. Sin embargo, si es necesario ejecutar comandos remotos en el proxy Áú»¢¶Ä²©, establezca el par¨¢metro EnableRemoteCommands en '1' en la configuraci¨®n del proxy.

La ejecuci¨®n de script global en el servidor Áú»¢¶Ä²© se puede deshabilitar estableciendo EnableGlobalScripts=0 en la configuraci¨®n del servidor. Para instalaciones nuevas, desde Áú»¢¶Ä²© 7.0, la ejecuci¨®n de script global en el servidor Áú»¢¶Ä²© est¨¢ deshabilitada de forma predeterminada.

Se muestra una lista de scripts existentes con sus detalles.

Datos mostrados:

Para configurar un nuevo script, haga clic en el bot¨®n Crear script en la esquina superior derecha.

Opciones de edici¨®n masiva

Un bot¨®n debajo de la lista ofrece una opci¨®n de edici¨®n masiva:

• Eliminar - eliminar los scripts

Para usar esta opci¨®n, marque las casillas de verificaci¨®n antes de los scripts respectivos y haga clic en Eliminar.

Usando el filtro

Puede utilizar el filtro para mostrar s¨®lo los scripts que le interesan. Para un mejor rendimiento de la b¨²squeda, los datos se buscan con las macros sin resolver.

El enlace Filtro est¨¢ disponible encima de la lista de scripts. Si hace clic en ¨¦l, aparecer¨¢ un filtro disponible donde podr¨¢ filtrar scripts por nombre y alcance.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de un script global

Atributos del script:

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada

Las opciones de configuraci¨®n avanzada est¨¢n disponibles en una secci¨®n plegable °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada:

|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô| |----------|-------------------------------------- --| |Habilitar entrada de usuario|Marque la casilla de verificaci¨®n para habilitar la entrada manual del usuario antes de ejecutar el script.
La entrada manual del usuario reemplazar¨¢ el valor de la macro {MANUALINPUT} en el script.
Consulte tambi¨¦n: Entrada manual del usuario.| |Mensaje de entrada|Ingrese un texto personalizado que solicite la entrada personalizada del usuario. Este texto se mostrar¨¢ encima del campo de entrada en la ventana emergente Entrada manual.
Para ver una vista previa de la ventana emergente Entrada manual, haga clic en Probar entrada del usuario. La vista previa tambi¨¦n permite probar si la cadena de entrada cumple con la regla de validaci¨®n de entrada (consulte los par¨¢metros a continuaci¨®n).
La compatibilidad con macros y macros de usuario depende del alcance del script (consulte Alcance en los par¨¢metros generales de configuraci¨®n del script).| |Tipo de entrada|Seleccione el tipo de entrada manual:
Cadena - cadena ¨²nica;
Desplegable - el valor se selecciona entre m¨²ltiples opciones desplegables.| |Opciones desplegables|Ingrese valores ¨²nicos para el men¨² desplegable de entrada del usuario en una lista delimitada por comas.
Para incluir una opci¨®n vac¨ªa en el men¨² desplegable, agregue una coma adicional al principio, en el medio o al final de la lista.< br>Este campo se muestra s¨®lo si se selecciona 'Desplegable' como Tipo de entrada.| |Cadena de entrada predeterminada|Ingrese la cadena predeterminada para la entrada del usuario (o ninguna).
Este campo se validar¨¢ con la expresi¨®n regular proporcionada en el campo Regla de validaci¨®n de entrada.
El valor ingresado aqu¨ª ser¨¢ se muestra de forma predeterminada en la ventana emergente Entrada manual.
Este campo se muestra solo si se selecciona 'Cadena' como Tipo de entrada.| |Regla de validaci¨®n de entrada|Ingrese una expresi¨®n regular para validar la cadena de entrada del usuario.
Se admiten expresiones regulares globales.
Este campo se muestra solo si se selecciona 'Cadena' como Tipo de entrada.| |Habilitar confirmaci¨®n|Marque la casilla de verificaci¨®n para mostrar un mensaje de confirmaci¨®n antes de ejecutar el script. Esta caracter¨ªstica puede ser especialmente ¨²til con operaciones potencialmente peligrosas (como un script de reinicio) o aquellas que pueden llevar mucho tiempo.| |Texto de confirmaci¨®n|Ingrese un texto de confirmaci¨®n personalizado para la ventana emergente de confirmaci¨®n habilitada con la casilla de verificaci¨®n anterior (por ejemplo, El sistema remoto se reiniciar¨¢. ?Est¨¢ seguro?). Para ver c¨®mo se ver¨¢ el texto, haga clic en Confirmaci¨®n de prueba junto al campo.
Macros y [macros de usuario] personalizadas(/manual/config/macros/ user_macros) son compatibles.
Nota: las macros no se expandir¨¢n al probar el mensaje de confirmaci¨®n.|

Si se configuran tanto la entrada manual del usuario como un mensaje de confirmaci¨®n, se mostrar¨¢n en ventanas emergentes consecutivas.

Entrada manual del usuario

La entrada manual del usuario permite proporcionar un par¨¢metro personalizado en cada ejecuci¨®n del script. Esto ahorra la necesidad de crear m¨²ltiples scripts de usuario similares con una sola diferencia de par¨¢metro.

Por ejemplo, es posible que desee proporcionar un n¨²mero entero diferente o una direcci¨®n URL diferente al script durante la ejecuci¨®n.

Para habilitar la entrada manual del usuario:

• utilizar la macro {MANUALINPUT} en el script (comandos, script, par¨¢metro de script) cuando sea necesario; o en el campo URL de los scripts de URL;
• en la configuraci¨®n de script avanzada, habilite la entrada manual del usuario y configure las opciones de entrada.

Con la entrada del usuario habilitada, antes de la ejecuci¨®n del script, aparecer¨¢ una ventana emergente de Entrada manual al usuario solicit¨¢ndole que proporcione un valor personalizado. El valor proporcionado reemplazar¨¢ a {MANUALINPUT} en el script.

Dependiendo de la configuraci¨®n, se le pedir¨¢ al usuario que ingrese un valor de cadena:

O seleccione el valor de un men¨² desplegable de opciones predeterminadas:

La entrada manual del usuario est¨¢ disponible solo para secuencias de comandos cuyo alcance es "´¡³¦³¦¾±¨®²Ô manual del equipo" o "´¡³¦³¦¾±¨®²Ô manual del evento".

Ejecuci¨®n del script y resultado

Los scripts ejecutados por el servidor Áú»¢¶Ä²© se ejecutan en el orden descrito en la p¨¢gina Ejecuci¨®n de comandos (incluida la verificaci¨®n del c¨®digo de salida). El resultado del script se mostrar¨¢ en una ventana emergente que aparecer¨¢ despu¨¦s de ejecutar el script.

El valor de retorno del script es una salida est¨¢ndar junto con un error est¨¢ndar.

El valor de retorno est¨¢ limitado a 16 MB (incluidos los espacios en blanco finales truncados); Tambi¨¦n se aplican l¨ªmites de la base de datos. Cuando los datos tienen que pasar a trav¨¦s del proxy Áú»¢¶Ä²©, deben almacenarse en la base de datos, someti¨¦ndolos as¨ª a los mismos [l¨ªmites de la base de datos] (/manual/config/items/item#text-data-limits).

Vea un ejemplo de un script y la ventana de resultados a continuaci¨®n:

uname -v
       /tmp/non_existing_script.sh
       echo "Este script fue iniciado por {USER.USERNAME}"

El resultado del script no muestra el script en s¨ª.

Tiempo de espera del script

Agente de Áú»¢¶Ä²©

Es posible que se produzca una situaci¨®n en la que se agote el tiempo de espera al ejecutar un script.

Vea un ejemplo de un script que se ejecuta en el agente Áú»¢¶Ä²© y la ventana de resultados a continuaci¨®n:

sleep 5
       df -h

El mensaje de error, en este caso, es el siguiente:

Tiempo de espera al ejecutar un script de shell.

Para evitar tales situaciones, se recomienda optimizar el script en s¨ª (en el ejemplo anterior, "5") en lugar de ajustar el par¨¢metro Timeout en la °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô del agente Áú»¢¶Ä²© y °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô del servidor Áú»¢¶Ä²©. Sin embargo, para el agente Áú»¢¶Ä²© en modo activo, el par¨¢metro Timeout en configuraci¨®n del servidor Áú»¢¶Ä²© debe ser al menos varios segundos m¨¢s largo que el par¨¢metro RefreshActiveChecks en configuraci¨®n del agente Áú»¢¶Ä²©. Esto garantiza que el servidor tenga tiempo suficiente para recibir los resultados de la verificaci¨®n activa del agente. Tenga en cuenta que la ejecuci¨®n de scripts en un agente activo se admite desde el agente Áú»¢¶Ä²© 7.0.

En caso de que se haya cambiado el par¨¢metro Timeout en la °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô del agente Áú»¢¶Ä²©, aparecer¨¢ el siguiente mensaje de error:

Error al obtener valor del agente: se agot¨® el tiempo de espera de ZBX_TCP_READ().

Significa que la modificaci¨®n se ha realizado en la configuraci¨®n del agente Áú»¢¶Ä²©, pero es necesario modificar el par¨¢metro Timeout en la configuraci¨®n del servidor Áú»¢¶Ä²© ³Ù²¹³¾²ú¾±¨¦²Ô.

Servidor/proxy Áú»¢¶Ä²©

Vea un ejemplo de un script que se ejecuta en el servidor Áú»¢¶Ä²© y la ventana de resultados a continuaci¨®n:

sleep 11
       df -h

Tambi¨¦n se recomienda optimizar el script en s¨ª (en lugar de ajustar el par¨¢metro TrapperTimeout al valor correspondiente (en nuestro caso, > ¡®11¡¯) modificando la configuraci¨®n del servidor Áú»¢¶Ä²©).