3 Scripts

Vista general

A la secció Alertes → Scripts, es poden configurar i gestionar scripts globals definits per l'usuari.

Els scripts globals, segons l'abast configurat i els permisos de l'usuari, són disponibles per a l'execució:

• des del menú de l'equip a diverses ubicacions d'interfície (Taulers de control, Problemes, Dades més recents, Mapes, etc.)
• des del menú d'esdeveniments
• es pot executar com una operació d'acció

Els scripts s'executen només a l'agent Zabbix, al servidor Zabbix (proxy) o al servidor Zabbix. Veieu també Execució de comandes.

Els scripts remots de l'agent Zabbix i del proxy Zabbix són desactivats de manera predeterminada. Es poden activar mitjançant:

• Comandes remotes executades a l'agent Zabbix
  • afegint un paràmetre AllowKey=system.run[<command>,*] per a cada ordre autoritzada a la configuració de l'agent, * representa el mode wait i nowait;
• Comandes remotes executades al proxy Zabbix
  • Avís: no cal habilitar comandes remotes al proxy Zabbix si s'executen comandes remotes a l'agent Zabbix monitorat pel proxy Zabbix. Si, tanmateix, és necessari executar comandes remotes al proxy Zabbix, establiu el paràmetre EnableRemoteCommands a '1' a la configuració del proxy.

L'execució d'scripts globals a Zabbix es pot deshabilitar definint la variable EnableGlobalScripts=0 a la configuració del servidor. Per a instal·lacions noves, des de Zabbix 7.0, l'execució d'scripts globals al servidor Zabbix és deshabilitada per defecte.

Es mostra una llista dels scripts existents amb els seus detalls.

Dades mostrades:

Per configurar un script nou, feu clic al botó Crea script a l'extrem superior dret.

Opcions d'edició massiva

Un botó a sota de la llista ofereix una opció d'edició massiva:

• Esborrar - esborra scripts

Per emprar aquesta opció, marqueu les caselles davant dels scripts respectius i feu clic a Esborrar.

Ús de filtres

Podeu emprar filtres per veure només els scripts que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.

L'enllaç Filtre és disponible a sobre de la llista d'scripts. Si hi feu clic, hi haurà un filtre disponible i podeu filtrar els scripts per nom i àmbit.

Configuració d'un script global

Attributs de l'script:

Configuració avançada

Les opcions de configuració avançades són disponibles a una secció plegable Configuració avançada:

|Paràmetre|Descripció| |-----------|--------------------------------------- --| |Activar l'entrada de l'usuari|Marqueu la casella de selecció per habilitar l'entrada manual de l'usuari abans d'executar l'script.
L'entrada manual de l'usuari substituirà el valor de la macro {MANUALINPUT} a l'script.
Veieu també: Entrada manual de l'usuari.| |Introducció de petició|Introduïu una petició de text personalitzada per a l'entrada personalitzada de l'usuari. Aquest text es mostrarà a sobre del camp d'entrada a la finestra emergent Entrada manual.
Per veure una vista prèvia de la finestra emergent Entrada manual, feu clic a Prova l'entrada de l'usuari. La previsualització també permet provar si la cadena d'entrada compleix la regla de validació d'entrada (veieu els paràmetres a continuació).
El suport de macros i macros d'usuari depèn de l'abast de l'script (veieu Àmbit als paràmetres de configuració generals de l'script).| |Tipus d'entrada|Trieu el tipus d'entrada manual:
Cadena - cadena única;
Dropdown - el valor es selecciona entre diverses opcions desplegables.| |Opcions desplegables|Introduïu valors únics per al menú desplegable d'entrada de l'usuari en una llista delimitada per comes.
Per incloure una opció buida al menú desplegable, afegiu una coma addicional al principi, al mig o al final de la llista.< br>Aquest camp només es mostra si s'ha escollit 'Menú desplegable' com a Tipus d'entrada.| |Cadena d'entrada predeterminada|Introduïu la cadena per defecte per a l'entrada de l'usuari (o cap).
Aquest camp es validarà amb l'expressió regular proporcionada al camp Regla de validació d'entrada.
El valor introduït aquí serà es mostra per defecte a la finestra emergent Entrada manual.
Aquest camp només es mostra si s'ha triat 'Cadena' com a Tipus d'entrada.| |Regla de validació d'entrada|Introduïu una expressió regular per validar la cadena d'entrada de l'usuari.
S'admeten expressions regulars globals.
Aquest camp només es mostra si s'ha escollit 'Cadena' com a Tipus d'entrada.| |Activar la confirmació|Marqueu la casella de selecció per mostrar un missatge de confirmació abans d'executar l'script. Aquesta característica pot ser especialment útil amb operacions potencialment perilloses (com ara un script de reinici) o les que poden trigar molt de temps.| |Text de confirmació|Introduïu un text de confirmació personalitzat per a la finestra emergent de confirmació activada amb la casella de selecció de dalt (per exemple, El sistema remot es reiniciarà. Voleu fer-ho?). Per veure com quedarà el text, feu clic a Confirmació de la prova al costat del camp.
Macros i macros d'usuari personalitzades. Les macros d'usuari són compatibles.
Nota: les macros no s'ampliaran en provar el missatge de confirmació.|

