Documentation

Manual do Zabbix

1 Estrutura do manual

2 O que é o Zabbix

3 Funcionalidades do Zabbix

4 Visão geral do Zabbix

5 Novidades do Zabbix 8.0.0

6 Novidades no Zabbix 8.0.x

3 Processos do Zabbix

1 Server

1 Alta disponibilidade

2 Agent

3 Agent 2

4 Proxy

1 Instalação a partir do código-fonte

2 Instalação a partir de pacotes RHEL

3 Instalação a partir de pacotes Debian/Ubuntu

6 Sender

7 Obter

8 JS

1 Obtendo o Zabbix

3 Instalação a partir do código-fonte

1 Compilando o agent do Zabbix no Windows

2 Compilando o Zabbix agent 2 no Windows

3 Compilando o agent Zabbix no macOS

4 Instalação a partir de pacotes

1 Instalação do agent do Windows a partir do MSI

2 Instalação do agent no macOS a partir do PKG

3 Lançamentos instáveis

5 Instalação a partir de containers

6 Instalação da interface web

7 Procedimento de atualização

1 Atualização a partir do código-fonte

2 Atualização a partir de pacotes

1 Red Hat Enterprise Linux

2 Debian/Ubuntu

3 Atualização a partir de containers

8 Problemas conhecidos

1 Problemas de compilação

2 Problemas de atualização relacionados ao escape

9 Alterações em templates

10 Notas de atualização para 8.0.0

11 Notas de atualização para 8.0.x

5 Início rápido

1 Login e configuração do usuário

2 Novo host

3 Novo item

5 Recebendo notificações de problemas

6 Novo template

6 Zabbix appliance

7 Configuração

1 Hosts e grupos de hosts

1 Assistente de host

2 Configurando um host

3 Configurando um grupo de hosts

4 Inventário

5 Atualização em massa

2 Items

1 Criando um item

1 Formato da chave do item

2 Intervalos personalizados

2 Pré-processamento de valor de item

1 Teste de pré-processamento

2 Detalhes do pré-processamento

3 Exemplos de pré-processamento

4 Funcionalidade JSONPath

1 Escape de caracteres especiais de valores de macros LLD em JSONPath

5 Pré-processamento JavaScript

1 Objetos JavaScript adicionais

2 Objetos JavaScript de item de navegador

6 Pré-processamento de CSV para JSON

3 Tipos de item

1 Agent Zabbix

1 Zabbix agent 2

2 Agent Zabbix para Windows

2 Agente SNMP

1 Índices dinâmicos

2 OIDs especiais

3 Arquivos MIB

3 Traps SNMP

4 Verificações IPMI

5 Verificações simples

1 Chaves de item de monitoramento do VMware

6 Monitoramento de arquivos de log

7 Itens calculados

1 Cálculos agregados

8 Verificações internas

9 Verificações SSH

10 Verificações Telnet

11 Verificações externas

12 Itens trapper

13 Monitoramento JMX

14 Monitoramento ODBC

15 Items dependentes

16 Agente HTTP

17 Verificações do Prometheus

18 Itens de script

19 Itens de navegador

4 Histórico e tendências

5 Parâmetros de usuário

1 Estendendo os agents do Zabbix

6 Contadores de desempenho do Windows

7 Atualização em massa

8 Mapeamento de valores

9 Fila

10 Cache de valores

11 Executar agora

12 Restringindo verificações do agent

3 Triggers

1 Configurando um trigger

2 Expressão de trigger

3 Dependências de trigger

4 Severidade do trigger

5 Personalizando severidades de trigger

6 Atualização em massa

7 Funções de trigger preditivas

4 Eventos

1 Geração de evento de trigger

2 Outras fontes de eventos

3 Fechamento manual de problemas

5 Correlação de eventos

1 Correlação de eventos baseada em trigger

2 Correlação global de eventos

6 Tagging

7 Visualização

1 Gráficos

1 Gráficos simples

2 Gráficos personalizados

3 Gráficos ad-hoc

4 Agregação em gráficos

2 Mapas de rede

1 Configurando um mapa de rede

2 Elementos de grupo de hosts

3 Indicadores de link

3 Dashboards

8 Templates e grupos de templates

1 Configurando um template

2 Configurando um grupo de templates

3 Vinculando/desvinculando

4 Aninhamento

5 Atualização em massa

