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 What's new in Zabbix 6.4.0

6 What's new in Zabbix 6.4.1

6 What's new in Zabbix 6.4.4

7 What's new in Zabbix 6.4.2

8 What's new in Zabbix 6.4.3

10 What's new in Zabbix 6.4.5

12 What's new in Zabbix 6.4.6

12 What's new in Zabbix 6.4.7

13 What's new in Zabbix 6.4.8

14 What's new in Zabbix 6.4.9

15 What's new in Zabbix 6.4.10

16 What's new in Zabbix 6.4.11

17 What's new in Zabbix 6.4.12

18 What's new in Zabbix 6.4.13

19 What's new in Zabbix 6.4.14

20 What's new in Zabbix 6.4.15

21 What's new in Zabbix 6.4.16

22 What's new in Zabbix 6.4.17

23 What's new in Zabbix 6.4.18

24 What's new in Zabbix 6.4.19

25 What's new in Zabbix 6.4.20

2. Definições

3. Processos Zabbix

2 Servidor

1 Cluster de alta disponibilidade

3 Agent 2

3 Agente

4 Proxy

1 Setup from sources

2 Setup from RHEL packages

3 Setup from Debian/Ubuntu packages

6 Sender

7 Get

8 JS

4. Instalação

1 Obtendo o Zabbix

Plugins

1 PostgreSQL plugin dependencies

2 MongoDB plugin dependencies

Best practices for secure Zabbix setup

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

Construindo Agente Zabbix 2 no Windows

Criando agente Zabbix no Windows

Criando o agente Zabbix no macOS

4 Instalação via pacotes

1 Sistema operacional Red Hat Enterprise Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux Enterprise Server

4 Instalação agente Windows por MSI

5 Instalação de agente Mac OS pelo PKG

6 Lançamentos instáveis

5 Instalação por containers

6 Instalação da interface web

7 Modificações nos Templates

7 Procedimento de atualização

Atualização a partir de pacotes

1 Red Hat Enterprise Linux

2 Debian/Ubuntu

Atualização a partir dos fontes

Upgrade from containers

8 Problemas conhecidos

1 Compilation issues

10 Upgrade notes for 6.4.0

11 Upgrade notes for 6.4.1

12 Upgrade notes for 6.4.2

13 Upgrade notes for 6.4.3

13 Upgrade notes for 6.4.4

14 Upgrade notes for 6.4.5

15 Upgrade notes for 6.4.6

17 Upgrade notes for 6.4.7

18 Upgrade notes for 6.4.8

19 Upgrade notes for 6.4.9

20 Upgrade notes for 6.4.10

21 Upgrade notes for 6.4.11

22 Upgrade notes for 6.4.12

23 Upgrade notes for 6.4.13

24 Upgrade notes for 6.4.14

24 Upgrade notes for 6.4.15

26 Upgrade notes for 6.4.16

27 Upgrade notes for 6.4.17

28 Upgrade notes for 6.4.18

29 Upgrade notes for 6.4.19

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

7. Configuração

1 Hosts e grupos de hosts

1 Configurando um host

2 Inventário

3 Atualização em massa

2 Itens

itemtypes

1 agente Zabbix

1 Agente Zabbix 2

Chaves de item específicas para Windows

2 Agente SNMP

1 Índices Dinâmicos

2 Special OIDs

3 Arquivos MIB

3 Traps SNMP

4 Verificações IPMI

5 Verificações simples

1 Chaves de item de monitoramento VMware

6 Monitoramento de arquivo de log

7 Itens calculados

Cálculos agregados

8 Verificações internas

9 Verificações SSH

10 Verificações telnet

11 Verificações externas

12 Itens de captura (trapper)

13 Monitoramento JMX

14 Monitoramento ODBC

1 Configurações UnixODBC recomendadas para MySQL

2 Configurações UnixODBC recomendadas para PostgreSQL

3 Configurações UnixODBC recomendadas para Oracle

4 Configurações UnixODBC recomendadas para MSSQL

15 Itens dependentes

16 Agente HTTP

17 Verificações Prometheus

18 Script items

1 Criando um item

1 Formato da chave de item

2 Intervalos customizados

2 Pré-processamento de valor de item

