Table of Contents

4 Hosts

4 Hosts

Visão geral

Os hosts são exportados com muitos objetos relacionados e relações de objetos.

A exportação de host contém:

Grupos de hosts vinculados
Dados do host
Vinculação de template
Vinculação de grupo de host
Interfaces do host
Itens vinculados diretamente
Triggers vinculados diretamente
Regras de descoberta vinculadas diretamente com todos os protótipos
Cenários web vinculados diretamente
Macros do host
Dados de inventário do host
Mapas de valores
Gráficos vinculados

Exportando

Para exportar hosts, faça o seguinte:

Vá para Coleta de dados → Hosts.
Marque as caixas de seleção dos hosts a serem exportados.
Clique em Exportar abaixo da lista.

Dependendo do formato selecionado, os hosts são exportados para um arquivo local com um nome padrão:

zabbix_export_hosts.yaml - na exportação YAML (opção padrão para exportação);
zabbix_export_hosts.xml - na exportação XML;
zabbix_export_hosts.json - na exportação JSON.

Importando

Para importar hosts, faça o seguinte:

Vá para Coleta de dados → Hosts.
Clique em Importar no canto superior direito.
Selecione o arquivo de importação.
Clique em Importar no canto inferior direito do formulário de configuração.

Se você marcar a caixa de seleção Opções avançadas, uma lista detalhada de todos os elementos importáveis será exibida - marque ou desmarque cada regra de importação conforme necessário.

Se você clicar na caixa de seleção na linha Todos, todos os elementos abaixo dela serão marcados/desmarcados.

Regras de importação:

Regra	Descrição
Atualizar existentes	Os elementos existentes serão atualizados usando os dados do arquivo de importação. Caso contrário, eles não serão atualizados.
Criar novos	Novos elementos serão criados usando os dados do arquivo de importação. Caso contrário, eles não serão criados.
Excluir ausentes	Os elementos existentes que não estiverem presentes no arquivo de importação serão removidos. Caso contrário, eles não serão removidos. Se Excluir ausentes estiver marcado para Vinculação de template, a vinculação de template atual que não estiver presente no arquivo de importação será desvinculada. Entidades (items, triggers, gráficos, etc.) herdadas dos templates desvinculados não serão removidas (a menos que a opção Excluir ausentes também seja selecionada para cada entidade).

Uma mensagem de sucesso ou falha da importação será exibida no frontend.

Formato de exportação

Quando um host é exportado, o Zabbix gera um formato estruturado em YAML, JSON ou XML. A exportação inclui elementos do host, como metadados do host, items, macros, triggers e muito mais.

Cada elemento serve a um propósito específico e pode conter elementos aninhados.

As seções a seguir descrevem cada elemento no formato de exportação. Os exemplos usam um host com o template MySQL by Zabbix agent 2. Para fins de demonstração dos elementos, o template é desvinculado após a criação do host. A desvinculação mantém todos os elementos na configuração (diferente de desvincular e limpar, que os remove).

Uma elipse (...) indica elementos omitidos para brevidade. A nota (veja a tabela abaixo) é usada quando o elemento é explicado em mais detalhes nas seções posteriores.

Metadados do host

zabbix_export:
         version: '8.0'
         host_groups:
           - uuid: 748ad4d098d447d492bb935c907f652f
             name: Databases
         hosts: (veja a tabela abaixo)
         graphs: (veja a tabela abaixo)

Elemento		Tipo	Descrição
version		string	(obrigatório) Versão do Zabbix.
host_groups			(obrigatório) Elemento raiz para grupos de hosts.
	uuid	string	(obrigatório) Identificador exclusivo para este grupo de hosts.
	name	string	(obrigatório) Nome do grupo de hosts.
hosts			Elemento raiz para hosts.
graphs			Elemento raiz para gráficos de host.

Hosts

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             name: 'MySQL server'
             groups:
               - name: Databases
             interfaces: (veja a tabela abaixo)
             items: (veja a tabela abaixo)
             discovery_rules: (veja a tabela abaixo)
             tags:
               - tag: location
                 value: Riga
             macros:
               (...)
               - macro: '{$MYSQL.DSN}'
                 value: 192.0.2.0
               (...)
               - macro: '{$MYSQL.PASSWORD}'
                 type: SECRET_TEXT
                 description: 'MySQL user password.'
               (...)
             valuemaps: (veja a tabela abaixo)
         (...)

Elemento		Tipo	Descrição
host		string	(obrigatório) Nome exclusivo do host.
name		string	Nome visível do host.
description		text	Descrição do host.
monitored_by		string	Como o host é monitorado. Valores possíveis:¹ SERVER (0, padrão), PROXY (1) ou PROXY_GROUP (2).
proxy			Elemento raiz para proxy.
	name	string	(obrigatório) Nome do proxy (se houver) que monitora o host.
