7 Comprobación externa
Resumen
Una comprobación externa es una comprobación ejecutada por Zabbix server mediante la ejecución de un script de shell o un binario. Sin embargo, cuando los hosts son monitorizados por un Zabbix proxy, las comprobaciones externas son ejecutadas por el proxy.
Las comprobaciones externas no requieren que ningún agent se esté ejecutando en el host monitorizado.
La sintaxis de la clave del item es:
script[<parameter1>,<parameter2>,...]Donde:
| ARGUMENT | DEFINITION |
|---|---|
| script | Nombre de un script de shell o de un binario. |
| parameter(s) | Parámetros opcionales de la línea de comandos. |
Si no desea pasar ningún parámetro al script, puede usar:
script[] o
scriptZabbix server o proxy buscará en el directorio especificado los scripts externos y ejecutará el comando (consulte el parámetro ExternalScripts en el archivo de configuración de Zabbix server/proxy).
El comando se ejecutará con el mismo usuario que Zabbix server/proxy, por lo que, si es necesario, cualquier permiso de acceso o variable de entorno debe gestionarse en un script envoltorio.
Los permisos sobre el comando también deben permitir que ese usuario lo ejecute.
Solo los comandos del directorio especificado están disponibles para su ejecución.
No abuse de las comprobaciones externas, ya que cada script requiere que Zabbix server/proxy inicie un proceso fork, y ejecutar muchos scripts puede reducir significativamente 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.
check_oracle.sh["-h", "{HOST.CONN}"]Suponiendo que el equipo esté configurado para usar la dirección IP, el servidor/proxy Zabbix ejecutará:
check_oracle.sh '-h' '192.168.1.4'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.