Documentation

Manual de Zabbix

1 Introducción

1 Estructura del manual

2 Qué es Zabbix

3 Funcionalidades de Zabbix

4 Resumen de Zabbix

5 Novedades en Zabbix 8.0.0

6 Novedades en Zabbix 8.0.x

3 Procesos de Zabbix

1 Servidor

1 Alta disponibilidad

2 Agente

3 Agente 2

4 Proxy

1 Instalación desde fuentes

2 Instalación desde paquetes RHEL

3 Instalación desde paquetes Debian/Ubuntu

6 Remitente

7 Obtener

8 JS

1 Obtener Zabbix

3 Instalación desde fuentes

1 Compilar el agente Zabbix en Windows

2 Compilar Zabbix agent 2 en Windows

3 Compilar el agente de Zabbix en macOS

4 Instalación desde paquetes

1 Red Hat Enterprise Linux y derivados

2 Debian/Ubuntu/Raspbian

3 SUSE Linux Enterprise Server

4 Instalación del agente de Windows desde MSI

5 Instalación del agente Mac OS desde PKG

6 Versiones inestables

5 Instalación desde contenedores

6 Instalación de la interfaz web

7 Procedimiento de actualización

1 Actualización desde fuentes

2 Actualización desde paquetes

1 Red Hat Enterprise Linux

2 Debian/Ubuntu

3 Actualización desde contenedores

8 Problemas conocidos

1 Problemas de compilación

2 Problemas de actualización relacionados con el escape

9 Cambios en las plantillas

10 Notas de actualización para 8.0.0

11 Notas de actualización para 8.0.x

5 Inicio rápido

1 Inicio de sesión y configuración de usuario

3 Nueva métrica

4 Nuevo disparador

5 Recibir notificación de problema

6 Nueva plantilla

6 Zabbix appliance

7 Configuración

1 Equipos y grupos de equipos

1 Asistente de equipos

2 Configuración de un equipo

3 Configuración de un grupo de equipos

4 Inventario

5 Actualización masiva

2 Métricas

1 Creando una métrica

1 Formato de clave de métrica

2 Intervalos personalizados

2 Preprocesamiento de valores de métricas

1 Prueba de preprocesamiento

2 Detalles del preprocesamiento

3 Ejemplos de preprocesamiento

4 Funcionalidad JSONPath

1 Escape de caracteres especiales de valores de macros LLD en JSONPath

5 Preprocesamiento de JavaScript

1 Objetos JavaScript adicionales

2 Objetos JavaScript de métricas de navegador

6 Preprocesamiento de CSV a JSON

3 Tipos de métricas

1 Agente Zabbix

1 Agente Zabbix 2

2 Agente Zabbix para Windows

2 Agente SNMP

1 Índices dinámicos

2 OIDs especiales

3 archivos MIB

3 Trampas SNMP

4 Comprobaciones IPMI

5 Comprobaciones simples

1 Claves de métricas de monitorización de VMware

6 Monitorización de archivos de registro

7 Métricas calculadas

1 Cálculos agregados

8 Comprobaciones internas

9 Comprobaciones SSH

10 Comprobaciones Telnet

11 Comprobaciones externas

12 Métricas trapper

13 Monitorización JMX

14 Monitorización ODBC

15 Métricas dependientes

16 Agente HTTP

17 Comprobaciones de Prometheus

18 Métricas de script

19 Métricas de navegador

4 Historial y tendencias

5 Parámetros de usuario

1 Ampliar los agentes de Zabbix

6 Contadores de rendimiento de Windows

7 Actualización masiva

8 Mapeo de valores

9 Cola

10 Caché de valores

11 Ejecutar ahora

12 Restringir comprobaciones del agente

1 Configuración de un disparador

2 Expresión de disparador

3 Dependencias de disparadores

4 Gravedad del disparador

5 Personalización de las severidades de disparadores

6 Actualización masiva

7 Funciones de disparador predictivas

4 Eventos

1 Generación de eventos de disparadores

2 Otras fuentes de eventos

3 Cierre manual de problemas

5 Correlación de eventos

1 Correlación de eventos basada en disparadores

2 Correlación global de eventos

7 Visualización

1 Gráficas

1 Gráficas simples

2 Gráficas personalizadas

3 Gráficas ad-hoc

4 Agregación en gráficos

2 Mapas de red

1 Configuración de un mapa de red

2 Elementos de grupo de equipos

3 Indicadores de enlace

3 Paneles

8 Plantillas y grupos de plantillas

1 Configurando una plantilla

2 Configuración de un grupo de plantillas

3 Enlazar/desenlazar