proxy_group			Elemento raiz para grupo de proxy.
	name	string	(obrigatório) Nome do grupo de proxy (se houver) usado para monitorar o host.
status		string	Status do host. Valores possíveis:¹ ENABLED (0, padrão), DISABLED (1).
ipmi_authtype		string	Tipo de autenticação da sessão IPMI. Valores possíveis:¹ DEFAULT (-1, padrão), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6).
ipmi_privilege		string	Nível de privilégio da sessão IPMI. Valores possíveis:¹ CALLBACK (1), USER (2, padrão), OPERATOR (3), ADMIN (4), OEM (5).
ipmi_username		string	Nome de usuário para verificações IPMI.
ipmi_password		string	Senha para verificações IPMI.
templates			Elemento raiz para templates vinculados.
	name	string	(obrigatório) Nome do template.
groups			Elemento raiz para grupos de host aos quais o host pertence.
	name	string	(obrigatório) Nome do grupo de host.
interfaces			Elemento raiz para interfaces do host.
items			Elemento raiz para itens do host.
discovery_rules			Elemento raiz para regras de descoberta de baixo nível do host.
http_tests			Elemento raiz para cenários web do host.
tags			Elemento raiz para tags do host.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.
macros			Elemento raiz para macros do host.
	macro	string	(obrigatório) Nome da macro de usuário.
	type	string	Tipo da macro de usuário. Valores possíveis:¹ TEXT (0, padrão), SECRET_TEXT (1), VAULT (2).
	value	string	Valor da macro de usuário.
	description	string	Descrição da macro de usuário.
inventory			Elemento raiz para inventário do host.
	<inventory_property>	string	Propriedade de inventário. Todas as propriedades têm seu respectivo elemento (`type`, `name`, `os`, etc.; por exemplo, veja Formato de exportação).
inventory_mode		string	Modo de inventário. Valores possíveis:¹ DISABLED (-1), MANUAL (0, padrão), AUTOMATIC (1).
valuemaps			Elemento raiz para mapas de valor do host.

Veja também: Objeto host (consulte a propriedade relevante com o nome correspondente).

Interfaces do host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             interfaces:
               - ip: 192.0.2.0
                 interface_ref: if1
             (...)

Elemento		Tipo	Descrição
default		string	Se esta é a interface principal do host. Observe que só pode haver uma interface principal de um tipo em um host. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
type		string	Tipo de interface. Valores possíveis:¹ ZABBIX (1, padrão), SNMP (2), IPMI (3), JMX (4).
useip		string	Se deve usar o IP como interface para conectar ao host (caso contrário, o DNS será usado). Valores possíveis:¹ NÃO (0), SIM (1, padrão).
ip		string	(obrigatório para conexões IP) Endereço IP (IPv4 ou IPv6).
dns		string	(obrigatório para conexões DNS) Nome DNS.
port		string	Número da porta.
details			Elemento raiz para detalhes da interface.
	version	string	Usar esta versão SNMP. Valores possíveis:¹ SNMPV1 (1), SNMP_V2C (2, padrão), SNMP_V3 (3).
	community	string	(obrigatório para itens SNMPv1 e SNMPv2) Comunidade SNMP.
	max_repetitions	string	Valor máximo de repetição para requisições nativas SNMP bulk (GetBulkRequest-PDUs). Suportado para itens SNMPv2 e SNMPv3 (itens `discovery[]` e `walk[]`). Padrão: 10.
	contextname	string	Nome do contexto SNMPv3. Suportado para itens SNMPv3.
	securityname	string	Nome de segurança SNMPv3. Suportado para itens SNMPv3.
	securitylevel	string	Nível de segurança SNMPv3. Suportado para itens SNMPv3. Valores possíveis:¹ NOAUTHNOPRIV (0, padrão), AUTHNOPRIV (1), AUTHPRIV (2).
	authprotocol	string	Protocolo de autenticação SNMPv3. Suportado para itens SNMPv3. Valores possíveis:¹ MD5 (0, padrão), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
	authpassphrase	string	Senha de autenticação SNMPv3. Suportado para itens SNMPv3.
	privprotocol	string	Protocolo de privacidade SNMPv3. Suportado para itens SNMPv3. Valores possíveis:¹ DES (0, padrão), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
	privpassphrase	string	Senha de privacidade SNMPv3. Suportado para itens SNMPv3.
	bulk	string	Usar requisições bulk para SNMP. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
interface_ref		string	Nome de referência da interface a ser usado nos items (formato: `if<N>`).

Veja também: Objeto de interface do host (consulte a propriedade relevante com o nome correspondente).

