- Instalación desde el código fuente
Instalación desde el código fuente
Puede obtener la versión más reciente de Zabbix compilándola a partir del código fuente. Consulte también Obtención del código fuente de Zabbix.
Aquí se proporciona un tutorial paso a paso para instalar Zabbix a partir del código fuente.
Instalación de los demonios de Zabbix
1 Descargar el archivo comprimido del código fuente
Vaya a la página de descargas de Zabbix y descargue el archivo comprimido del código fuente. Una vez descargado, extraiga el código fuente ejecutando:
tar -zxvf zabbix-8.2.0.tar.gz
Introduzca la versión correcta de Zabbix en el comando. Debe coincidir con el nombre del archivo comprimido descargado.
2 Crear una cuenta de usuario
Todos los procesos daemon de Zabbix se ejecutan con usuarios del sistema sin privilegios. Si un daemon de Zabbix se inicia desde una cuenta de usuario sin privilegios, continuará ejecutándose con ese usuario.
En la configuración predeterminada, si un daemon se inicia como root, cambiará a la cuenta de usuario zabbix, que debe estar presente.
Para crear el usuario y el grupo del sistema zabbix, ejecute los comandos que se indican a continuación.
Sistema basado en RedHat:
groupadd --system zabbix
useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix
Sistema basado en Debian:
addgroup --system --quiet zabbix
adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix
No es necesario crear una cuenta de usuario independiente para el frontend de Zabbix.
Recomendación de seguridad
Si el server y el agent de Zabbix se ejecutan en la misma máquina, se recomienda ejecutarlos con cuentas de usuario independientes. Ejecutar ambos con el mismo usuario permite que el agent acceda al archivo de configuración del server, lo que podría exponer información confidencial, como la contraseña de la base de datos, a cualquier usuario con nivel de administrador en Zabbix.
Ejecutar Zabbix como root, bin o cualquier otra cuenta con derechos especiales supone un riesgo de seguridad.
Directorio de inicio (opcional)
Los procesos de Zabbix no requieren un directorio de inicio, por lo que, en general, no se recomienda crear uno. Sin embargo, si necesita una funcionalidad que requiera un directorio de inicio (por ejemplo, almacenar las credenciales de MySQL en $HOME/.my.cnf), puede crearlo mediante los comandos que se indican a continuación.
En sistemas basados en RedHat, ejecute:
mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix
chown zabbix:zabbix /usr/lib/zabbix
En sistemas basados en Debian, ejecute:
mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix
chown zabbix:zabbix /var/lib/zabbix
3 Crear la base de datos de Zabbix
Se requiere una base de datos para los demonios de Zabbix server y proxy, así como para el frontend de Zabbix. No es necesaria para ejecutar el agent de Zabbix.
Se proporcionan scripts SQL para crear el esquema de la base de datos e insertar el conjunto de datos. La base de datos del proxy de Zabbix solo necesita el esquema, mientras que la base de datos del server de Zabbix también requiere el conjunto de datos además del esquema.
Una vez creada la base de datos de Zabbix, continúe con los pasos siguientes para compilar Zabbix.
4 Configurar las fuentes
Se requiere C99 con extensiones de GNU para compilar Zabbix server, Zabbix proxy o Zabbix agent. Esta versión se puede especificar explícitamente estableciendo CFLAGS="-std=gnu99":
export CFLAGS="-std=gnu99"
Si se instala desde el repositorio Git de Zabbix, primero es necesario ejecutar:
./bootstrap.sh
Al configurar las fuentes para un Zabbix server o proxy, debe especificar el tipo de base de datos que se utilizará. Solo se puede compilar un tipo de base de datos con un proceso de server o proxy a la vez.
Para ver todas las opciones de configuración compatibles, ejecute lo siguiente dentro del directorio de fuentes de Zabbix extraído:
./configure --help
Para configurar las fuentes para un Zabbix server y agent, puede ejecutar algo como:
./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares
Para configurar las fuentes para un Zabbix server (con PostgreSQL, etc.), puede ejecutar:
./configure --enable-server --with-postgresql --with-net-snmp
Para configurar las fuentes para un Zabbix proxy (con SQLite, etc.), puede ejecutar:
./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2
Para configurar las fuentes para un Zabbix agent, puede ejecutar:
./configure --enable-agent
o, para Zabbix agent 2:
./configure --enable-agent2
Debe instalarse una versión compatible de Go para compilar Zabbix agent 2.
Notas sobre las opciones de compilación:
--enable-agent: compila Zabbix agent, así como las utilidades de línea de comandos Zabbix get y Zabbix sender.--with-libcurl: se requiere para la monitorización de máquinas virtuales, la autenticación SMTP y los items de Zabbix agentweb.page.*, así como para los items de consulta de telemetría. Consulte también: Requisitos (libcurl).--with-libxml2: se requiere para la monitorización de máquinas virtuales.--with-libpcre2[=DIR]: Zabbix siempre se compila con la biblioteca PCRE2; esta opción solo permite especificar una ruta de instalación personalizada de PCRE2.--with-mysql=/path/to/mysql_config: especifica la ruta a la configuración de una biblioteca cliente de MySQL concreta. Es útil cuando hay varias versiones de MySQL o MariaDB instaladas.--enable-static: enlaza estáticamente las bibliotecas (no compatible con Solaris). Utilice esta opción si planea distribuir binarios compilados a sistemas sin las bibliotecas requeridas. No se recomienda al compilar Zabbix server. Para compilar el server estáticamente, se requiere una versión estática de cada biblioteca externa. El script de configuración no comprueba esto automáticamente.--with-stacksize=<value>: establece el tamaño de la pila por subproceso en kilobytes (por ejemplo,--with-stacksize=512). Puede aumentar este valor si Zabbix se bloquea o se congela debido a desbordamientos de pila (por ejemplo, durante el preprocesamiento en sistemas con límites de pila predeterminados bajos para los subprocesos).--with-apm(utilizar solo con--enable-proxy): se requiere para la monitorización del rendimiento de aplicaciones (APM) en Zabbix proxy. Consulte también: Requisitos (g++, gRPC, protobuf, Abseil).
Si ./configure falla debido a bibliotecas faltantes u otros problemas, consulte el archivo config.log para obtener información detallada sobre el error.
Por ejemplo, si falta libssl, el mensaje de error inmediato puede resultar engañoso:
checking for main in -lmysqlclient... no
configure: error: Not found mysqlclient library
En este caso, config.log revela la causa real:
/usr/bin/ld: cannot find -lssl
/usr/bin/ld: cannot find -lcrypto
Consulte también:
5 Compilar e instalar todo
Si se instala desde el repositorio Git de Zabbix, es necesario ejecutar primero:
$ make dbschema
make install
Este paso debe ejecutarse con un usuario que tenga permisos suficientes (normalmente, 'root', o mediante sudo).
De forma predeterminada, al ejecutar make install, los binarios del daemon (zabbix_server, zabbix_agentd, zabbix_proxy) se instalarán en /usr/local/sbin y los binarios del cliente (zabbix_get, zabbix_sender) en /usr/local/bin.
Para especificar una ubicación distinta de /usr/local, utilice la opción --prefix en el paso anterior de configuración de las fuentes, por ejemplo, --prefix=/home/zabbix.
En este caso, los binarios del daemon se instalarán en <prefix>/sbin, mientras que las utilidades se instalarán en <prefix>/bin.
Las páginas del manual se instalarán en <prefix>/share.
6 Revisar y editar los archivos de configuración
- edite el archivo de configuración del agent de Zabbix (
zabbix_agentd.conf).
Debe configurar este archivo para cada host en el que esté instalado zabbix_agentd.
Debe especificar la dirección IP del server de Zabbix en el archivo. Se denegarán las conexiones desde otros hosts.
- edite el archivo de configuración del server de Zabbix (
zabbix_server.conf).
Debe especificar el nombre de la base de datos, el usuario y la contraseña (si se utiliza alguno de ellos).
El resto de los parámetros será adecuado con sus valores predeterminados si tiene una instalación pequeña (hasta diez hosts monitorizados). Sin embargo, debe cambiar los parámetros predeterminados si desea maximizar el rendimiento del server (o proxy) de Zabbix.
- si ha instalado un proxy de Zabbix, edite el archivo de configuración del proxy (
zabbix_proxy.conf).
Debe especificar la dirección IP del server y el nombre del host del proxy (que el server debe conocer), así como el nombre de la base de datos, el usuario y la contraseña (si se utiliza alguno de ellos).
Con SQLite, debe especificarse la ruta completa al archivo de la base de datos; no se requieren el usuario ni la contraseña de la base de datos.
7 Iniciar los daemons
Ejecute zabbix_server en el lado del server.
zabbix_server
Asegúrese de que su sistema permita asignar 36 MB (o un poco más) de memoria compartida; de lo contrario, es posible que el server no se inicie y verá "Cannot allocate shared memory for <type of cache>." en el archivo de registro del server. Esto puede ocurrir en FreeBSD y Solaris 8.
Ejecute zabbix_agentd en todas las máquinas supervisadas.
zabbix_agentd
Asegúrese de que su sistema permita asignar 2 MB de memoria compartida; de lo contrario, es posible que el agent no se inicie y verá "Cannot allocate shared memory for collector." en el archivo de registro del agent. Esto puede ocurrir en Solaris 8.
Si ha instalado un proxy de Zabbix, ejecute zabbix_proxy.
zabbix_proxy
Instalación de la interfaz web de Zabbix
Copia de archivos PHP
El frontend de Zabbix está escrito en PHP, por lo que se necesita un servidor web compatible con PHP para ejecutarlo.
La instalación se realiza simplemente copiando los archivos PHP del directorio ui al directorio de documentos HTML del servidor web.
Entre las ubicaciones habituales de los directorios de documentos HTML para servidores web Apache se incluyen:
/usr/local/apache2/htdocs(directorio predeterminado al instalar Apache desde el código fuente)/srv/www/htdocs(OpenSUSE, SLES)/var/www/html(Debian, Ubuntu, Fedora, RHEL)
Se recomienda utilizar un subdirectorio en lugar de la raíz HTML.
Para crear un subdirectorio y copiar los archivos del frontend de Zabbix en él, ejecute los siguientes comandos, sustituyendo <htdocs> por el directorio correspondiente:
mkdir <htdocs>/zabbix
cd ui
cp -a . <htdocs>/zabbix
Si planea utilizar otro idioma distinto del inglés, consulte Instalación de idiomas adicionales del frontend para obtener instrucciones.
Instalación del frontend
Consulte la página Instalación de la interfaz web para obtener información sobre el asistente de instalación del frontend de Zabbix.
Instalación de plugins cargables de Zabbix agent 2
La instalación de plugins cargables de Zabbix agent 2 solo es necesaria si desea supervisar destinos que no están cubiertos por los plugins integrados (por ejemplo, servidores o clústeres de MongoDB, PostgreSQL y sus derivados, etc.). Consulte la lista completa de plugins cargables y plugins integrados.
Antes de instalar un plugin, consulte su archivo README. Puede contener requisitos específicos e instrucciones de instalación.
Para realizar la instalación desde el código fuente, primero descargue y extraiga el archivo del código fuente del plugin cargable.
Para compilar el plugin, vaya al directorio del plugin extraído y ejecute make:
make
Debe tener instalada una versión compatible de Go para compilar los plugins cargables de Zabbix agent 2.
El ejecutable del plugin puede ubicarse en cualquier lugar, siempre que Zabbix agent 2 pueda cargarlo.
Especifique la ruta al binario del plugin en el archivo de configuración del plugin, por ejemplo, en postgresql.conf para el plugin de PostgreSQL:
Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql
La ruta al archivo de configuración del plugin debe especificarse en el parámetro Include del archivo de configuración de Zabbix agent 2:
Include=/path/to/plugin/configuration/file/postgresql.conf
Continúe con la configuración para obtener más información sobre cómo configurar los plugins.
Los plugins cargables proporcionados por Zabbix utilizan makefiles sencillos con los siguientes destinos de compilación:
make- compilar el pluginmake clean- eliminar todos los archivos creados al compilar el pluginmake check- ejecutar las autopruebas (requiere un destino de supervisión real, por ejemplo, una base de datos PostgreSQL)make style- comprobar el estilo del código Go congolangci-lintmake format- dar formato al código Go congo fmtmake dist- crear un archivo del código fuente que incluya todas las dependencias
Instalación de Java gateway
Solo es necesario instalar Java gateway si desea supervisar aplicaciones JMX. Java gateway es ligero y no requiere una base de datos.
Para instalarlo desde el código fuente, primero descargue y extraiga el archivo del código fuente.
Para compilar Java gateway, ejecute el script ./configure con la opción --enable-java.
Se recomienda especificar la opción --prefix para solicitar una ruta de instalación distinta de la predeterminada, /usr/local, ya que la instalación de Java gateway creará todo un árbol de directorios, no solo un ejecutable.
./configure --enable-java --prefix=$PREFIX
Para compilar y empaquetar Java gateway en un archivo JAR, ejecute make.
Tenga en cuenta que, para este paso, necesitará los ejecutables javac y jar en su ruta.
make
Ahora tendrá un archivo zabbix-java-gateway-$VERSION.jar en src/zabbix_java/bin.
Si se siente cómodo ejecutando Java gateway desde src/zabbix_java en el directorio de distribución, puede continuar con las instrucciones para configurar y ejecutar Java gateway.
De lo contrario, asegúrese de tener suficientes privilegios y ejecute make install.
make install
Consulte la sección de configuración para obtener más información sobre cómo configurar y ejecutar Java gateway.
Instalación del servicio web de Zabbix
La instalación del servicio web de Zabbix solo es necesaria si desea utilizar los informes programados.
Para realizar la instalación desde las fuentes, primero descargue y extraiga el archivo de fuentes.
Para compilar el servicio web de Zabbix, ejecute el script ./configure con la opción --enable-webservice.
Debe instalarse una versión compatible de Go para compilar el servicio web de Zabbix.
Ejecute zabbix_web_service en la máquina donde está instalado el servicio web:
zabbix_web_service
Consulte la sección configuración para obtener más información sobre cómo configurar la generación de informes programados.
Instalación del servidor MCP de Zabbix
Para instalar desde el código fuente, primero descargue y extraiga el archivo del código fuente.
Para compilar el servidor MCP de Zabbix, ejecute el siguiente comando en el directorio del código fuente del servidor MCP:
make build
Debe estar instalada una versión de Go compatible para compilar el servidor MCP de Zabbix.
Para indicar una versión específica en la salida de zabbix_mcp_server -V y en el User-Agent de las solicitudes a la API de Zabbix, establezca la variable VERSION, por ejemplo, make build VERSION=8.2.0.
Para instalar el binario en /usr/local/sbin y el archivo de configuración de ejemplo en /etc/zabbix, ejecute:
sudo make install
Edite el archivo de configuración /etc/zabbix/zabbix_mcp_server.conf y establezca al menos los siguientes parámetros:
FrontendURL: la URL de la API de Zabbix, que debe terminar enapi_jsonrpc.php;AllowedIP: las direcciones de los clientes MCP a los que se permite conectarse.
Para cifrar las conexiones de los clientes MCP, establezca TLSAccept=cert y especifique TLSCertFile y TLSKeyFile, o ejecute el servidor MCP detrás de un proxy inverso de confianza que gestione TLS.
Si el usuario zabbix no existe (por ejemplo, si solo el servidor MCP está instalado en el equipo), créelo como se describe en Crear una cuenta de usuario.
Valide el archivo de configuración e inicie zabbix_mcp_server:
zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf -T
zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf
Consulte Servidor MCP para obtener más información sobre la configuración del servidor y la conexión de clientes MCP.
Obtención del código fuente de Zabbix
Hay varias formas de obtener el código fuente de Zabbix:
- Puede descargar las versiones estables publicadas desde el sitio web oficial de Zabbix
- Puede descargar compilaciones nocturnas desde la página oficial para desarrolladores de Zabbix
- Puede obtener la versión de desarrollo más reciente desde el sistema de repositorio de código fuente Git:
- La ubicación principal del repositorio completo es https://git.zabbix.com/scm/zbx/zabbix.git
- Las versiones maestras y compatibles también se replican en Github en https://github.com/zabbix/zabbix
Debe haber un cliente Git instalado para clonar el repositorio. El paquete oficial del cliente Git de línea de comandos suele llamarse git en las distribuciones. Para instalarlo, por ejemplo, en Debian/Ubuntu, ejecute:
sudo apt-get update
sudo apt-get install git
Para obtener todo el código fuente de Zabbix, cambie al directorio en el que desea colocar el código y ejecute:
git clone https://git.zabbix.com/scm/zbx/zabbix.git
Problemas de compilación
Estos son los problemas conocidos relacionados con la compilación de Zabbix a partir del código fuente. Para todos los demás casos, consulte la página Problemas conocidos.
Biblioteca en una ubicación no estándar
Zabbix permite especificar una biblioteca ubicada en una ubicación no estándar.
En el ejemplo siguiente, Zabbix ejecutará curl-config desde la ubicación no estándar especificada y utilizará su salida para determinar qué libcurl debe usar.
$ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config
Esto funcionará si es la única libcurl instalada en el sistema, pero podría no funcionar si hay otra libcurl instalada en una ubicación estándar (por ejemplo, mediante el gestor de paquetes). Este es el caso cuando necesita una versión más reciente de la biblioteca para Zabbix y la versión anterior para otras aplicaciones.
Por lo tanto, especificar un componente en una ubicación no estándar no siempre funcionará cuando el mismo componente también exista en una ubicación estándar.
Por ejemplo, si utiliza una libcurl más reciente instalada en /usr/local mientras el paquete de libcurl sigue instalado, Zabbix podría seleccionar la incorrecta y la compilación fallará:
usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':
/tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'
collect2: error: ld returned 1 exit status
En este caso, la función curl_easy_header() no está disponible en la versión anterior /usr/lib/x86_64-linux-gnu/libcurl.so, pero sí está disponible en la versión más reciente /usr/local/lib/libcurl.so.
El problema está relacionado con el orden de las opciones del enlazador, y una solución consiste en especificar la ruta completa a la biblioteca en una variable LDFLAGS:
$ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config
Tenga en cuenta la opción -Wl,--no-as-needed, que podría ser necesaria en algunos sistemas (consulte también las opciones de enlazado predeterminadas en sistemas basados en Debian).
Tamaño de pila demasiado pequeño en algunos sistemas
Si Zabbix se bloquea o se congela debido a desbordamientos de pila, puede aumentar el tamaño de la pila por hilo usando la opción --with-stacksize al configurar las fuentes.
Este problema puede ocurrir en sistemas con límites predeterminados bajos para la pila de hilos, especialmente durante el preprocesamiento, donde se crean varios hilos.
El siguiente ejemplo establece el tamaño de pila en 512 KB por hilo:
./configure --enable-server --with-mysql --with-stacksize=512
Puede comprobar los límites de pila de hilos del sistema en tiempo de ejecución usando el comando ulimit -s en sistemas basados en Linux.