4 Anidamiento

5 Actualización masiva

9 Plantillas listas para usar

1 Operación de plantilla de agente Zabbix

2 Funcionamiento de la plantilla de Zabbix agent 2

3 Operación de plantilla HTTP

4 Funcionamiento de la plantilla IPMI

5 Funcionamiento de la plantilla JMX

6 Funcionamiento de la plantilla ODBC

7 Plantillas estandarizadas para dispositivos de red

8 Funcionamiento de la plantilla de VMware

10 Notificaciones ante eventos

1 Tipos de medios

1 Correo electrónico

1 Tipos de medios automatizados de Gmail/Office365

2 SMS

3 Scripts de alerta personalizados

4 Webhook

1 Ejemplos de scripts de Webhook

2 Acciones

1 Condiciones

2 Operaciones

1 Enviando mensaje

2 Comandos remotos

3 Operaciones adicionales

4 Uso de macros en mensajes

3 Operaciones de recuperación

4 Actualizar operaciones

5 Escalados

3 Recibir notificaciones sobre métricas no soportadas

11 Macros

1 Funciones de macro

2 Macros de usuario

3 Macros de usuario con contexto

4 Macros de usuario secretas

5 Macros de bajo nivel de descubrimiento

6 Macros de expresión

12 Usuarios y grupos de usuarios

1 Configuración de un usuario

2 Permisos

3 Grupos de usuarios

13 Almacenamiento de secretos

1 Configuración de CyberArk

2 Configuración de HashiCorp

14 Informes programados

15 Exportación de datos

1 Exportar a archivos

2 Transmisión a sistemas externos

3 gateway SNMP

8 Monitorización de servicios

1 Árbol de servicios

2 ANS

3 Ejemplo de configuración

9 Monitorización web

1 Métricas de monitorización web

2 Escenario de la vida real

10 Monitorización de máquinas virtuales

1 Claves de métricas de monitorización de VMware

2 Campos clave de descubrimiento de máquinas virtuales

3 ejemplos de JSON para métricas de VMware

4 Ejemplo de configuración de monitorización de VMware

11 Mantenimiento

12 Expresiones regulares

13 Reconocimiento de problemas

1 Supresión de problemas

14 Exportación/importación de configuración

1 Grupos de plantillas

2 Grupos de equipos

4 Equipos

6 Tipos de medios

15 Descubrimiento

1 Descubrimiento de red

1 Configuración de una regla de descubrimiento de red

2 Autoregistro activo del agente

3 Descubrimiento de bajo nivel

1 Prototipos de métricas

2 Prototipos de disparadores

3 Prototipos de gráficos

4 Prototipos de equipos

5 Prototipos de descubrimiento

6 Notas sobre el descubrimiento de bajo nivel

7 Reglas de descubrimiento

1 Descubrimiento de sistemas de archivos montados

2 Descubrimiento de interfaces de red

3 Descubrimiento de CPUs y núcleos de CPU

4 Descubrimiento de OIDs SNMP

5 Descubrimiento de OIDs SNMP (heredado)

6 Descubrimiento de objetos JMX

7 Descubrimiento de sensores IPMI

8 Descubrimiento de servicios systemd

9 Descubrimiento de servicios de Windows

10 Descubrimiento de instancias de contadores de rendimiento de Windows

11 Descubrimiento usando consultas WMI

12 Descubrimiento usando consultas SQL ODBC

13 Descubrimiento usando datos de Prometheus

14 Descubrimiento de dispositivos de bloques

15 Descubrimiento de interfaces de equipo en Zabbix

8 Reglas LLD personalizadas

16 Monitorización distribuida

1 Proxies

1 Sincronización de la configuración de monitorización

2 Balanceo de carga y alta disponibilidad de proxy

1 Usar certificados

2 Uso de claves precompartidas

3 Resolución de problemas

1 Problemas de tipo de conexión o permisos

2 Problemas de certificados

3 Problemas con PSK

18 Interfaz web

1 Menú

1 Menú de evento

2 Menú de equipo

3 Menú de métricas

2 Secciones del frontend

1 Paneles

1 Widgets del panel de control

1 Registro de acciones

2 Reloj

3 Estado de descubrimiento

4 Gráficas favoritas

5 Mapas favoritos

6 Medidor

7 Geomapa

8 Gráfico

9 Gráfico (clásico)

10 Prototipo de gráfico

11 Honeycomb

12 Disponibilidad del equipo

13 Tarjeta de equipo

14 Navegador de equipos

15 Tarjeta de métrica

16 Historial de métricas

17 Navegador de métricas

18 Valor de la métrica

