Documentation
Table of Contents
11 Comprobaciones externas
Descripción general
La comprobación externa es una comprobación ejecutada por el servidor Zabbix mediante la ejecución de un script de shell o un binario. Sin embargo, cuando los hosts son monitorizados por un proxy de Zabbix, las comprobaciones externas son ejecutadas por el proxy.
Las comprobaciones externas no requieren que ningún agente se esté ejecutando en el host que se está monitorizando.
La sintaxis de la clave del elemento es:
Donde:
| ARGUMENTO | DEFINICIÓN |
|---|---|
| script | Nombre de un script de shell 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 o proxy de Zabbix 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á bajo el mismo usuario que el servidor/proxy de Zabbix, por lo que cualquier permiso de acceso o variable de entorno debe gestionarse en un script wrapper, si es necesario. Los permisos sobre el comando también deben permitir que ese usuario lo ejecute. Solo los comandos en el directorio especificado están disponibles para su ejecución.
No abuse de las comprobaciones externas, ya que cada script requiere iniciar un proceso fork por parte del servidor/proxy de Zabbix, y ejecutar muchos scripts puede disminuir 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.
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.