¿quien se anima a unos how-to?

[angelhc]

Buenas,
He encontrado muchísima información en el manual de Zabbix (en ingles) y poco a poco te vas haciendo con la herramienta pero echo en falta unos how-to's para el día a día.
Se me ocurren algunos de ellos:

"Crear un nuevo host en zabbix"
"Instalación agentes en diferentes plataformas"
"Crear nuevas monitorizaciones para un host (no aplicar el template por defecto)"
...
¿Alguien me ayuda?, yo me ocupo de los dos primeros y los publicaré esta semana en este hilo.
A ver si hacemos una buena comunidad zabbix en castellano

[angelhc]

Bueno pues aqui tenemos el primero de todos!

Os copio lo que he hecho hasta ahora, me gustaría que alguien se dedicara a corregirme / ampliar para que quede lo mejor posible.
GRacias.

HOW-TO Crear un nuevo host en Zabbix
======================================

Este how-to asume que se ha instalado zabbix correctamente y se encuentra funcionando, las pruebas se han realizado sobre un
zabbix 1.6.4 sobre ubuntu.



1.- Primeros pasos
___________________

Para crear un nuevo host en zabbix tenemos que disponer previamente de varios datos.

- Nombre dns del servidor
- Ip del servidor
- S.O. del servidor
- Entorno en el funciona (desarrollo, producción...)

Primero nos dirigimos a la pestaña configuration (configuración) --> Hosts
a la derecha nos aparece un menu desplegable con las opciones de que queremos ver y a su derecha la opción Create Host.
En la ventana nos aparecen los siguientes campos:

Name: Nombre del servidor a monitorizar
In groups: Deberemos añadirle a alguno de los grupos creados o crear uno nuevo.
DNS Name: Nombre dns dentro de la red.
IP. Address: IP del servidor.
Connect to: aqui podemos elegir entre el dns o la IP para conectar con la máquina
Zabbix agent port: aqui dejaremos el de por defecto (10050)
Monitored by proxy: Si tenemos un proxy en alguna DMZ o similar le indicaremos que este server se conecta a el.
Status: Si queremos que inmediatamente después de crearlo se monitorize lo dejaremos en monitored, si queremos hacer cambios antes activaremos Not monitored.
Link with Template: En este apartado podemos asociar el host a una plantilla genérica de monitorización, si pulsamos add nos abrirá una nueva ventana con las disponibles.
Use IPMI: Se recomienda leer la descripción de IPMI en "http://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface" para saber si es necesaria en nuestro caso.
Use Profile: Opción para inventariar el servidor
Use extended Profile: Idem que la anterior pero con bastantes mas opciones.

[angelhc]

Visto el descomunal exito de la propuesta cuando vaya teniendo documentación de la que estoy haciendo la colgaré por si a alguien le es útil.
Saludos-

[bashman]

Os copio mi How-to, corregirme en caso de errores y en caso de que falte algo, ampliarlo.

HOW-TO Instalar agente Zabbix en linux
===============================

Este how-to asume que vale para versiones posteriores al agente v1.4.4, ha sido probado con versiones v1.4.4, v1.6.6, v1.8.x sobre RedHat, Debian y Ubuntu.


1. Instalar agente.

A continuación se detalla la instalación del agente logueado como root.

1.1. Crear usuario zabbix, contraseña y home:

su -
groupadd zabbix
useradd -c 'Zabbix' -d /home/zabbix -g zabbix -s /bin/bash zabbix
passwd zabbix
mkdir -v /home/zabbix
cp -Rv /etc/skel/.[a-z]* /home/zabbix
chown -Rv zabbix:zabbix /home/zabbix

NOTA:

Según qué distribución no sería necesario copiar el esqueleto del home.

Uso extendido de useradd:

useradd -c <Nombre completo> -g <grupo primario> -G <admin> -s </bin/shell> -p <xxxx> -d </home/usario> -m <usuario>

Ejemplos:

useradd -G users zabbix
useradd -G users zabbix -d /home/zabbix -m