1 Exemplos de uso

2 Detalhes de pré-processamento

3 Funcionalidade JSONPath

Escapando caracteres especiais de valores de macro LLD em JSONPath

4 Pré-processamento JavaScript

Objetos JavaScript adicionais

5 Pré-processamento CSV para JSON

4 História e tendências

5 Parâmetros do usuário

1 Estendendo agentes Zabbix

7 contadores de desempenho do Windows

8 Atualização em massa

8 Mapeamento de valores

10 Fila

11 Cache de valores

12 Execute agora

13 Restringindo verificações de agentes

3 Gatilhos (triggers)

1 Configurando um gatilho

2 Expressão de acionamento

3 Dependências dos gatilhos

4 Severidade de gatilho

5 Customizando severidades de gatilho

6 Atualização em massa

7 Funções de gatilho preditivas

4 Eventos

1 Geração de evento de gatilho

2 Outras fontes de evento

3 Encerramento manual de problemas

5 Correlação de evento

1 Correlação de evento baseada em gatilho

2 Correlação de eventos global

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

1 Configurando um mapa de rede

2 Elementos do grupo de hosts

3 Indicadores de links

3 Painéis

4 Painéis de host

8 Modelos

1 Configurando um modelo

2 Vinculando/desvinculando

3 Aninhamento

4 Atualização em massa

9 Modelos prontos para uso

HTTP template operation

Modelos padronizados para dispositivos de rede

operação de modelo ODBC

Operação de template do agente Zabbix 2

Operação do modelo do agente Zabbix

operação do modelo IPMI

Operação do modelo JMX

10 Notificações sobre eventos

1 Tipos de mídia

1 E-mail

2 SMS

3 Scripts de alerta customizados

4 Webhook

Exemplos de script 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 macro

2 Macros de usuário

2 Secret user macros

3 Macros de usuário com contexto

4 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

CyberArk configuration

HashiCorp configuration

14 Scheduled reports

1 Export to files

2 Streaming to external systems

8. Monitoramento de serviço

3 SLA

4 Setup example

9. Monitoramento web

1 Itens de monitoramento web

2 Cenário real de Monitoramento Web

10. Monitoramento de máquina virtual

1 Campos de chave de descoberta de máquina virtual

1 Chaves de item de monitoramento VMware

4 VMware monitoring setup example

JSON examples for VMware items

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 host

2 Templates

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

2 Protótipos de gatilho

3 Protótipos de gráficos

4 Host prototypes

4 Notas sobre descoberta de baixo nível

5 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

4 Discovery of SNMP OIDs

5 Descoberta de objetos JMX

6 Descoberta de sensores IPMI

7 Descoberta de serviços systemd

8 Descoberta de serviços do Windows

9 Descoberta de instâncias do contador de desempenho do Windows

10 Descoberta usando consultas WMI

11 Descoberta usando consultas ODBC SQL

12 Descoberta usando dados do Prometheus

13 Descoberta de dispositivos de bloco

14 Descoberta de interfaces de host no Zabbix

16 Monitoração distribuída

Proxies

1 Synchronization of monitoring configuration

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

18. Interface da Web

1 Menu

1 Menu de contexto de evento

2 Menu de contexto de host

3 Menu de contexto de item

2 Seções de front-end

1 Dashboards

1 Dashboard widgets

1 Action log

2 Clock

3 Data overview

4 Discovery status

5 Favorite graphs

6 Favorite maps

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Host availability

12 Item value

13 Map

14 Map navigation tree

15 Plain text

16 Problem hosts

17 Problems

18 Problems by severity

19 SLA report

20 System information

21 Top hosts

22 Trigger overview

23 URL

24 Web monitoring

1 Monitoramento

2 Problems

1 Cause and symptom problems

3 Hosts

1 Gráficos

2 Cenários Web

4 Dados recentes

6 Descoberta

9 Mapas

2 Services

1 Services

3 SLA

4 Relatório de SLA

3 Inventário

1 Visão geral

2 Hosts

4 Relatórios

1 Informações do sistema

2 Relatórios agendados

3 Relatório de disponibilidade

4 Top 100 de triggers

5 Audit log

6 Log de ações

7 Notificações

6 Administração

1 Geral