Items do host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             items:
               (...)
               - name: 'Binlog cache disk use'
                 type: DEPENDENT
                 key: mysql.binlog_cache_disk_use
                 value_type: FLOAT
                 description: 'Número de transações que usaram um cache de disco temporário porque não puderam caber no cache de log binário regular, sendo maior que `binlog_cache_size`.'
                 preprocessing: (veja a tabela abaixo)
                 master_item:
                   key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 tags:
                   - tag: component
                     value: cache
               (...)
               - name: 'Buffer pool utilization'
                 type: CALCULATED
                 key: mysql.buffer_pool_utilization
                 value_type: FLOAT
                 units: '%'
                 params: |
                   ( last(//mysql.innodb_buffer_pool_pages_total) - 
                   last(//mysql.innodb_buffer_pool_pages_free) ) / 
                   ( last(//mysql.innodb_buffer_pool_pages_total) + 
                   ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
                   ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
                 description: 'Proporção de páginas usadas para o total de páginas no buffer pool.'
                 tags:
                   - tag: component
                     value: memory
                 triggers: (veja a tabela abaixo)
               (...)
               - name: Uptime
                 type: DEPENDENT
                 key: mysql.uptime
                 units: uptime
                 description: 'Número de segundos que o servidor está ativo.'
                 preprocessing: (veja a tabela abaixo)
                 master_item:
                   key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 tags:
                   - tag: component
                     value: application
                 triggers: (veja a tabela abaixo)
               (...)

Elemento		Tipo	Descrição
name		string	(obrigatório) Nome do item.
type		string	Tipo do item. Valores possíveis:¹ ZABBIX_PASSIVE (0, padrão), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22), ITEM_TYPE_NESTED (23).
snmp_oid		string	(obrigatório para itens SNMP_AGENT) SNMP object ID.
key		string	(obrigatório) Chave do item.
delay		string	Intervalo de atualização do item. Padrão: 1m. O valor será sempre 0 para itens TRAP.
history		string	Período de tempo (usando sufixo de tempo, macro de usuário ou macro LLD) de quanto tempo os dados do histórico devem ser armazenados. Padrão: 31d.
trends		string	Período de tempo (usando sufixo de tempo, macro de usuário ou macro LLD) de quanto tempo os dados de tendências devem ser armazenados. Padrão: 365d.
status		string	Status do item. Valores possíveis:¹ ENABLED (0, padrão), DISABLED (1).
value_type		string	Tipo de valor recebido. Valores possíveis:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, padrão), TEXT (4), BINARY (5).
allowed_hosts		string	Lista de endereços IP separados por vírgula dos hosts permitidos a enviar dados para o item. Suportado para itens TRAP e HTTP_AGENT.
units		string	Unidades do valor recebido (bps, B, etc.).
params		text	Parâmetros adicionais dependendo do tipo do item (script executado para itens SSH e TELNET; consulta SQL para itens ODBC; fórmula para itens CALCULATED; script para itens ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER).
ipmi_sensor		string	Sensor IPMI. Suportado para itens IPMI.
authtype		string	Tipo de autenticação. Suportado para itens SSH e HTTP_AGENT. Valores possíveis para itens SSH:¹ PASSWORD (0, padrão), PUBLIC_KEY (1). Valores possíveis para itens HTTP_AGENT:¹ NONE (0, padrão), BASIC (1), NTLM (2).
username		string	(obrigatório para itens SSH e TELNET) Nome de usuário para autenticação. Suportado para itens SIMPLE, ODBC, JMX e HTTP_AGENT. Quando usado para itens JMX, `password` (veja abaixo) também deve ser especificado ou ambos os elementos devem ser deixados em branco.
password		string	(obrigatório para itens SSH e TELNET) Senha para autenticação. Suportado para itens SIMPLE, ODBC, JMX e HTTP_AGENT. Quando usado para itens JMX, `username` (veja acima) também deve ser especificado ou ambos os elementos devem ser deixados em branco.
publickey		string	(obrigatório para itens SSH) Nome do arquivo da chave pública.
privatekey		string	(obrigatório para itens SSH) Nome do arquivo da chave privada.
description		text	Descrição do item.
inventory_link		string	Campo de inventário do host que é preenchido pelo item. Valores possíveis:¹ NONE (0), ALIAS (4), etc. (veja Inventário do host para campos suportados).
valuemap			Elemento raiz para mapas de valor do item.
	name	string	(obrigatório) Nome do mapa de valor a ser usado para o item.
logtimefmt		string	Formato da hora nas entradas de log. Suportado para itens do tipo de valor LOG.
preprocessing			Elemento raiz para pré-processamento de valor do item.
	step		Elemento raiz para etapas de pré-processamento de valor do item do host.
interface_ref		string	Referência à interface do host (formato: `if<N>`).
jmx_endpoint		string	Endpoint JMX. Suportado para itens JMX.
master_item			(obrigatório para itens DEPENDENT) Elemento raiz para o item mestre do item dependente.
	key	string	(obrigatório) Chave do item mestre do item dependente.
timeout		string	Timeout da requisição de coleta de dados do item. Suportado para a lista de tipos de item em Timeouts.
url		string	(obrigatório para itens HTTP_AGENT) String de URL.
query_fields			Elemento raiz para parâmetros de consulta. Suportado para itens HTTP_AGENT.
	name	string	(obrigatório para itens HTTP_AGENT) Nome do parâmetro de consulta.
	value	string	Valor do parâmetro de consulta. Suportado para itens HTTP_AGENT.
parameters			Elemento raiz para parâmetros definidos pelo usuário. Suportado para itens ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER.
	name	string	(obrigatório para itens ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER) Nome do parâmetro definido pelo usuário.
	value	string	Valor do parâmetro definido pelo usuário. Suportado para itens ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER.
posts		string	Dados do corpo da requisição HTTP(S). Suportado para itens HTTP_AGENT.
status_codes		string	Intervalos de códigos de status HTTP necessários, separados por vírgula. Suportado para itens HTTP_AGENT.
follow_redirects		string	Seguir redirecionamentos de resposta ao coletar dados. Suportado para itens HTTP_AGENT. Valores possíveis:¹ NO (0), YES (1, padrão).
post_type		string	Tipo de corpo de dados postados. Suportado para itens HTTP_AGENT. Valores possíveis:¹ RAW (0, padrão), JSON (2), XML (3).
http_proxy		string	String de conexão do proxy HTTP(S). Suportado para itens HTTP_AGENT.
headers			Elemento raiz para cabeçalhos de requisição HTTP(S). Suportado para itens HTTP_AGENT.
	name	string	(obrigatório para itens HTTP_AGENT) Nome do cabeçalho.
	value	string	(obrigatório para itens HTTP_AGENT) Valor do cabeçalho.
retrieve_mode		string	Qual parte da resposta deve ser armazenada. Suportado para itens HTTP_AGENT. Valores possíveis:¹ BODY (0, padrão), HEADERS (1), BOTH (2).
request_method		string	Tipo de método de requisição. Suportado para itens HTTP_AGENT. Valores possíveis:¹ GET (0, padrão), POST (1), PUT (2), HEAD (3).
output_format		string	Como processar a resposta. Suportado para itens HTTP_AGENT. Valores possíveis:¹ RAW (0, padrão), JSON (1).
allow_traps		string	Permitir popular valor similar ao item trapper. Suportado para itens HTTP_AGENT. Valores possíveis:¹ NO (0, padrão), YES (1).
ssl_cert_file		string	Caminho do arquivo da chave pública SSL. Suportado para itens HTTP_AGENT.
ssl_key_file		string	Caminho do arquivo da chave privada SSL. Suportado para itens HTTP_AGENT.
ssl_key_password		string	Senha para o arquivo de chave SSL. Suportado para itens HTTP_AGENT.
verify_peer		string	Se deve validar que o certificado do host é autêntico. Suportado para itens HTTP_AGENT. Valores possíveis:¹ NO (0, padrão), YES (1).
verify_host		string	Se deve validar que o nome do host para a conexão corresponde ao do certificado do host. Suportado para itens HTTP_AGENT. Valores possíveis:¹ NO (0, padrão), YES (1).
tags			Elemento raiz para tags do item.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.
triggers			Elemento raiz para triggers de item do host.

Veja também: Objeto item (consulte a propriedade relevante com o nome correspondente).

Etapas de pré-processamento do valor do item do host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             items:
               (...)
               - name: 'Binlog cache disk use'
                 (...)
                 preprocessing:
                   - type: JSONPATH
                     parameters:
                       - $.Binlog_cache_disk_use
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 6h
                 (...)

Elemento		Tipo	Descrição
type		string	(obrigatório) O tipo de etapa de pré-processamento do valor do item. Valores possíveis:¹ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, calculado: valor recebido - valor anterior), CHANGE_PER_SECOND (10, calculado: (valor recebido - valor anterior)/(hora atual - hora da última verificação)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters			(obrigatório) Elemento raiz para os parâmetros da etapa de pré-processamento do valor do item.
	parameter	string	Parâmetro individual da etapa de pré-processamento do valor do item.
error_handler		string	Tipo de ação usada em caso de falha na etapa de pré-processamento. Valores possíveis:¹ ORIGINAL_ERROR (0, padrão), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		string	Parâmetros do manipulador de erros.

Veja também: Objeto de pré-processamento de item (consulte a propriedade relevante com o nome correspondente).

Triggers de item de host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             items:
               (...)
               - name: Uptime
                 (...)
                 triggers:
                   - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
                     name: 'MySQL: Failed to fetch info data'
                     event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
                     priority: INFO
                     description: 'Zabbix has not received any data for items for the last 30 minutes.'
                     dependencies:
                       - name: 'MySQL: Service is down'
                         expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
                     tags:
                       - tag: scope
                         value: availability
                   - expression: 'last(/MySQL server/mysql.uptime)<10m'
                     name: 'MySQL: Service has been restarted'
                     event_name: 'MySQL: Service has been restarted (uptime < 10m)'
                     priority: INFO
                     description: 'MySQL uptime is less than 10 minutes.'
                     tags:
                       - tag: scope
                         value: notice
               (...)

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador exclusivo para este trigger.
expression		string	(obrigatório) Expressão do trigger.
recovery_mode		string	Base para geração de eventos OK. Valores possíveis:¹ EXPRESSION (0, padrão), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		string	Expressão de recuperação do trigger.
correlation_mode		string	Modo de correlação (sem correlação de eventos ou correlação de eventos por tag). Valores possíveis:¹ DISABLED (0, padrão), TAG_VALUE (1).
correlation_tag		string	O nome da tag a ser usada para correlação de eventos.
name		string	(obrigatório) Nome do trigger.
event_name		string	Nome do evento.
opdata		string	Dados operacionais.
url_name		string	Rótulo para a URL associada ao trigger.
url		string	URL associada ao trigger.
status		string	Status do trigger. Valores possíveis:¹ ENABLED (0, padrão), DISABLED (1).
priority		string	Severidade do trigger. Valores possíveis:¹ NOT_CLASSIFIED (0, padrão), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description		text	Descrição do trigger.
type		string	Tipo de geração de evento (evento de problema único ou múltiplos eventos de problema). Valores possíveis:¹ SINGLE (0, padrão), MULTIPLE (1).
manual_close		string	Fechamento manual de eventos de problema. Valores possíveis:¹ NO (0, padrão), YES (1).
dependencies			Elemento raiz para dependências.
	name	string	(obrigatório) Nome do trigger de dependência.
	expression	string	(obrigatório) Expressão do trigger de dependência.
	recovery_expression	string	Expressão de recuperação do trigger de dependência.
tags			Elemento raiz para tags de trigger.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.

Veja também: Objeto trigger (consulte a propriedade relevante com o nome correspondente).

Regras de descoberta de baixo nível de host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             discovery_rules:
               - name: 'Database discovery'
                 key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 delay: 1h
                 filter: (veja a tabela abaixo)
                 description: 'Scanning databases in DBMS.'
                 interface_ref: if1
                 item_prototypes:
                   - name: 'Size of database {#DATABASE}'
                     key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
                     delay: 5m
                     units: B
                     description: 'Database size.'
                     preprocessing:
                       - type: DISCARD_UNCHANGED_HEARTBEAT
                         parameters:
                           - 1h
                     interface_ref: if1
                     tags:
                       - tag: component
                         value: storage
                       - tag: database
                         value: '{#DATABASE}'
                 lld_macro_paths:
                   - lld_macro: '{#DATABASE}'
                     path: $.Database
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
               (...)

A maioria dos elementos das regras de descoberta de baixo nível de host são os mesmos que para itens de host. A tabela abaixo descreve os elementos que diferem dos itens de host.

Elemento		Tipo	Descrição
type		string	Tipo de item. Valores possíveis:¹ ZABBIX_PASSIVE (0, padrão), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key		string	(obrigatório) A chave da regra de descoberta de baixo nível.
filter			Elemento raiz para filtros de regras de descoberta de baixo nível de host.
lifetime		string	Período de tempo (usando segundos, sufixo de tempo ou macro de usuário), após o qual recursos não mais descobertos serão excluídos. Padrão: 7d.
lifetime_type		string	Cenário para exclusão de recursos LLD perdidos. Valores possíveis: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime		string	Período de tempo (usando segundos, sufixo de tempo ou macro de usuário), após o qual recursos não mais descobertos serão desabilitados.
enabled_lifetime_type		string	Cenário para desabilitar recursos LLD perdidos. Valores possíveis: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes			Elemento raiz para elementos de protótipo de item de host, que são os mesmos que para itens de host.
trigger_prototypes			Elemento raiz para elementos de protótipo de trigger de host, que são os mesmos que para triggers de item de host.
graph_prototypes			Elemento raiz para protótipos de gráficos de host, que são os mesmos que para gráficos de host.
host_prototypes			Elemento raiz para protótipos de host, que são os mesmos que para hosts.
parent_discovery_rule			Elemento raiz para a regra de descoberta de baixo nível pai (ou protótipo de regra) do protótipo de regra de descoberta de baixo nível. Esta propriedade denota que é um protótipo de regra LLD, filho direto da regra/protótipo de regra referenciada.
	key	string	(obrigatório) A chave da regra de descoberta de baixo nível pai (ou protótipo de regra).
master_item		string	(obrigatório para regras DEPENDENT) Elemento raiz para o item mestre da regra dependente.
lld_macro_paths			Elemento raiz para caminhos de macro de regra de descoberta de baixo nível.
	lld_macro	string	(obrigatório) Nome da macro da regra de descoberta de baixo nível.
	path	string	(obrigatório) Seletor para o valor, que será atribuído à macro correspondente.
preprocessing			Elemento raiz para pré-processamento de valor da regra de descoberta de baixo nível.
	step		Elemento raiz para elementos de etapa de pré-processamento de valor da regra de descoberta de baixo nível, que são os mesmos que para etapas de pré-processamento de valor de item de host, exceto com menos valores possíveis. Veja também: Objeto de pré-processamento de regra LLD.
overrides			Elemento raiz para regras de sobrescrita de regra de descoberta de baixo nível.
	name	string	(obrigatório) Nome único da sobrescrita.
	step	string	(obrigatório) Número de ordem único da sobrescrita.
	stop	string	Parar o processamento das próximas sobrescritas se corresponder.
	filter		Elemento raiz para elementos de filtro de regra de sobrescrita de regra de descoberta de baixo nível, que são os mesmos que para filtros de regras de descoberta de baixo nível de host.
	operations		Elemento raiz para operações de sobrescrita de regra de descoberta de baixo nível de host.

Veja também: Objeto de regra LLD (consulte a propriedade relevante com o nome correspondente).

Filtros de regras de descoberta de baixo nível de host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             discovery_rules:
               - name: 'Database discovery'
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#DATABASE}'
                       value: '{$MYSQL.DBNAME.MATCHES}'
                     - macro: '{#DATABASE}'
                       value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                 (...)

Elemento		Tipo	Descrição
evaltype		string	Substitui o método de avaliação da condição do filtro. Valores possíveis:¹ AND_OR (0, padrão), AND (1), OR (2), FORMULA (3).
formula		string	Fórmula de cálculo personalizada para as condições do filtro.
conditions			Elemento raiz para condições de filtro.
	macro	string	(obrigatório) O nome da macro de descoberta de baixo nível para realizar a verificação.
	value	string	Valor para comparar.
	operator	string	Operador da condição. Valores possíveis:¹ MATCHES_REGEX (8, padrão), NOT_MATCHES_REGEX (9).
	formulaid	string	(obrigatório) ID único arbitrário que é usado para referenciar uma condição da expressão personalizada. Só pode conter letras maiúsculas. O ID deve ser definido pelo usuário ao modificar as condições do filtro, mas será gerado novamente ao solicitá-las posteriormente.

Veja também: Objeto de filtro de regra LLD (consulte a propriedade relevante com o nome correspondente).

Operações de sobrescrita de regra de descoberta de baixo nível de host

Elemento		Tipo	Descrição
operationobject		string	Objeto ao qual a operação é aplicada. Valores possíveis:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3), DISCOVERY_PROTOTYPE (4).
operator		string	Operador da condição de sobrescrita. Valores possíveis:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value		string	Uma expressão regular ou uma string para o operador de condição de sobrescrita.
status		string	Status do objeto após a operação de sobrescrita.
discover		string	Se o objeto é adicionado como resultado da descoberta.
delay		string	Intervalo de atualização definido para o protótipo de item após a operação de sobrescrita.
history		string	Período de armazenamento do histórico definido para o protótipo de item após a operação de sobrescrita.
trends		string	Período de armazenamento de tendências definido para o protótipo de item após a operação de sobrescrita.
severity		string	Severidade do protótipo de trigger definida após a operação de sobrescrita.
tags			Elemento raiz para as tags definidas para o objeto após a operação de sobrescrita.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.
templates			Elemento raiz para os templates vinculados ao protótipo de host após a operação de sobrescrita.
	name	string	(obrigatório) Nome do template.
inventory_mode		string	Modo de inventário do protótipo de host definido após a operação de sobrescrita.

Veja também: Objeto de operação de sobrescrita de regra LLD (consulte a propriedade relevante com o nome correspondente).

Cenários web do host

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador exclusivo para este cenário web.
name		string	(obrigatório) Nome do cenário web.
delay		string	Frequência (usando segundos, sufixo de tempo ou macro de usuário) de execução do cenário web. Padrão: 1m.
attempts		integer	O número de tentativas para executar as etapas do cenário web. Valores possíveis: 1-10 (padrão: 1).
agent		string	Agent do cliente. O Zabbix irá simular ser o navegador selecionado. Isto é útil quando um site retorna conteúdo diferente para navegadores diferentes. Padrão: Zabbix.
http_proxy		string	Proxy que será usado pelo cenário web fornecido como: `http://[username[:password]@]proxy.example.com[:port]`
variables			Elemento raiz para variáveis de cenário web que podem ser usadas nas etapas do cenário.
	name	string	(obrigatório) Nome da variável.
	value	text	(obrigatório) Valor da variável.
headers			Elemento raiz para cabeçalhos HTTP a serem enviados ao realizar uma requisição. Os cabeçalhos devem ser listados usando a mesma sintaxe que apareceriam no protocolo HTTP.
	name	string	(obrigatório) Nome do cabeçalho.
	value	text	(obrigatório) Valor do cabeçalho.
status		string	Status do cenário web. Valores possíveis:¹ ENABLED (0, padrão), DISABLED (1).
authentication		string	Método de autenticação. Valores possíveis:¹ NONE (0, padrão), BASIC (1), NTLM (2).
http_user		string	Nome de usuário usado para autenticação BASIC (HTTP) ou NTLM.
http_password		string	Senha usada para autenticação BASIC (HTTP) ou NTLM.
verify_peer		string	Verificar o certificado SSL do servidor web. Valores possíveis:¹ NO (0, padrão), YES (1).
verify_host		string	Verificar se o campo Common Name ou o campo Subject Alternate Name do certificado do servidor web corresponde. Valores possíveis:¹ NO (0, padrão), YES (1).
ssl_cert_file		string	Nome do arquivo de certificado SSL usado para autenticação do cliente (deve estar no formato PEM).
ssl_key_file		string	Nome do arquivo de chave privada SSL usado para autenticação do cliente (deve estar no formato PEM).
ssl_key_password		string	Senha do arquivo de chave privada SSL.
steps			(obrigatório) Elemento raiz para etapas do cenário web do host.
tags			Elemento raiz para tags de cenário web.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.

Veja também: Objeto de cenário web (consulte a propriedade relevante com o nome correspondente).

Etapas do cenário web do host

Elemento		Tipo	Descrição
name		string	(obrigatório) Nome da etapa do cenário web.
url		string	(obrigatório) URL para monitoramento.
query_fields			Elemento raiz para parâmetros de consulta (um array de campos HTTP a serem adicionados à URL ao executar uma solicitação).
	name	string	(obrigatório) Nome do parâmetro de consulta.
	value	string	Valor do parâmetro de consulta.
posts			Elemento raiz para variáveis HTTP POST (uma string (dados brutos do post) ou um array de campos HTTP (dados de campo de formulário)).
	name	string	(obrigatório) Nome do campo post.
	value	string	(obrigatório) Valor do campo post.
variables			Elemento raiz das variáveis em nível de etapa (macros) que devem ser aplicadas após esta etapa. Se o valor da variável tiver o prefixo 'regex:', então seu valor será extraído dos dados retornados por esta etapa de acordo com o padrão de expressão regular após o prefixo 'regex:'
	name	string	(obrigatório) Nome da variável.
	value	text	(obrigatório) Valor da variável.
headers			Elemento raiz para cabeçalhos HTTP a serem enviados ao executar uma solicitação.
	name	string	(obrigatório) Nome do cabeçalho.
	value	text	(obrigatório) Valor do cabeçalho.
follow_redirects		string	Seguir redirecionamentos HTTP. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
retrieve_mode		string	Modo de obtenção da resposta HTTP. Valores possíveis:¹ BODY (0, padrão), HEADERS (1), BOTH (2).
timeout		string	Timeout (em segundos, sufixo de tempo ou macro de usuário) da execução da etapa. Padrão: 15s.
required		string	Texto que deve estar presente na resposta (ignorado se vazio).
status_codes		string	Uma lista separada por vírgulas de códigos de status HTTP aceitos (por exemplo, `200-201,210-299`; ignorado se vazio).

Veja também: Objeto de etapa de cenário web (consulte a propriedade relevante com o nome correspondente).

Gráficos do host

zabbix_export:
         (...)
         graphs:
           - name: 'MySQL: Bandwidth'
             graph_items: (ver tabela abaixo)
           (...)

Elemento		Tipo	Descrição
uuid		string	Identificador único do gráfico.
name		string	(obrigatório) Nome do gráfico.
width		integer	Largura do gráfico, em pixels. Usado para visualização e para gráficos de pizza/explodidos. Valores possíveis:¹ 20-65535 (padrão: 900).
height		integer	Altura do gráfico, em pixels. Usado para visualização e para gráficos de pizza/explodidos. Valores possíveis:¹ 20-65535 (padrão: 900).
yaxismin		double	Valor mínimo do eixo Y. Suportado para valor mínimo FIXO do eixo Y. Padrão: 0.
yaxismax		double	Valor máximo do eixo Y. Suportado para valor mínimo FIXO do eixo X. Padrão: 0.
show_work_period		string	Destacar horas não úteis. Suportado para gráficos NORMAL e EMPILHADO. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
show_triggers		string	Exibir valores simples de trigger como uma linha. Suportado para gráficos NORMAL e EMPILHADO. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
type		string	Tipo de gráfico. Valores possíveis:¹ NORMAL (0, padrão), STACKED (1), PIE (2), EXPLODED (3).
show_legend		string	Exibir legenda do gráfico. Valores possíveis:¹ NÃO (0), SIM (1, padrão).
show_3d		string	Habilitar estilo 3D. Suportado para gráficos NORMAL e EMPILHADO. Valores possíveis:¹ NÃO (0, padrão), SIM (1).
percent_left		double	Exibir a linha de percentil para o eixo esquerdo. Suportado para gráficos NORMAL. Padrão: 0.
percent_right		double	Exibir a linha de percentil para o eixo direito. Suportado para gráficos NORMAL. Padrão: 0.
ymin_type_1		string	Valor mínimo do eixo Y. Suportado para gráficos NORMAL e EMPILHADO. Valores possíveis:¹ CALCULATED (0, padrão), FIXED (1), ITEM (2).
ymin_item_1			(obrigatório se `ymin_type_1` estiver definido como `ITEM`) Elemento raiz para detalhes individuais do item.
	host	string	(obrigatório) Host do item.
	key	string	(obrigatório) Chave do item.
ymax_type_1		string	Valor máximo do eixo Y. Suportado para gráficos NORMAL e EMPILHADO. Valores possíveis:¹ CALCULATED (0, padrão), FIXED (1), ITEM (2).
ymax_item_1			(obrigatório se `ymax_type_1` estiver definido como `ITEM`) Elemento raiz para detalhes individuais do item.
	host	string	(obrigatório) Host do item.
	key	string	(obrigatório) Chave do item.
graph_items			(obrigatório) Elemento raiz para itens de gráfico do host.

Veja também: Objeto gráfico (consulte a propriedade relevante com o nome correspondente).

Itens de gráfico de host

zabbix_export:
         (...)
         graphs:
           - name: 'MySQL: Bandwidth'
             graph_items:
               - drawtype: GRADIENT_LINE
                 color: 199C0D
                 item:
                   host: 'MySQL server'
                   key: mysql.bytes_received.rate
               - sortorder: '1'
                 drawtype: GRADIENT_LINE
                 color: F63100
                 item:
                   host: 'MySQL server'
                   key: mysql.bytes_sent.rate
           (...)

Elemento		Tipo	Descrição
sortorder		integer	Ordem de desenho. O menor valor é desenhado primeiro. Pode ser usado para desenhar linhas ou regiões atrás (ou na frente) de outra.
drawtype		string	Estilo de desenho do item do gráfico. Suportado para gráficos NORMAIS. Valores possíveis:¹ SINGLE_LINE (0, padrão), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color		string	Cor do elemento (6 símbolos, hex).
yaxisside		string	Lado do gráfico onde a escala Y do item do gráfico será desenhada. Suportado para gráficos NORMAIS e EMPILHADOS.
calc_fnc		string	Dados a serem desenhados se mais de um valor existir para um item. Valores possíveis:¹ MIN (1), AVG (2, padrão), MAX (4), ALL (7; mínimo, média e máximo; suportado para gráficos simples), LAST (9, suportado para gráficos de pizza/explodidos).
type		string	Tipo de item do gráfico. Valores possíveis:¹ SIMPLE (0, padrão), GRAPH_SUM (2; o valor do item representa o gráfico inteiro; suportado para gráficos de pizza/explodidos).
item			(obrigatório) Item individual.
	host	string	(obrigatório) Host do item.
	key	string	(obrigatório) Chave do item.

Veja também: Objeto de item de gráfico (consulte a propriedade relevante com o nome correspondente).

Mapas de valores do host

zabbix_export:
         (...)
         hosts:
           - host: 'MySQL server'
             (...)
             valuemaps:
               - name: Example value map
                 mappings:
                   - value: '1'
                     newvalue: Example value
         (...)

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador exclusivo para este mapa de valores.
name		string	(obrigatório) Nome do mapa de valores.
mapping			Elemento raiz para mapeamentos.
	type	string	Tipo de correspondência do mapeamento. Valores possíveis:¹ EQUAL (0, padrão), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	string	Valor original.
	newvalue	string	(obrigatório) Valor para o qual o valor original é mapeado.

Veja também: Objeto de mapa de valores (consulte a propriedade relevante com o nome correspondente).

Notas de rodapé

¹ Os valores inteiros da API entre parênteses, por exemplo, ENABLED (0), são mencionados apenas para referência. Para obter mais informações, consulte a página do objeto da API vinculada na entrada da tabela ou no final de cada seção.

Documentation