1.2. Crear los directorios de zabbix:

mkdir -v /opt/zabbix
mkdir -v /opt/zabbix/bin
mkdir -v /opt/zabbix/conf

1.3. Instalar agente:

Copiar el binario en /opt/zabbix/bin:

cp -v zabbix_agentd /opt/zabbix/bin

1.4. Instalar archivo de configuración del agente:

Copiar el archivo de configuración en /opt/zabbix/conf:

cp -v zabbix_agentd.conf /opt/zabbix/conf

1.5. Crear directorios de información, de log y cambiar el dueño y grupo:

mkdir -v /var/log/zabbix-agent
mkdir -v /var/run/zabbix-agent
chown -v zabbix:zabbix /var/log/zabbix-agent
chown -v zabbix:zabbix /var/run/zabbix-agent
chown -Rv zabbix:zabbix /opt/zabbix

1.6. Añadir las siguientes lineas al archivo /etc/services:

echo "zabbix_agent    10050/tcp                       # Zabbix ports" >> /etc/services
echo "zabbix_trap     10051/tcp" >> /etc/services

FIN INSTALACIÓN AGENTE

1.7. Esta opción sólo es necesaria si los scripts necesitan autenticación:

Dar permisos al home donde residen los scripts de monitorización (en caso de que existan), asignar a zabbix el grupo de <usuario> donde residen los scripts de monitorización, añadir al final del archivo sudoers la siguiente linea para poder ejecutar los scripts desde zabbix como <usuario>:

chmod -v g+rx /home/<usuario>
usermod -g <grupo de usuario> zabbix
echo "zabbix ALL = (<usuario>) NOPASSWD: <path/a/los/scripts/de/monitorización/*>" >> /etc/sudoers

NOTA:

Para editar a mano el archivo /etc/sudoers:

visudo -f /etc/sudoers

1.8. Comprobar el paso 1.7:

ls -l /home
cat /etc/passwd

1.9. Para desinstalar el agente:

killall /opt/zabbix/bin/zabbix_agentd
rm -Rv /opt/zabbix
rm -rv /var/log/zabbix-agent /var/run/zabbix-agent
userdel -r zabbix

2. Configurar agente.

A continuación se detalla la configuración del agente logueado como zabbix.

2.1. Crear directorio bin:

Comprobar que el usuario zabbix se encuentra en el grupo de <usuario> (sólo es necesario comprobar si los scripts necesitan alguna autenticación), dar permisos de ejecución al agente, crear el directorio bin y darle permisos:

su - zabbix
chmod -v ug+x /opt/zabbix/bin/zabbix_agentd
mkdir -v /home/zabbix/bin
chmod -v 700 /home/zabbix/bin

2.2. Crear los scripts:

Se crean los scritps de arranque/parada/chequeo del agente en /home/zabbix/bin:

echo "/opt/zabbix/bin/zabbix_agentd -c /opt/zabbix/conf/zabbix_agentd.conf" > /home/zabbix/bin/startAgenteZabbix.sh
chmod -v ug+x /home/zabbix/bin/startAgenteZabbix.sh
echo "killall /opt/zabbix/bin/zabbix_agentd" > /home/zabbix/bin/stopAgenteZabbix.sh
chmod -v ug+x /home/zabbix/bin/stopAgenteZabbix.sh
echo "pgrep -l zabbix_agentd" > /home/zabbix/bin/comprobarAgenteZabbix.sh
chmod -v ug+x /home/zabbix/bin/comprobarAgenteZabbix.sh
echo "/opt/zabbix/bin/zabbix_agentd -c /opt/zabbix/conf/zabbix_agentd.conf -t \$1" > /home/zabbix/bin/probarClave.sh 
chmod -v ug+x /home/zabbix/bin/probarClave.sh

2.3. Archivo de configuración:

Una vez instalado el archivo de configuración, es necesario modificar ciertos parámetros como la IP y el hostname. También es donde se añaden las claves:

sed -i 's/#Hostname=/Hostname='<nombre de la máquina>'/g' /opt/zabbix/conf/zabbix_agentd.conf
sed -i 's/#ListenIP=/ListenIP='<IP de la máquina>'/g' /opt/zabbix/conf/zabbix_agentd.conf

En caso de que se ejecuten scripts, hay que añadirlos con una clave. En caso de que el script necesite que sea ejecutado como <usuario>, hay que anteponer a <path al programa>, sudo -u <usuario>:

echo "UserParameter=<clave>,<path al programa>" >> /opt/zabbix/conf/zabbix_agentd.conf

Para editar el archivo de configuración a mano:

vi /opt/zabbix/conf/zabbix_agentd.conf
Hostname=<nombre de la máquina>
ListenIP=<IP de la máquina>

NOTA:

Si no se especifica “ListenIP” el agente saldrá por todas las IPs disponibles. El hostname debe ser único.

Y para los scripts:

UserParameter=<clave>,<path al programa>

Para configurar nuevos puertos, hay que indicarlo en el archivo de configuración del agente y en configuración del hosts del servidor zabbix.

2.4. Arrancar el agente:

/home/zabbix/bin/startAgenteZabbix.sh
/home/zabbix/bin/comprobarAgenteZabbix.sh

FIN CONFIGURACIÓN AGENTE

2.5. Parar y arrancar:

Para todos los cambios realizados, es necesario parar, comprobar que el agente esté parado y volver a inicar:

/home/zabbix/bin/stopAgenteZabbix.sh
/home/zabbix/bin/comprobarAgenteZabbix.sh
/home/zabbix/bin/startAgenteZabbix.sh
/home/zabbix/bin/comprobarAgenteZabbix.sh

2.6. Para probar las claves:

/home/zabbix/bin/probarClave.sh <clave a probar>

NOTA:

Con la nueva versión del agente (v1.6.6) ya no se puede probar las claves de la forma probarClaves.sh <clave> si está definida en UserParameters del zabbix_agentd-conf. De hecho en la ayuda (zabbix_agentd -h) tiene la siguiente nota: “Note that -t and -p switches do not work with user parameters. Use zabbix_get instead”. Por lo que la opción -t y -p ya no funciona para claves definidas en UserParameters, por lo que para probar claves hay que usar el programa zabbix_get del lado del servidor para que se comunique con el agente:

./zabbix_get -s<ip> -p<puerto> -k"<clave>"

2.7. Si se usan variables de entorno:

Es importante que los scripts que usen variables de entorno de <usuario>, las cargen, por lo que es recomendable que en la primera linea de los scripts de monitorización se añada.:

source <home path usuario>/.bash_profile

y en el home path es necesario introducir la ruta home de <usuario> sin usar la variable de entorno HOME, ya que tomaría el HOME de zabbix.

NOTA:

Hay que tener en cuenta que no se muestre nada en el prompt cada vez que se carge el .bash_profile.

3. Añadir agente como servicio.

A continuación se detalla cómo añadir el agente como servicio en el arranque de la máquina logueado como root.

3.1. Crear el script en "/home/zabbix/bin", cambiar permisos y crear enlace simbólico:

Obtener el archivo según la distribución: zabbix_agentd_ctl

su -
chmod -v 755 /home/zabbix/bin/zabbix_agentd_ctl
ln -s /home/zabbix/bin/zabbix_agentd_ctl /etc/init.d/zabbix_agentd_ctl

3.2. Añadir, activar y comprobar servicio, en caso de RedHat:

chkconfig --add zabbix_agentd_ctl
chkconfig --level 345 zabbix_agentd_ctl on
chkconfig --list

NOTA:

Para añadir un servicio en Debian/Ubuntu:

sudo update-rc.d <nombre_del_script> defaults

3.3. Probar arranque/estado/parada/reinicio/ayuda:

/etc/init.d/zabbix_agentd_ctl start
/etc/init.d/zabbix_agentd_ctl status
/etc/init.d/zabbix_agentd_ctl stop
/etc/init.d/zabbix_agentd_ctl restart
/etc/init.d/zabbix_agentd_ctl help