2 Audit log

2 Proxies

3 Housekeeping

5 Macros

9 Fila

6 Data collection

1 Grupos de Host

1 Template groups

2 Templates

1 Items

2 Triggers

3 Gráficos

4 Regras de descoberta

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

4 Host prototypes

5 Cenários Web

3 Hosts

1 Items

2 Triggers

3 Gráficos

4 Regras de descoberta

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

4 Host prototypes

5 Cenários Web

5 Maintenance

6 Event correlation

7 Discovery

7 Alerts

5 Ações

7 Tipos de mídia

8 Scripts

8 Usuários

1 Grupos de usuários

3 Usuários

4 Tokens API

5 Authentication

1 HTTP

2 LDAP

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

5 Funções do usuário

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 senha

19 API

referência do método

Alerta

> Objeto de alerta

alerta.obter

Autenticação

> Objeto de autenticação

autenticação.get

authentication.update

Autoregistro

> Objeto de registro automático

autoregistration.get

autoregistration.update

Açao

> Objeto de ação

action.update

ação.criar

ação.excluir

ação.obter

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

Connector

> Objeto de conexão

connector.create

connector.delete

Método connector.get

Método connector.update

Correlação

> Objeto de correlação

correlation.get

correlation.update

Descrição

Método correlation.create

Definições

> Objeto de configurações

settings.get

settings.update

Evento

> Objeto de evento

event.acknowledge

event.get

Expressão regular

> Objeto de expressão regular

regexp.create

regexp.delete

regexp.get

regexp.update

Função

> Objeto de função

role.create

role.delete

role.get

role.update

Grupo de anfitriões

> Objeto do grupo de hosts

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.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ória

> Objeto histórico

history.get

histórico.limpar

Host

> Objeto host

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Host descoberto

> Objeto host descoberto

dhost.get

Imagem

> Objeto de imagem

image.create

image.delete

image.get

imagem.atualização

informações da API

apiinfo.versão

Interface do host

> Objeto de interface do host

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Item

> Objeto de item

item.create

item.delete

item.get

item.update

Item de gráfico

> Objeto de item de gráfico

graphitem.get

Macro do usuário

> User macro object

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

Mapa

> Objeto de mapa

map.create

map.delete

map.get

map.update

Mapa de ícones

> Objeto de mapa de ícones

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

Module

> Module object

module.create

module.delete

module.get

module.update

Nó de alta disponibilidade

> Objeto de nó de alta disponibilidade

hanode.get

Painel

> Objeto do painel

Campos de widgets no painel de controle

1 Log de ação

2 Relógio (clock)

3 Visão geral dos dados

4 Discovery status

5 Favorite graphs

6 Favorite maps

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Disponibilidade do host

12 Item value

13 Map

14 Map navigation tree

15 Plain text

16 Hosts com problema

17 Problems

18 Problems by severity

19 SLA report

20 Informações do sistema

21 Top hosts

22 Trigger overview

23 URL

24 Web monitoring

dashboard.create (criar dashboard)

dashboard.update (atualização de dashboard)

painel.delete

painel.get

Painel de Modelos

> Objeto de dashboard

templatedashboard.create

templatedashboard.delete

templatedashboard.get

templatedashboard.update

Problema

> Objeto do problema

problem.get

Protótipo de gráfico

> Objeto protótipo gráfico

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

Protótipo de host

> Objeto protótipo do host

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Protótipo de item

> Objeto protótipo de item

itemprototype.create

itemprototype.delete

itemprototype.get

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

Registro de auditoria

> Objeto de log de auditoria

auditlog.get

regra de descoberta

> Objeto de regra de descoberta

drule.create

drule.delete

drule.get

drule.update

Regra LLD

> Regra de objeto LLD

discoveryrule.copy

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Relatório

> objeto de relatório

report.create

report.delete

report.get

report.update

Script

> Objeto de script

script.create

script.delete

script.execute

script.get

script.getscriptsbyevents

script.getscriptsbyhosts

script.update

Serviço

> Objeto de serviço

service.create

service.delete

service.get

service.update

Serviço de limpeza

> Housekeeping object

housekeeping.get

housekeeping.update

Serviço descoberto

> Objeto de serviço descoberto

