Documentation
Table of Contents
11 Comprobaciones externas
Descripción
La verificación externa es una verificación ejecutada por el servidor Zabbix ejecutando un shell script o un binario. Sin embargo cuando los hosts son monitoreados por un proxy Zabbix, las comprobaciones externas se ejecutan por el proxy.
Las verificaciones externas no requieren que ningún agente se ejecute en un host monitoreado.
La sintaxis de la clave del elemento es:
Donde:
| ARGUMENTO | DEFINICIÓN |
|---|---|
| script | Nombre de un shell script o un binario. |
| parámetro(s) | Parámetros de línea de comandos opcionales. |
Si no desea pasar ningún parámetro al script, puede usar:
El servidor Zabbix buscará en el directorio definido la ubicación de los scripts externos (parámetro 'ExternalScripts' en el [archivo de configuración de servidor Zabbix] (/manual/appendix/config/zabbix_server)) y ejecutar el comando. El comando se ejecutará a medida que se ejecuta el servidor Zabbix con usuario zabbix, por lo que cualquier permiso de acceso o variable de entorno debe manejarse en un script contenedor, si es necesario, y los permisos en el comando deben permitir que ese usuario lo ejecute. Solo los comandos en el directorio especificado están disponibles para su ejecución.
::: nota de advertencia ¡No abuse de los controles externos! Como cada script requiere iniciar un proceso de bifurcación por parte del servidor Zabbix, ejecutando muchos scripts puede disminuir mucho el rendimiento de Zabbix. :::
Ejemplo de uso
Ejecutar el script check_oracle.sh con los primeros parámetros '-h'. El segundo parámetro será reemplazado por la dirección IP o el nombre DNS, según la selección en las propiedades del equipo.
Suponiendo que el equipo esté configurado para usar la dirección IP, el servidor/proxy Zabbix ejecutará:
Resultado de la comprobación externa
El valor de retorno de una comprobación externa es una salida estándar junto con un error estándar producido por la comprobación.
Una métrica que devuelve texto (información de tipo carácter, registro o texto) no dejará de ser compatible en caso de que se produzca una salida de error estándar.
El valor de retorno está limitado a 16 MB (incluidos los espacios en blanco finales que se truncan); también se aplican los límites de la base de datos.
Si no se encuentra el script solicitado o el servidor/proxy Zabbix no tiene permisos para ejecutarlo, la métrica dejará de ser compatible y se mostrará un mensaje de error correspondiente.
En caso de que se agote el tiempo de espera, la métrica dejará de ser compatible, se mostrará un mensaje de error correspondiente y se finalizará el proceso bifurcado para el script.