FIN AÑADIR AGENTE COMO SERVICIO

3.4. Para eliminar el agente del arranque de la máquina:

/etc/init.d/zabbix_agentd_ctl stop
chkconfig --level 345 zabbix_agentd_ctl off
chkconfig --del zabbix_agentd_ctl
rm -v /etc/init.d/zabbix_agentd_ctl

NOTA:

Para eliminar el agente del arranque de un Debian/Ubuntu:

sudo update-rc.d -f <nombre_servicio> remove

NOTA:

Para hacer un script usable por chkconfig se necesitan varias cosas:

Una cabecera que sea procesable por chkconfig que le permita saber: Nombre a usar para ese servicio, descripción de ese servicio y en que inits debe levantarse/pararse y el número de orden en el que debe ser levantado/parado (útil cuando necesitas que un servicio se levante después de haber levantado otro antes, por ejemplo, leventar mysql antes del servidor web y parar el servidor web antes que mysql).

El script necesita incluir una cabecera de este tipo:

#!/bin/bash
#
# chkconfig: <runlevels> <orden arranque (01-99)> <orden parada (01-99)>
# description: <descripción de servicio>
# processname: <nombre del proceso>
# pidfile: <path al pid file del proceso>
#

Ejemplo extraído de Tomcat:

#!/bin/sh
#
# Startup script for Tomcat Servlet Engine
#
# chkconfig: 345 99 01
# description: Tomcat Servlet Engine
# processname: tomcat
# pidfile: /usr/local/jakarta-tomcat/bin/tomcat.pid
#

Las líneas resaltadas (chkconfig, description y processname) son las que interesa informar para que chkconfig haga el trabajo de ubicar el script y los links en el arranque/parada de servicios correctamente.

chkconfig: 345 99 01 → será de lo último en arrancar y de lo primero en parar durante la subida/bajada/cambio de los runlevels 3,4 y 5.

[bashman]

Os copio otro pequeño How-to, corregirme en caso de errores y en caso de que falte algo, ampliarlo.

HOW-TO Escalada y repetición de alertas
================================

Este how-to asume que vale para versiones v1.8, ha sido probado con versiones v1.8.1 y v1.8.2.

Documentación oficial:

http://www.zabbix.com/documentation/..._notifications

Hay varias formas de gestionar un problema a través de una acción:

1. A través de mensajes simples, alertando al instante.
2. Escalar los mensajes hacia el jefe y/o otros grupos.
3. Ejecución de commandos remotos.
4. Notificaciones repetidas hasta que se resuelve el problema.
5. Notificaciones y comandos retardados.
6. Escenario complejo, la combinación de todo lo anterior.

Lo importante de las acciones es definir bien las condiciones y las operaciones. Hay tres condiciones necesarias en cada acción:

* Trigger value = “PROBLEM”
* Trigger severity >= “Average” o Trigger severity >= “High”
* Host group = ”<grupo de máquinas>”

Las operaciones pueden ser: mensajes, ejecución de comandos o ambos. Para escalar hay que habilitar las escaladas y definir el periodo en el que se iniciaran esas escaladas, que se definen a través de pasos.

Cuando se crea una operación se puede definir un paso, a través de tres valores, el paso 1 siempre es el instantáneo y no le afecta la escalada:

* From: Dónde comienza el paso. Por ejemplo definimos un periodo inicial de escalada de 5 minutos, el paso 2 empezará a los 5 minutos y el 3 a los 10.
* To: Dónde finaliza el paso. Por ejemplo si no queremos que se repita este paso, este campo tendrá el mismo valor que el anterior, pero si por ejemplo definimos un periodo inicial de escalada de una hora y el paso se inicia en 2, si definimos el fin del paso en 5, se repetirá el paso cada hora durante 4 horas.
* Period: Permite substituir el periodo inicial de la escalada por un nuevo periodo para este paso. Por ejemplo, tenemos un periodo inicial de 5 minutos y queremos que cuando se ejecute este paso se repita 4 veces cada hora, pues definimos un periodo de 1 hora y el paso se inicia en 2 y acaba en 5.