dservice.get

SLA

> objeto SLA

sla.create

sla.delete

sla.get

sla.getsli

sla.update

Tarefa

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

> Template group object

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

Tendência

> Objeto de tendência

trend.get

Tipo de mídia

> Objeto de tipo de mídia

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Token

> Objeto token

token.create

token.delete

token.generate

token.get

token.update

Trigger

> Objeto de trigger

trigger.create

trigger.delete

trigger.get

trigger.update

User

> User object

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.provision

user.unblock

user.update

User directory

> User directory object

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

Value map

> Objeto de mapa de valor

valuemap.create

valuemap.delete

valuemap.get

valuemap.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 de 6.2 para 6.4

Mudanças na API do Zabbix 6.4

2 Plugins

1 Building loadable plugins

3 Frontend modules

6 Módulos carregáveis

2 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 de banco de dados para chaves primárias

3 Secure connection to the database

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

5 Configuração do TimescaleDB

6 Configuração do Elasticsearch

8 Notas específicas de distribuição sobre a configuração do Nginx para Zabbix

9 Executando agente como root

10 Agente Zabbix no Microsoft Windows

11 Configuração SAML com Okta

11 Oracle database setup

11 SAML setup with Microsoft Azure AD

12 Setting up scheduled reports

13 SAML setup with OneLogin

14 Idiomas frontend adicionais

15 Upgrading to numeric values of extended range

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

4 Plugin Modbus

5 Plugin MongoDB

6 Plugin MQTT

7 MSSQL plugin

7 MySQL plugin

8 Plugin Oracle

9 PostgreSQL plugin

10 Plugin Redis

11 Plugin Smart

8 Zabbix Java Gateway

9 Serviço web Zabbix

10 Inclusão

1 Protocolo de troca de dados servidor-proxy

2 Protocolo do agente Zabbix

3 Protocolo de envio Zabbix

3 Zabbix agent 2 protocol

4 Cabeçalho

4 Zabbix agent 2 plugin protocol

5 Protocolo de exportação em tempo real

5 Itens

2 parâmetros vm.memory.size

2 Passive and active agent checks

4 Codificação dos valores retornados

4 Trapper items

5 Minimum permission level for Windows agent items

5 Suporte a grandes arquivos

7 Sensores

8 Observações sobre o parâmetro memtype em itens proc.mem

9 Observações sobre seleção de processos nos itens proc.mem e proc.num

10 Detalhes de implementação das verificações net.tcp.service ed net.udp.service

11 proc.get parameters

12 Definições de host inalcançável/inacessível

13 Monitoramento remoto das estatísticas do Zabbix

14 Configurando Kerberos com Zabbix

15 parâmetros modbus.get

16 Creating custom performance counter names for VMware

17 Return values

6 Supported functions

1 Funções agregadas

1 Funções Foreach

2 Funções bit a bit

3 Funções de data e hora

4 Funções de histórico

5 Trend functions

6 Funções matemáticas

6 Operator functions

7 Prediction functions

8 String functions

7 Macros

1 Macros suportadas por localização

2 User macros supported by location

8 Símbolos de unidade

9 Sintaxe do período de tempo

10 Execução de comandos

11 Compatibilidade entre versões

14 Python library for Zabbix API

14 Tratamento de erros do banco de dados

15 Biblioteca de links dinâmicos do remetente Zabbix para Windows

17 Service monitoring upgrade

18 Agente vs agente 2 comparação

18 Escaping examples

18 Outros problemas

22. Quick reference guides

1. Monitor Linux with Zabbix agent

2 Monitor Windows with Zabbix agent

3. Monitor Apache via HTTP

4. Monitor MySQL with Zabbix agent 2

5 Monitor VMware with Zabbix

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)

Crie um widget (tutorial)

Exemplos

Plugins

Exemplos

Crie um plugin (tutorial)

Interfaces de plug-in

Páginas de manual do Zabbix

zabbix_web_service

Table of Contents

Proxy

Proxy

Esta classe foi projetada para trabalhar com proxies.

Referências de objetos:

Métodos disponíveis:

proxy.create - criar novos proxies
proxy.delete - excluir proxies
proxy.get - recuperar proxies
proxy.update - atualizar proxies