9 Templates prontos para uso

1 Operação de template de agent Zabbix

2 Operação de template do Zabbix agent 2

3 Operação de template HTTP

4 Operação de template IPMI

5 Operação do template JMX

6 Operação de template ODBC

7 Templates padronizados para dispositivos de rede

8 Operação de template VMware

10 Notificações em eventos

1 Tipos de mídia

1 E-mail

1 Tipos de mídia automatizados do Gmail/Office365

2 SMS

3 Scripts de alerta personalizados

4 Webhook

1 Exemplos de scripts de webhook

2 Ações

1 Condições

2 Operações

1 Enviando mensagem

2 Comandos remotos

3 Operações adicionais

4 Usando macros em mensagens

3 Operações de recuperação

4 Atualizar operações

5 Escalonamentos

3 Recebendo notificação sobre items não suportados

11 Macros

1 Funções de macro

2 Macros de usuário

3 Macros de usuário com contexto

4 Macros de usuário secretas

5 Macros de descoberta de baixo nível

6 Macros de expressão

12 Usuários e grupos de usuários

1 Configurando um usuário

2 Permissões

3 Grupos de usuários

13 Armazenamento de segredos

1 Configuração do CyberArk

2 Configuração do HashiCorp

14 Relatórios agendados

15 Exportação de dados

1 Exportar para arquivos

2 Transmitindo para sistemas externos

3 SNMP gateway

8 Monitoramento de serviços

1 Árvore de serviços

2 SLA

3 Exemplo de configuração

9 Monitoramento web

1 Itens de monitoramento web

2 Cenário da vida real

10 Monitoramento de máquinas virtuais

1 Chaves de item de monitoramento do VMware

2 Campos de chave de descoberta de máquina virtual

3 exemplos de JSON para items VMware

4 Exemplo de configuração de monitoramento VMware

11 Manutenção

12 Expressões regulares

13 Reconhecimento de problema

1 Supressão de problema

14 Exportação/importação de configuração

1 Grupos de templates

2 Grupos de hosts

3 Templates

4 Hosts

5 Mapas de rede

6 Tipos de mídia

1 Descoberta de rede

1 Configurando uma regra de descoberta de rede

2 Autoregistro de agent ativo

3 Descoberta de baixo nível

1 Prototipagem de items

2 Protótipos de trigger

3 Protótipos de gráficos

4 Protótipos de host

5 Protótipos de descoberta

6 Notas sobre descoberta de baixo nível

7 Regras de descoberta

1 Descoberta de sistemas de arquivos montados

2 Descoberta de interfaces de rede

3 Descoberta de CPUs e núcleos de CPU

4 Descoberta de OIDs SNMP

5 Descoberta de OIDs SNMP (legado)

6 Descoberta de objetos JMX

7 Descoberta de sensores IPMI

8 Descoberta de serviços systemd

9 Descoberta de serviços do Windows

10 Descoberta de instâncias de contadores de desempenho do Windows

11 Descoberta usando consultas WMI

12 Descoberta usando consultas SQL ODBC

13 Descoberta usando dados do Prometheus

14 Descoberta de dispositivos de bloco

15 Descoberta de interfaces de host no Zabbix

8 Regras LLD personalizadas

16 Monitoramento distribuído

1 Proxies

1 Sincronização da configuração de monitoramento

2 Balanceamento de carga e alta disponibilidade do proxy

17 Criptografia

1 Usando certificados

2 Usando chaves pré-compartilhadas

3 Solução de problemas

1 Problemas de tipo de conexão ou permissão

2 Problemas de certificado

3 Problemas com PSK

18 Interface web

1 Menu

1 Menu de evento

2 Menu de host

3 Menu de item

2 Seções do frontend

1 Dashboards

1 Widgets do dashboard

2 Parâmetros do widget do dashboard

1 Log de ações

2 Relógio

3 Status da descoberta

4 Gráficos favoritos

5 Mapas favoritos

6 Gauge

7 Geomapa

8 Gráfico

9 Gráfico (clássico)

10 Protótipo de gráfico

11 Honeycomb

12 Disponibilidade do host

13 Cartão de host

14 Navegador de hosts

15 Cartão de item

16 Histórico de item

17 Navegador de item

18 Valor do item

19 Mapa

20 Árvore de navegação do mapa

21 Gráfico de pizza

22 Hosts com problemas

