Documentation

Manual do Zabbix

1. Introdução

1 Estrutura do manual

2 O que é o Zabbix

3 Funcionalidades do Zabbix

4 Visão geral do Zabbix

5 Novidades do Zabbix 7.4.0

6 Novidades no Zabbix 7.4.x

2. Definições

3 Processos do Zabbix

1 Servidor

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 Get

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 do 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 do 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 à escape de caracteres

9 Alterações em templates

10 Notas de atualização para 7.4.0

11 Notas de atualização para 7.4.x

5. Início rápido

1 Autenticando e configurando usuário

2 Novo host

3 Novo item

5 Recebendo notificação de problema

6 Novo modelo (template)

6 Zabbix appliance

7 Configuração

1 Hosts e grupos de hosts

2 Configurando um host

3 Configurando um grupo de hosts

4 Inventário

5 Atualização em massa

Assistente de host 1

2 Items

Visão geral

1 agente Zabbix

1 Agente Zabbix 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 do navegador

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 Escapando caracteres especiais dos 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

4 História e tendências

5 Parâmetros do usuário

1 Estendendo agentes 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 Gravidade do trigger

5 Personalizando as severidades dos triggers

6 Atualização em massa

7 Funções preditivas de trigger

4 Eventos

1 Geração de evento de trigger

2 Outras fontes de eventos

3 Encerramento manual de problemas

5 Correlação de eventos

1 Correlação de eventos baseada em trigger

2 Correlação global de eventos

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 do grupo de hosts

3 Indicadores de links

3 Dashboards

8 Templates e grupos de templates

1 Configurando um modelo

2 Configurando um grupo de templates

3 Vinculando/desvinculando

4 Aninhamento

5 Atualização em massa

9 Modelos 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 de template JMX

6 Operação do 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 Operações de atualização

5 Escalações

3 Recebendo notificação sobre itens 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 Expression macros

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 Transmissão para sistemas externos

3 SNMP gateway

8. Monitoramento de serviço

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áquina virtual

1 Chaves de item de monitoramento da VMware

2 Campos de chave de descoberta de máquina virtual

3 Exemplos de JSON para itens do VMware

4 Exemplo de configuração de monitoramento do VMware

11. Manutenção

12. Expressões regulares

13 Reconhecimento do Problema

1 Supressão de problemas

14. Configuração exportação/importação

1 Grupos de templates

2 Grupos de hosts

3 Templates

4 Hosts

5 Mapas de rede

5 Tipos de mídia

1 descoberta de rede

1 Configurando uma regra de descoberta de rede

2 Registro automático de agente ativo

3 Descoberta de baixo nível

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

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 Monitoração distribuída

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 Tipo de conexão ou problemas de permissão

2 Problemas de certificado

3 Problemas com PSK

18. Interface da Web

1 Menu

1 Menu de evento

2 Menu de contexto de host

3 Menu de item

2 Seções de front-end

1 Dashboards

1 Dashboard widgets

1 Log de ações

2 Relógio

3 Status da descoberta

4 Gráficos favoritos

5 Mapas favoritos

6 Gauge

7 Geomap

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 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

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

3 Usuários

4 Tokens API

5 Autenticação

1 HTTP

2 LDAP

3 SAML (Linguagem de Marcação de Asserção de Segurança)

4 MFA

5 Funções do usuário

9 Administração

1 Geral

2 Log de auditoria

3 Housekeeping

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 de front-end

6 Parâmetros da página

8 Criando seu próprio tema

9 Modo de depuração

10 Cookies usados pelo Zabbix

11 Fuso horário

12 Redefinindo a senha

13 Seletor de período de tempo

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 do método

Action

> Objeto ação

action.update

ação.criar

ação.excluir

ação.obter

Alert

Objeto de alerta

alerta.obter

API info

apiinfo.versão

Autenticação

Objeto de autenticação

autenticação.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

configuração.importcompare

Configurações

Objeto settings

settings.get

settings.update

Connector

Objeto connector

connector.create

connector.delete

Método connector.get

Método connector.update

Correlação

Objeto correlation

correlation.get

correlation.update

Descrição

Método correlation.create

Dashboard

Objeto dashboard

dashboard.create (criar dashboard)

painel.delete

painel.get

dashboard.update (atualização de dashboard)

Campos do widget do dashboard

1 Log de ação

2 Relógio (clock)

3 Status da descoberta

4 Gráficos favoritos

5 Mapas favoritos

6 Gauge

7 Geomap

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 Host navigator

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 dos triggers

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

Event

Objeto event

event.acknowledge

event.get

Expressão regular

Objeto de expressão regular

regexp.create

regexp.delete

regexp.get

regexp.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 template

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

Gráfico

Objeto gráfico

graph.create

graph.delete

graph.get

graph.update

Histórico

Objeto de histórico

history.get

history.push

histórico.limpar

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 image

image.create

image.delete

image.get

imagem.atualização

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

Maintenance

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 valores

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

Protótipo de trigger

Objeto de protótipo de trigger

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.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 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 de tarefa

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 trend

trend.get

Trigger

Objeto trigger

trigger.create

trigger.delete

trigger.get

trigger.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.2 para a 7.4

Apêndice 3. Alterações na 7.4

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 agrupamento do banco de dados 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 do processo

1 servidor Zabbix

2 Zabbix proxy

3 Agente Zabbix (UNIX)

4 Agente Zabbix 2 (UNIX)

5 Zabbix agent (Windows)

6 Agente Zabbix 2 (Windows)

7 Plugins do Zabbix Agent 2

1 Plugin Ceph

2 Plugin Docker

3 Plugin Ember+

4 Plugin do Memcached

5 Plugin Modbus

6 Plugin do 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 servidor-proxy

2 Protocolo do agent/agent2 do Zabbix

4 Zabbix agent 2 plugin protocol

5 Protocolo do Zabbix sender

6 Cabeçalho

7 Protocolo de exportação JSON delimitado por nova linha

4 Items

1 parâmetros vm.memory.size

2 Passive and active agent checks

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 API do Zabbix

14 Atualização do monitoramento de serviços

15 Outras questões

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 Monitor Windows with 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 tipo 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 Deploy Zabbix with Zabbix Cloud

2 Node configuration

4 Key differences between Zabbix Cloud and on-premises

Centro de Desenvolvimento

Módulos

Estrutura do arquivo do módulo

manifest.json

Ações

Ativos

Registrar um novo módulo

Widgets

Configuração

Apresentação

Tutoriais

Criar um módulo (tutorial)

Criar um widget (tutorial)

Exemplos

Plugins

Exemplos

Create a plugin (tutorial)

Interfaces de plug-in

Mudanças no desenvolvimento de extensões

Páginas de manual do Zabbix

zabbix_web_service

1 Instalação e configuração

Por favor, use a barra lateral para acessar o conteúdo desta seção.