La operación además del paso se define el tipo de operación (mensaje o ejecución de comando), mandar mensaje a usuario o grupo de usuarios, mandar a email, jabber o sms, permite definir un nuevo mensaje y añadir una condición para deshabilitar la escalada cuando se acepta (ack) el problema a través del dashboard (Event acknowledged = “Not Ack”).

Con todo esto se puede hacer una escalada y repetición de mensajes.

[la mujer esponja]

Agrupacion de How-TO en una web

No es mejor agrupar todos los HOW-TO en una web en vez de que se pierda este hilo en el foro? O hacerlo como un post permanente en lo alto de la lista de hilos.

Es posible?

Pero principalmente... gracias por vuestros esfuerzos!!

[exkg]

Creo que es mejor usar el WIKI para eso ... http://www.zabbix.org/. Que opinan ?


[]s,
Luciano

[angelhc]

Creo que la wiki no tiene apartado por idiomas y la documentación oficial si, aunque hacer una traducción de toda ella puede ser una tarea titanica la verdad.
Mandaré un mensaje al administrador para que ponga este post como fijo a ver qué opina
Gracias a tod@s por vuestras aportaciones.

[exkg]

... yo lo pongo ...


[]s,
Luciano

[angelhc]

Gracias exkg!!

[davidperez]

traduccion

Hola
veo que tenemos 2 vias
*a traves de zabbix.org, que si podemos poner los howto
*a traves de zabbix.com en documentos, donde podemos traducir el manual de la actual 2.2. Hace unos dias cree una horquilla que me ha sido movida aqui

https://www.zabbix.org/wiki/Translating_Zabbix/Spanish

podriamos allí hacer los howto.

que opinais?

[angelhc]

Buenas,
Gran idea davidperez!, por mi parte creo que lo mejor es participar en la traducción de la documentación por una parte y por la otra subir los how-to a zabbix.org.

Creo que esta parte de how-to está un poco olvidada, si puedo sacar tiempo prometo subir algo nuevo!

Gracias.

[davidperez]

estoy traduciendo por otra via

preferiria un trabajo colaborativo, pero....estoy traduciando en otro lado segun me interesa ir aprendiendo.
Tampoco se si vamos a instalar ZABBIX y por tanto, si voy a poder dedicar tiempo a aprenderlo.

[angelhc]

Buenas,
Más colaborativo que hacerlo entre todos no hay ¿no?
Si en tu empresa estáis buscando una herramienta de monitorización y no tenéis mas o menos 1M€ para gastaros en otras.. decidiros por zabbix. Yo hice el bussiness case y salía casi solo.

[angelhc]

[How-to] Instalar desde cero

Adjunto un mini.how-to de instalación de Zabbix desde consola, por supuesto son mis preferencias de directorios y de motor de db pero cada cual es libre de instalar el que quiera.
Disfrútenlo!


Instalar zabbix desde cero
#############################


Requisitos en linux:
=====================

• gcc
• mysql / mysql-server / mysql-devel
• curl / curl-devel
• httpd
• php / php-mysql / php-bcmath / php-gd / php-mbstring / php-xml
• net-snmp / net-snmp-devel
• fping
• e2fsprogs / e2fsprogs-devel
• tcpdump / tcp_wrappers
• OpenIPMI / OpenIPMI-devel
• libssh2 / libssh2-devel

En red-hat/Centos se instala así:
================================
yes | yum install gcc
yes | yum install mysql
yes | yum install mysql-server
yes | yum install mysql-devel
yes | yum install curl
yes | yum install curl-devel
yes | yum install httpd
yes | yum install php
yes | yum install php-mysql
yes | yum install php-bcmath
yes | yum install php-gd
yes | yum install php-mbstring
yes | yum install php-xml
yes | yum install net-snmp
yes | yum install net-snmp-devel
yes | yum install e2fsprogs
yes | yum install e2fsprogs-devel
yes | yum install tcpdump
yes | yum install tcp_wrappers
yes | yum install OpenIPMI
yes | yum install OpenIPMI-devel
yes | yum install libssh2
yes | yum install libssh2-devel