23 Problemas

24 Problemas por gravidade

25 Relatório de SLA

26 Informações do sistema

27 Principais hosts

28 Principais items

29 Principais triggers

30 Visão geral do trigger

31 URL

32 Monitoramento web

2 Monitoramento

1 Problemas

1 Problemas de causa e sintoma

2 Hosts

1 Gráficos

2 Dashboards de host

3 Cenários web

3 Últimos dados

4 Mapas

5 Descoberta

3 Serviços

1 Serviços

2 SLA

3 Relatório de SLA

4 Inventário

1 Visão geral

2 Hosts

5 Relatórios

1 Informações do sistema

2 Relatórios agendados

3 Relatório de disponibilidade

4 Top 100 triggers

5 Log de auditoria

6 Log de ações

7 Notificações

6 Coleta de dados

1 Grupos de templates

2 Grupos de hosts

3 Templates

1 Items

2 Triggers

3 Gráficos

4 Regras de descoberta

1 Prototipagem de items

2 Protótipos de trigger

3 Protótipos de gráficos

4 Protótipos de host

5 Protótipos de descoberta

5 Cenários web

4 Hosts

1 Items

2 Triggers

3 Gráficos

4 Regras de descoberta

1 Protótipos de item

2 Protótipos de trigger

3 Protótipos de gráficos

4 Protótipos de host

5 Protótipos de descoberta

5 Cenários web

5 Manutenção

6 Correlação de eventos

7 Descoberta

7 Alertas

1 Ações

2 Tipos de mídia

3 Scripts

8 Usuários

1 Grupos de usuários

2 Funções de usuário

3 Usuários

4 Tokens de API

5 Autenticação

1 HTTP

2 LDAP

3 SAML

4 MFA

9 Administração

1 Geral

2 Log de auditoria

3 Limpeza

4 Proxies

5 Grupos de proxy

6 Macros

7 Fila

3 Configurações do usuário

1 Notificações globais

2 Som nos navegadores

4 Pesquisa global

5 Modo de manutenção do frontend

6 Parâmetros de página

8 Criando seu próprio tema

9 Modo de depuração

10 Cookies usados pelo Zabbix

11 Fusos horários

12 Redefinindo a senha

13 Seletor de período de tempo e host

19 Melhores práticas

1 Melhores práticas de segurança

1 Controle de acesso

1 Protegendo o MySQL/MariaDB

2 Protegendo o PostgreSQL/TimescaleDB

2 Criptografia

3 Servidor web

2 Melhores práticas de configuração

20 API

Referência de métodos

Action

Objeto action

action.create

action.delete

action.get

action.update

Alert

Objeto alert

alert.get

Autenticação

Objeto de autenticação

authentication.get

authentication.update

Autoregistration

Objeto de autorregistro

autoregistration.get

autoregistration.update

Cenário web

Objeto de cenário web

httptest.create

httptest.delete

httptest.get

httptest.update

Configuração

configuration.export

configuration.import

configuration.importcompare

Configurações

Objeto settings

settings.get

settings.update

Connector

Objeto connector

connector.create

connector.delete

connector.get

connector.update

Correlação

Objeto correlation

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard

Objeto dashboard

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

Campos do widget do dashboard

1 Log de ações

2 Relógio

3 Status da descoberta

4 Gráficos favoritos

5 Mapas favoritos

6 Gauge

7 Geomapa

8 Gráfico

9 Gráfico (clássico)

10 Protótipo de gráfico

11 Honeycomb

12 Disponibilidade do host

13 Cartão de host

14 Navegador de hosts

15 Cartão de item

16 Histórico de item

17 Navegador de item

18 Valor do item

19 Mapa

20 Árvore de navegação do mapa

21 Gráfico de pizza

22 Hosts com problemas

23 Problemas

24 Problemas por gravidade

25 Relatório de SLA

26 Informações do sistema

27 Principais hosts

28 Principais items

29 Principais triggers

30 Visão geral do trigger

31 URL

32 Monitoramento web

Diretório de usuários

Objeto de diretório de usuário

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

Evento

Objeto event

event.acknowledge

event.get

Expressão regular

Objeto de expressão regular

regexp.create

regexp.delete

regexp.get

regexp.update

Graph

Objeto graph

graph.create

graph.delete

graph.get

graph.update

Grupo de hosts