19 Mapa

20 Árbol de navegación de mapas

21 Gráfico circular

22 Equipos con problemas

23 Problemas

24 Problemas por gravedad

25 Informe de SLA

26 Información del sistema

27 Equipos principales

28 Principales métricas

29 Principales disparadores

30 Resumen de disparadores

31 URL

32 Monitorización web

2 Monitorización

1 Problemas

1 Problemas de causa y síntoma

2 Equipos

1 Gráficas

2 Paneles de equipo

3 Escenarios web

3 Últimos datos

4 Mapas

5 Descubrimiento

3 Servicios

1 Servicios

2 ANS

3 Informe de SLA

4 Inventario

1 Visión general

2 Equipos

5 Informes

1 Información del sistema

2 Informes programados

3 Informe de disponibilidad

4 Top 100 disparadores

5 Registro de auditoría

6 Registro de acciones

7 Notificaciones

6 Recopilación de datos

1 Grupos de plantillas

2 Grupos de equipos

3 Plantillas

1 Métricas

2 Disparadores

3 Gráficos

4 Reglas de descubrimiento

1 Prototipos de métricas

2 Prototipos de disparadores

3 Prototipos de gráficos

4 Prototipos de equipos

5 Prototipos de descubrimiento

5 Escenarios web

4 Equipos

1 Métricas

2 Disparadores

3 Gráficos

4 Reglas de descubrimiento

1 Prototipos de métricas

2 Prototipos de disparadores

3 Prototipos de gráficos

4 Prototipos de equipos

5 Prototipos de descubrimiento

5 Escenarios web

5 Mantenimiento

6 Correlación de eventos

7 Descubrimiento

7 Alertas

1 Acciones

2 Tipos de medios

3 Scripts

8 Usuarios

1 Grupos de usuarios

2 Roles de usuario

3 Usuarios

4 Tokens de API

5 Autenticación

1 HTTP

2 LDAP

3 SAML

4 MFA

9 Administración

1 General

2 Registro de auditoría

3 Mantenimiento

4 Proxies

5 Grupos de proxies

6 Macros

7 Cola

3 Configuración de usuario

1 Notificaciones globales

2 Sonido en navegadores

4 Búsqueda global

5 Modo de mantenimiento del frontend

6 Parámetros de página

8 Creando su propio tema

9 Modo de depuración

10 Cookies utilizados por Zabbix

11 Zonas horarias

12 Restablecer la contraseña

13 Selector de periodo de tiempo

19 Mejores prácticas

1 Mejores prácticas de seguridad

1 Control de acceso

1 Asegurar MySQL/MariaDB

2 Asegurando PostgreSQL/TimescaleDB

2 Criptografía

3 Servidor web

2 Mejores prácticas de configuración

20 API

Referencia de métodos

Acción

Objeto acción

action.create

action.delete

action.get

action.update

Alerta

Objeto de alerta

alert.get

Autenticación

Objeto de autenticación

authentication.get

authentication.update

Autoregistro

Objeto de autorregistro

autoregistration.get

autoregistration.update

Comprobación de descubrimiento

Objeto de comprobación de descubrimiento

dcheck.get

Conector

Objeto conector

connector.create

connector.delete

connector.get

connector.update

Configuración

configuration.export

configuration.import

configuration.importcompare

Configuración

Objeto de configuración

settings.get

settings.update

Correlación

Objeto correlación

correlation.create

correlation.delete

correlation.get

correlation.update

Directorio de usuarios

Objeto de directorio de usuario

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

Disparo

Objeto trigger

trigger.create

trigger.delete

trigger.get

trigger.update

Equipo

Objeto equipo

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Equipo detectado

Objeto de equipo descubierto

dhost.get

Escenario web

Objeto de escenario web

httptest.create

httptest.delete

httptest.get

httptest.update

Evento

Objeto evento

event.acknowledge

event.get

Expresión regular

Objeto de expresión regular

regexp.create

regexp.delete

regexp.get

regexp.update

Grupo de equipos

Objeto de grupo de equipos

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.update

Grupo de plantillas

Objeto de grupo de plantillas

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

Grupo de proxy

Objeto de grupo de proxy

proxygroup.create

proxygroup.delete

proxygroup.get

proxygroup.update

Grupo de usuarios

Objeto de grupo de usuarios

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

Gráfico

Objeto gráfico

graph.create

graph.delete

graph.get

graph.update

Historial

Objeto de historial

history.clear

history.get

history.push

Housekeeping

Objeto de mantenimiento

housekeeping.get

housekeeping.update

Imagen

Objeto de imagen

image.create

image.delete

