Documentation
Table of Contents
11 Comprobaciones externas
Descripción general
La comprobación externa es una comprobación ejecutada por el servidor Zabbix al ejecutar un script de shell o un binario. Sin embargo, cuando los equipos son monitoreados por un proxy Zabbix, las comprobaciones externas son ejecutadas por el proxy.
Las comprobaciones externas no requieren que ningún agente se ejecute en un equipo que se está monitoreando.
La sintaxis de la clave de la métrica 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 utilizar:
script[] o script
El servidor o proxy de Zabbix buscará scripts externos en el directorio especificado y ejecutará el comando (consulte el parámetro ExternalScripts en el archivo de configuración del servidor/proxy) Zabbix. El comando se ejecutará bajo el mismo usuario que el servidor o proxy de Zabbix, por lo que cualquier permiso de acceso o variable de entorno debe gestionarse en un script contenedor, si es necesario. Los permisos del 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 utilice en exceso las comprobaciones externas, ya que cada script requiere que el servidor o proxy de Zabbix inicie un proceso de bifurcación, 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.
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.