Si es configuren tant l'entrada manual de l'usuari com un missatge de confirmació, es mostraran en finestres emergents consecutives.

Entrada manual de l'usuari

L'entrada manual de l'usuari permet proporcionar un paràmetre personalitzat a cada execució de l'script. Això estalvia la necessitat de crear diversos scripts d'usuari similars amb només una diferència de paràmetres.

Per exemple, és possible que vulgueu proporcionar un nombre enter diferent o una adreça URL diferent a l'script durant l'execució.

Per habilitar l'entrada manual de l'usuari:

• empreu la macro {MANUALINPUT} a l'script (ordres, script, paràmetre de l'script) quan calgui; o al camp URL dels scripts d'URL;
• a Configuració avançada de l'script, habiliteu l'entrada manual de l'usuari i configureu les opcions d'entrada.

Amb l'entrada de l'usuari habilitada, abans de l'execució de l'script, apareixerà una finestra emergent Entrada manual a l'usuari demanant que proporcioni un valor personalitzat. El valor proporcionat substituirà {MANUALINPUT} a l'script.

En funció de la configuració, se li demanarà a l'usuari que introdueixi un valor de cadena:

O trieu el valor d'un menú desplegable d'opcions predeterminades:

L'entrada manual de l'usuari només és disponible per als scripts on l'abast és "Acció manual de l'equip" o "Acció d'esdeveniment manual".

Execució d'script i resultat

Els scripts executats pel servidor Zabbix s'executen en l'ordre descrit a la secció Execució de comandes, inclosa la comprovació del codi de sortida. El resultat de l'script es mostrarà en una finestra emergent que apareixerà després de l'execució de l'script.

El valor de retorn de l'script és una sortida estàndard amb error estàndard.

Veieu un exemple d'script i una finestra de resultats a continuació:

 uname -v
        /tmp/non_existing_script.sh
        echo "Aquest script l'ha iniciat {USER.USERNAME}"

La sortida de l'script no ensenya l'script.

Temps límit de l'script

Agent Zabbix

Podeu trobar una situació en què es produeixi un temps d'espera durant l'execució d'un script.

Veieu un exemple d'script executat a l'agent Zabbix i la finestra de resultats a continuació:

 sleep 5
        df -h

El missatge d'error en aquest cas és:

 Temps d'espera esgotat durant l'execució d'un script de shell.

Per evitar aquesta situació, és recomanable optimitzar el propi script (en lloc d'ajustar el paràmetre Timeout a un valor corresponent (en el nostre cas, "5") modificant la configuració de l'agent Zabbix i Configuració del servidor Zabbix.

Tanmateix, per a l'agent Zabbix en mode actiu, el paràmetre Timeout a Configuració del servidor Zabbix hauria de ser almenys uns segons més que el paràmetre RefreshActiveChecks a Configuració de l'agent Zabbix. Això garanteix que el servidor tingui prou temps per rebre els resultats de la comprovació activa de l'agent. Tingueu en compte que l'execució d'scripts en un agent actiu és compatible des de l'agent Zabbix 7.0.

Si el paràmetre Timeout encara es modifica a la Configuració de l'agent Zabbix, pot aparèixer el missatge d'error següent:

 No s'ha pogut obtindre el valor de l'agent: ZBX_TCP_READ() s'ha esgotat.

Això vol dir que s'ha fet un canvi a Configuració de l'agent Zabbix i cal canviar el paràmetre Timeout també a Configuració del servidor Zabbix .

Servidor/proxy Zabbix

Aquí hi ha un script d'exemple executat al servidor Zabbix i la finestra de resultats a continuació:

 sleep 11
        df-h

També és recomanable optimitzar el propi script (en lloc d'ajustar el paràmetre TrapperTimeout a un valor corresponent (en el nostre cas > '11') modificant la Configuració del servidor Zabbix).