image.get

image.update

Información de la API

apiinfo.version

Informe

Objeto report

report.create

report.delete

report.get

report.update

Interfaz de equipo

Objeto de interfaz de equipo

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Macro de usuario

Objeto macro de usuario

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

Mantenimiento

Objeto de mantenimiento

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Mapa

Objeto de mapa

map.create

map.delete

map.get

map.update

Mapa de iconos

Objeto de mapa de iconos

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

Mapa de valores

Objeto de mapa de valores

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

MFA

Objeto MFA

mfa.create

mfa.delete

mfa.get

mfa.update

Métrica

Objeto de métrica

item.create

item.delete

item.get

item.update

Métrica de gráfico

Objeto de métrica de gráfico

graphitem.get

Módulo

Objeto módulo

module.create

module.delete

module.get

module.update

Nodo de alta disponibilidad

Objeto de nodo de alta disponibilidad

hanode.get

Panel de control

Objeto dashboard

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

Campos de los widgets del panel

1 Registro de acciones

2 Reloj

3 Estado de descubrimiento

4 Gráficas favoritas

5 Mapas favoritos

6 Medidor

7 Geomapa

8 Gráfico

9 Gráfico (clásico)

10 Prototipo de gráfico

11 Honeycomb

12 Disponibilidad del equipo

13 Tarjeta de equipo

14 Navegador de equipos

15 Tarjeta de métrica

16 Historial de métricas

17 Navegador de métricas

18 Valor de la métrica

19 Mapa

20 Árbol de navegación de mapas

21 Gráfico circular

22 Equipos con problemas

23 Problemas

24 Problemas por severidad

25 Informe de SLA

26 Información del sistema

27 Equipos principales

28 Métricas principales

29 Principales disparadores

30 Resumen de disparadores

31 URL

32 Monitorización web

Plantilla

Objeto de plantilla

template.create

template.delete

template.get

template.massadd

template.massremove

template.massupdate

template.update

Plantilla de panel

Objeto de panel de plantilla

templatedashboard.create

templatedashboard.delete

templatedashboard.get

templatedashboard.update

Problema

Objeto problema

problem.get

Prototipo de disparador

Objeto prototipo de disparador

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

Prototipo de equipo

Objeto prototipo de equipo

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Prototipo de gráfico

Objeto prototipo de gráfico

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

Prototipo de métrica

Objeto prototipo de métrica

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

Prototipo de regla LLD

Objeto prototipo de regla LLD

discoveryruleprototype.create

discoveryruleprototype.delete

discoveryruleprototype.get

discoveryruleprototype.update

Proxy

Objeto proxy

proxy.create

proxy.delete

proxy.get

proxy.update

Registro de auditoría

Objeto de registro de auditoría

auditlog.get

Regla de descubrimiento

Objeto de regla de descubrimiento

drule.create

drule.delete

drule.get

drule.update

Regla LLD

Objeto de regla LLD

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Rol

Objeto de rol

role.create

role.delete

role.get

role.update

Script

Objeto script

script.create

script.delete

script.execute

script.get

script.getscriptsbyevents

script.getscriptsbyhosts

script.update

Servicio

Objeto de servicio

service.create

service.delete

service.get

service.update

Servicio descubierto

Objeto de servicio descubierto

dservice.get

SLA

Objeto SLA

sla.create

sla.delete

sla.get

sla.getsli

sla.update

Tarea

Objeto de tarea

task.create

task.get

Tendencia

Objeto de tendencia

trend.get

Tipo de medio

Objeto tipo de medio

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Token

Objeto token

token.create

token.delete

token.generate

token.get

token.update

Usuario

Objeto usuario

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.provision

user.resettotp

user.unblock

user.update

Apéndice 1. Comentario de referencia

Apéndice 2. Cambios de 7.4 a 8.0

Apéndice 3. Cambios en 8.0

1 Módulos cargables

2 Plugins

1 Compilación de plugins cargables

3 Módulos del frontend

1 Instalación y configuración

1 Creación de la base de datos

2 Reparar el conjunto de caracteres y la intercalación de la base de datos de Zabbix

3 Actualización de la base de datos a claves primarias

4 Preparando la tabla auditlog para particionado

5 Conexión segura a la base de datos

1 Configuración de cifrado de MySQL

2 Configuración de cifrado de PostgreSQL

6 Conexión segura a la interfaz web

7 Configuración de TimescaleDB

8 Configuración de Elasticsearch

9 Notas específicas de la distribución sobre la configuración de Nginx para Zabbix

10 Ejecutar el agente como root

11 Agente Zabbix en Microsoft Windows