Objeto de grupo de hosts

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.update

Grupo de proxy

Objeto de grupo de proxy

proxygroup.create

proxygroup.delete

proxygroup.get

proxygroup.update

Grupo de templates

Objeto de grupo de template

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

Grupo de usuários

Objeto de grupo de usuários

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

Histórico

Objeto de histórico

history.clear

history.get

history.push

Host

Objeto host

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Host descoberto

Objeto de host descoberto

dhost.get

Housekeeping

Objeto de limpeza

housekeeping.get

housekeeping.update

Imagem

Objeto de imagem

image.create

image.delete

image.get

image.update

Informações da API

apiinfo.version

Interface de host

Objeto de interface de host

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Item

Objeto item

item.create

item.delete

item.get

item.update

Item do gráfico

Objeto de item de gráfico

graphitem.get

Log de auditoria

Objeto de log de auditoria

auditlog.get

Macro de usuário

Objeto macro de usuário

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

Manutenção

Objeto de manutenção

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Map

Objeto de mapa

map.create

map.delete

map.get

map.update

Mapa de valores

Objeto de mapa de valor

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

Mapa de ícones

Objeto de mapa de ícones

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

MFA

Objeto MFA

mfa.create

mfa.delete

mfa.get

mfa.update

Módulo

Objeto module

module.create

module.delete

module.get

module.update

Nó de alta disponibilidade

Objeto de nó de alta disponibilidade

hanode.get

Problem

Objeto problem

problem.get

Protótipo de gráfico

Objeto de protótipo de gráfico

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

Protótipo de host

Objeto de protótipo de host

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Protótipo de item

Objeto de protótipo de item

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

Protótipo de regra LLD

Objeto de protótipo de regra de LLD

discoveryruleprototype.create

discoveryruleprototype.delete

discoveryruleprototype.get

discoveryruleprototype.update

Proxy

Objeto proxy

proxy.create

proxy.delete

proxy.get

proxy.update

Regra de descoberta

Objeto de regra de descoberta

drule.create

drule.delete

drule.get

drule.update

Regra de LLD

Objeto de regra de LLD

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Report

Objeto report

report.create

report.delete

report.get

report.update

Role

Objeto role

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

Service

Objeto de serviço

service.create

service.delete

service.get

service.update

Serviço descoberto

Objeto de serviço descoberto

dservice.get

SLA

Objeto SLA

sla.create

sla.delete

sla.get

sla.getsli

sla.update

Task

Objeto Task

task.create

task.get

Template

Objeto template

template.create

template.delete

template.get

template.massadd

template.massremove

template.massupdate

template.update

Template dashboard

Objeto de dashboard de template

templatedashboard.create

templatedashboard.delete

templatedashboard.get

templatedashboard.update

Tipo de mídia

Objeto media type

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Token

Objeto token

token.create

token.delete

token.generate

token.get

token.update

Trend

Objeto de tendência

trend.get

Trigger

Objeto trigger

trigger.create

trigger.delete

trigger.get

trigger.update

Trigger prototype

Objeto de protótipo de trigger

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

Usuário

Objeto de usuário

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.provision

user.resettotp

user.unblock

user.update

Verificação de descoberta

Objeto de verificação de descoberta

dcheck.get

Apêndice 1. Comentário de referência

Apêndice 2. Alterações da 7.4 para a 8.0

Apêndice 3. Alterações na 8.0

1 Módulos carregáveis

2 Plugins

1 Compilando plugins carregáveis

3 Módulos do frontend

1 Instalação e configuração

1 Criação do banco de dados

2 Reparando o conjunto de caracteres e a collation do banco de dados do Zabbix

3 Atualização do banco de dados para chaves primárias

4 Preparando a tabela auditlog para particionamento

5 Conexão segura com o banco de dados

1 Configuração de criptografia do MySQL

2 Configuração de criptografia do PostgreSQL

6 Conexão segura com o frontend

7 Configuração do TimescaleDB

8 Configuração do Elasticsearch

9 Notas específicas da distribuição sobre a configuração do Nginx para o Zabbix

10 Executando o agent como root

11 Agent Zabbix no Microsoft Windows

12 Configuração do SAML com o Microsoft Entra ID

13 Configuração do SAML com Okta

14 Configuração do SAML com OneLogin

15 Configurando relatórios agendados

16 Idiomas adicionais do frontend