• Se inicia la base de datos (como root)
# /etc./init.d/mysqld start
• Inicialmente la base de datos no tiene password de su usuario administrador (root) por que se procede a asignar dicha password.
# mysqladmin –uroot password <nueva_password>

Localizar el archivo my.cnf y agregar (si no lo tiene): innodb_file_per_table
Para que cada tabla se genere en un fichero.

Dar permisos de ejecución al comando fping para todos los usuarios
# chmod 4755 /usr/sbin/fping

Copiar el paquete de Zabbix en /home/Zabbix y descomprimirlo
# tar zvzf zabbix-2.2.1.tar.gz

Acceder a la carpeta /home/zabbix/zabbix-xxxx, donde se encuentra el binario configure
que el encargado de crearnos el makefile en base a las opciones con que se compile el software:
# ./configure –enable-agent –enable-server –with-mysql –with-libcurl –with-net-snmp –with-openipmi –with-libssh –prefix=
/home/zabbix/zabbix-2.2.1
Donde:
• --enable-agent: compila el agente de Zabbix
• --enable_server: compila el servidor de Zabbix.
• --with_mysql: habilita la base de datos de MySQL
• --with-libcurl: habilita la compilación con la opción curl que da soporte a la monitorización web.
• --with-net-snmp: habilita la compilación con la opción snmp que da soporte a la monitorización vía snmp
• --with-openipmi: habilita la compilación con la opción ipmi que da soporte a la monitorización via IPMI
• --with-libssh: habilita la compilación con la opción ssh para la monitorización via ssh.
• --prefix=/home/zabbix/zabbix-1.8.2: indica el path donde deja los compilados


Una vez terminado, lanzar el comando:
# make install

Crear la siguiente estructura de directorios bajo el /home/zabbix para:
Para el servidor
--------------------
i /home/zabbix/zabbix-server/sbin: ubicación para almacenar los binarios del servidor de Zabbix
ii /home/zabbix/zabbix-server/var: ubicación para almacenar el fichero zabbix_server.pid
iii /home/zabbix/zabbix-server/log: ubicación para almacenar el fichero zabbix_server.log
iv /home/zabbix/zabbix-server/conf: ubicación para almacenar el fichero Zabbix_server.conf (fichero de configuración)
Para el agente
------------------
i. /home/zabbix/zabbix-agentd/sbin: ubicación para almacenar los binarios del agente de zabbix
ii. /home/zabbix/zabbix-agentd/var: ubicación para almacenar el fichero zabbix_agentd.pid
iii. /home/zabbix/zabbix-agentd/log: ubicación para almacenar el fichero zabbix_agentd.log
iv. /home/zabbix/zabbix-server/conf: ubicación para almacenar el fichero zabbix_agentd.conf (fichero de configuración)


Crear la Base de datos:

# mysql –uroot –p<password>
mysql> create database zabbix;
mysql>quit;

Crear la estructura de la base de datos. Para ello hay que ejecutar lo siguiente:
# cd /home/zabbix/zabbix-2.2.1/databases/mysql/schema
# cat /home/zabbix/zabbix-2.0.5/database/mysql/data.sql | mysql –uroot –p<password> zabbix
# cat /home/zabbix/zabbix-2.0.5/database/mysql/images.sql | mysql –uroot –p<password> zabbix
# cat /home/zabbix/zabbix-2.0.5/database/mysql/schema.sql| mysql –uroot –p<password> zabbix

Copiar los ficheros de frontend:
cp –r /home/zabbix/zabbix-2.2.1/frontends/php/ /var/www/html/zabbix

Arrancar el zabbix_server:

/home/zabbix/zabbix-server/sbin/zabbix_server --config /home/zabbix/zabbix-server/conf/zabbix_server.conf

Abrir un navegador y dirigirnos a http://<zabbix-server/zabbix y seguir las indicaciones del instalador gráfico.