12 Configuración de SAML con Microsoft Entra ID

13 Configuración de SAML con Okta

14 Configuración de SAML con OneLogin

15 Configuración de informes programados

16 Idiomas adicionales para la interfaz web

2 Configuración de procesos

1 Servidor Zabbix

2 Proxy de Zabbix

3 Agente Zabbix (UNIX)

4 Agente Zabbix 2 (UNIX)

5 Agente Zabbix (Windows)

6 Agente Zabbix 2 (Windows)

7 Plugins de Zabbix agent 2

1 Plugin de Ceph

2 Plugin de Docker

3 Plugin Ember+

4 Plugin de Memcached

5 Plugin Modbus

6 Plugin de MongoDB

7 Plugin MQTT

8 Plugin MSSQL

9 Plugin de MySQL

10 Plugin de GPU NVIDIA

11 Plugin de Oracle

12 Plugin de PostgreSQL

13 Plugin de Redis

14 plugin SMART

8 Java gateway de Zabbix

9 Servicio web de Zabbix

10 Variables de entorno

11 Inclusión

1 Protocolo de intercambio de datos entre servidor y proxy

2 Protocolo de agente/agent2 de Zabbix

4 Protocolo de plugin de Zabbix agent 2

5 Protocolo de envío de Zabbix

6 Encabezado

7 Protocolo de exportación JSON delimitado por nueva línea

4 Métricas

1 parámetros de vm.memory.size

2 Comprobaciones pasivas y activas del agente

3 Nivel mínimo de permisos para las métricas del agente de Windows

4 Codificación de los valores devueltos

5 Soporte para archivos grandes

6 Sensor

7 Notas sobre el parámetro memtype en métricas proc.mem

8 Notas sobre la selección de procesos en las métricas proc.mem y proc.num

9 Detalles de implementación de las comprobaciones net.tcp.service y net.udp.service

10 parámetros de proc.get

11 Configuración de la interfaz de equipo inaccesible/no disponible

12 Monitorización remota de estadísticas de Zabbix

13 Configuración de Kerberos con Zabbix

14 parámetros de modbus.get

15 Creación de nombres personalizados de contadores de rendimiento para VMware

16 Valores de retorno para system.sw.packages.get

17 Valores de retorno para net.dns.get

18 Notas sobre las métricas system.cpu.util en Windows

5 Funciones soportadas

1 Funciones agregadas

1 Funciones Foreach

2 Funciones bit a bit

3 Funciones de fecha y hora

4 Funciones de histórico

5 Funciones de tendencias

6 Funciones matemáticas

7 Funciones de operador

8 Funciones predictivas

9 Funciones de cadenas

6 Macros

1 Macros admitidas por ubicación

2 Macros de usuario admitidas por ubicación

7 Símbolos de unidad

8 Sintaxis de periodo de tiempo

9 Ejecución de comandos

10 Compatibilidad de versiones

12 Biblioteca de enlace dinámico Zabbix sender para Windows

13 Biblioteca de Python para la API de Zabbix

14 Actualización de la monitorización de servicios

15 Otros problemas

16 Comparación entre agente y agente 2

17 Ejemplos de escape

23 Guías de referencia rápida

1 Monitorizar Linux con el agente Zabbix

2 Monitorizar Windows con el agente Zabbix

3 Monitorizar Apache mediante HTTP

4 Monitorizar MySQL con Zabbix agent 2

5 Monitorizar VMware con Zabbix

6 Supervisar el tráfico de red con Zabbix

7 Monitorizar el tráfico de red utilizando comprobaciones activas

8 Supervisar sitios web con métricas de navegador

9 Supervisar certificados de sitios web con Zabbix agent 2 (pasivo)

10 Supervisar un switch o router de red con Zabbix

11 Monitorizar el registro de eventos de Windows utilizando comprobaciones activas

1 Implementar Zabbix con Zabbix Cloud

2 Configuración de nodo

3 Añadir usuarios

Centro de Desarrolladores

Módulos

Estructura de archivos del módulo

manifest.json

Acciones

Vistas

Recursos

Registrar un nuevo módulo

Widgets

Configuración

Presentación

Tutoriales

Crear un módulo (tutorial)

Crear un widget (tutorial)

Ejemplos

Plugins

Ejemplos

Crear un plugin (tutorial)

Interfaces de plugin

Cambios en el desarrollo de extensiones

Páginas de manual de Zabbix

zabbix_web_service

Table of Contents

Tutoriales

Tutoriales

Esta sección contiene tutoriales prácticos paso a paso para ilustrar cómo construir un módulo y un widget personalizados en Zabbix.