2 Configuração de processos

1 Zabbix server

2 Proxy Zabbix

3 Agent Zabbix (UNIX)

4 Agent Zabbix 2 (UNIX)

5 Agent Zabbix (Windows)

6 Agent Zabbix 2 (Windows)

7 Plugins do agent 2 do Zabbix

1 Plugin Ceph

2 Plugin Docker

3 Plugin Ember+

4 Plugin Memcached

5 Plugin Modbus

6 Plugin MongoDB

7 Plugin MQTT

8 Plugin MSSQL

9 Plugin MySQL

10 Plugin NVIDIA GPU

11 Plugin Oracle

12 Plugin do PostgreSQL

13 Plugin Redis

14 Plugin SMART

8 Zabbix Java gateway

9 Serviço web do Zabbix

10 Variáveis de ambiente

11 Inclusão

1 Protocolo de troca de dados server-proxy

2 Protocolo do agent/agent2 do Zabbix

4 Protocolo de plugin do Zabbix agent 2

5 Protocolo do Zabbix sender

6 Cabeçalho

7 Novo protocolo de exportação JSON delimitado por nova linha

4 Items

1 parâmetros vm.memory.size

2 Verificações passivas e ativas do agent

3 Nível mínimo de permissão para itens do agent do Windows

4 Codificação dos valores retornados

5 Suporte a arquivos grandes

6 Sensor

7 Notas sobre o parâmetro memtype em itens proc.mem

8 Notas sobre a seleção de processos em itens proc.mem e proc.num

9 Detalhes de implementação das verificações net.tcp.service e net.udp.service

10 parâmetros proc.get

11 Configurações de interface de host inacessível/indisponível

12 Monitoramento remoto das estatísticas do Zabbix

13 Configurando o Kerberos com o Zabbix

14 parâmetros modbus.get

15 Criando nomes personalizados de contadores de desempenho para VMware

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

17 Valores de retorno para net.dns.get

18 Notas sobre os items system.cpu.util no Windows

5 Funções suportadas

1 Funções agregadas

1 Funções Foreach

2 Funções bitwise

3 Funções de data e hora

4 Funções de histórico

5 Funções de tendência

6 Funções matemáticas

7 Funções de operador

8 Funções preditivas

9 Funções de string

6 Macros

1 Macros suportadas por local

2 Macros de usuário suportadas por local

7 Símbolos de unidade

8 Sintaxe do período de tempo

9 Execução de comandos

10 Compatibilidade de versões

12 Biblioteca de vínculo dinâmico do Zabbix sender para Windows

13 Biblioteca Python para Zabbix API

14 Atualização do monitoramento de serviços

15 Outros problemas

16 Comparação entre agent e agent 2

17 Exemplos de escape

23 Guias de referência rápida

1 Monitorar Linux com o agent do Zabbix

2 Monitorar Windows com o Zabbix agent

3 Monitorar o Apache via HTTP

4 Monitorar o MySQL com o Zabbix agent 2

5 Monitorar VMware com o Zabbix

6 Monitorar o tráfego de rede com o Zabbix

7 Monitorar o tráfego de rede usando verificações ativas

8 Monitorar sites com itens do Browser

9 Monitorar certificados de sites com o Zabbix agent 2 (passivo)

10 Monitore um switch ou roteador de rede com o Zabbix

11 Monitorar o log de eventos do Windows usando verificações ativas

1 Implantar o Zabbix com o Zabbix Cloud

2 Configuração de nó

3 Adicionando usuários

4 Principais diferenças entre Zabbix Cloud e on-premises

Central do Desenvolvedor

Módulos

Estrutura de arquivos do módulo

manifest.json

Ações

Visualizações

Assets

Registrar um novo módulo

Widgets

Configuração

Apresentação

Tutoriais

Criar um módulo (tutorial)

Criar um widget (tutorial)

Exemplos

Plugins

Exemplos

Criar um plugin (tutorial)

Interfaces de plugin

Alterações no desenvolvimento de extensões

Páginas de manual do Zabbix

zabbix_web_service

Table of Contents

6 Macros
- Visão geral

6 Macros

Visão geral

Esta seção permite definir macros de usuário em todo o sistema como pares nome-valor. Observe que os valores das macros podem ser mantidos como texto simples, texto secreto ou segredo do Vault. Também é possível adicionar uma descrição.