Table of Contents

3 Templates

3 Templates

Visão geral

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

A exportação de template contém:

Grupos de templates vinculados
Grupos de hosts vinculados (se usados na configuração de prototipagem de host)
Dados do template
Vinculação a outros templates
Vinculação a grupos de templates
Items vinculados diretamente
Triggers vinculados diretamente
Gráficos vinculados diretamente
Dashboards vinculados diretamente
Regras de descoberta vinculadas diretamente com todos os protótipos
Cenários web vinculados diretamente
Mapas de valores

Exportando

Para exportar templates, faça o seguinte:

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

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

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

Importando

Para importar templates, faça o seguinte:

Vá para Coleta de dados → Templates.
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 Vínculo de template, o vínculo de template atual que não estiver presente no arquivo de importação será desvinculado. As 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).

Na próxima tela, você poderá visualizar o conteúdo de um template sendo importado. Se este for um novo template, todos os elementos serão listados em verde. Se estiver atualizando um template existente, os novos elementos do template serão destacados em verde; os elementos removidos do template serão destacados em vermelho; os elementos que não foram alterados serão listados em um fundo cinza.

O menu à esquerda pode ser usado para navegar pela lista de alterações. A seção Atualizado destaca todas as alterações feitas nos elementos existentes do template. A seção Adicionado lista os novos elementos do template. Os elementos em cada seção são agrupados por tipo de elemento; clique na seta cinza para expandir ou recolher o grupo de elementos.

Revise as alterações do template e clique em Importar para realizar a importação do template. Uma mensagem de sucesso ou falha da importação será exibida no frontend.

Formato de exportação

Quando um template é exportado, o Zabbix gera um formato estruturado em YAML, JSON ou XML. A exportação inclui elementos do template, como metadados do template, items, macros, triggers, dashboards 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 o template Linux by Zabbix agent.

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 template

zabbix_export:
         version: '8.0'
         template_groups:
           - uuid: 846977d1dfed4968bc5f8bdb363285bc
             name: 'Templates/Operating systems'
         templates: (ver tabela abaixo)
         triggers: (ver tabela abaixo)
         graphs: (ver tabela abaixo)

Elemento		Tipo	Descrição
version		string	(obrigatório) Versão da exportação.
template_groups			(obrigatório) Elemento raiz para grupos de template.
	uuid	string	(obrigatório) Identificador único para este grupo de template.
	name	string	(obrigatório) Nome do grupo de template.
host_groups			Elemento raiz para grupos de host que são usados por protótipos de host.
	uuid	string	(obrigatório) Identificador único para este grupo de host.
	name	string	(obrigatório) Nome do grupo de host.
templates			Elemento raiz para templates.
triggers			Elemento raiz para elementos de trigger de template, que são os mesmos que para triggers de item de template.
graphs			Elemento raiz para elementos de gráfico de template, que são os mesmos que para gráficos de host.

Templates

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             template: 'Linux by Zabbix agent'
             name: 'Linux by Zabbix agent'
             description: |
               Este é um template oficial do Linux. Requer o agent Zabbix 8.0 ou mais recente. (...)
             wizard_ready: 'YES'
             readme: |
               ## Visão geral
               
               Este é um template oficial do Linux. Requer o agent Zabbix 8.0 ou mais recente. (...)
             vendor:
               name: Zabbix
               version: 8.0-2
             groups:
               - name: 'Templates/Operating systems'
             items: (veja a tabela abaixo)
             discovery_rules: (veja a tabela abaixo)
             tags:
               - tag: class
                 value: os
               - tag: target
                 value: linux
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 value: 3m
                 description: 'Tempo limite após o qual o agent é considerado indisponível. Funciona apenas para agents acessíveis a partir do Zabbix server/proxy (modo passivo).'
                 config: (veja a tabela abaixo)
               - macro: '{$CPU.UTIL.CRIT}'
                 value: '90'
                 description: 'Limite crítico de utilização da CPU expresso em %.'
                 config: (veja a tabela abaixo)
               (...)
             dashboards: (veja a tabela abaixo)
             valuemaps: (veja a tabela abaixo)
           (...)

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador exclusivo para este template.
template		string	(obrigatório) Nome exclusivo do template.
name		string	Nome visível do template.
description		text	Descrição do template.
wizard_ready		text	Se o template está disponível para seleção no Assistente de Host. Valores possíveis:¹ NO (0, padrão), YES (1). Veja também: Objeto template (`wizard_ready`).
readme		text	Instruções de configuração específicas do template para exibir no Assistente de Host. Suporta formatação Markdown.
vendor			Elemento raiz para o fornecedor do template (presente se o template exportado contiver dados do fornecedor).
	name	string	(obrigatório) Nome do fornecedor do template.
	version	string	(obrigatório) Versão do template. Para templates prontos para uso, a versão é exibida da seguinte forma: versão principal do Zabbix, delimitador ("-"), número de revisão (aumentado a cada nova versão do template e redefinido a cada versão principal do Zabbix). Por exemplo, 7.0-0, 7.0-3, 8.0-0, 8.0-3.
templates			Elemento raiz para templates vinculados.
	name	string	(obrigatório) Nome do template.
groups			Elemento raiz para grupos de templates.
	name	string	(obrigatório) Nome do grupo de templates.
items			Elemento raiz para itens do template.
discovery_rules			Elemento raiz para regras de descoberta de baixo nível do template.
httptests			Elemento raiz para cenários web do template.
tags			Elemento raiz para tags do template.
	tag	string	(obrigatório) Nome da tag.
	value	string	Valor da tag.
macros			Elemento raiz para macros de usuário do template.
	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). Veja também: Objeto macro de usuário (`type`).
	value	string	Valor da macro de usuário.
	description	string	Descrição da macro de usuário.
	config		Elemento raiz para configuração de macro do template responsável por como a macro é exibida no Assistente de Host.
dashboards			Elemento raiz para dashboards do template.
valuemaps			Elemento raiz para mapas de valores do template.

Itens do template

zabbix_export:
         (...)
         templates:
           (...)
             items:
               - uuid: f94f9f4699e94c369e6c98b2a2f485ce
                 name: 'Zabbix agent ping'
                 key: agent.ping
                 description: 'O agent sempre retorna "1" para este item. Pode ser usado em combinação com `nodata()` para a verificação de disponibilidade.'
                 valuemap:
                   name: 'Zabbix agent ping status'
                 tags:
                   - tag: component
                     value: system
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 name: 'Number of installed packages'
                 key: system.sw.packages.get
                 delay: 1h
                 preprocessing: (ver tabela abaixo)
                 tags:
                   - tag: component
                     value: os
                 triggers: (ver tabela abaixo)
               - uuid: 403cebed115441369e94d35d070ca7b8
                 name: 'Memory utilization'
                 type: DEPENDENT
                 key: vm.memory.utilization
                 value_type: FLOAT
                 units: '%'
                 description: 'A porcentagem de memória usada é calculada como `100-pavailable`.'
                 preprocessing: (ver tabela abaixo)
                 master_item:
                   key: 'vm.memory.size[pavailable]'
                 tags:
                   - tag: component
                     value: memory
                 triggers: (ver tabela abaixo)
               (...)

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador único para este item.
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).
snmp_oid		string	(obrigatório para itens SNMP_AGENT) OID SNMP.
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 template.
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 o valor de forma semelhante 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 da chave SSL. Suportado para itens HTTP_AGENT.
verify_peer		string	Se deve validar se 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 se 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 template.

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

Etapas de pré-processamento de valor de item de template

zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 preprocessing:
                   - type: JSONPATH
                     parameters:
                       - $.length()
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 12h
                 (...)

Elemento		Tipo	Descrição
type		string	(obrigatório) O tipo da 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 mesmo nome).

Triggers de item de template

zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 triggers:
                   - uuid: b950c306394f4b3c902060a8273cbcde
                     expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
                     name: 'Linux: Number of installed packages has been changed'
                     priority: WARNING
                     manual_close: 'YES'
                     tags:
                       - tag: scope
                         value: notice
               (...)
               - uuid: 403cebed115441369e94d35d070ca7b8
                 (...)
                 triggers:
                   - uuid: cfd395b1cde74ef18a5e5f840bd5142a
                     expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
                     name: 'Linux: High memory utilization'
                     event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)'
                     priority: AVERAGE
                     description: 'The system is running out of free memory.'
                     dependencies:
                       - name: 'Linux: Lack of available memory'
                         expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
                     tags:
                       - tag: scope
                         value: capacity
                       - tag: scope
                         value: performance
               (...)

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 evento ou correlação de evento 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 template

zabbix_export:
         (...)
         templates:
           (...)
             discovery_rules:
               - uuid: acfdea9c46ef48c68e6636f43b8f96a2
                 name: 'Network interface discovery'
                 key: net.if.discovery
                 delay: 1h
                 filter: (veja a tabela abaixo)
                 description: 'The discovery of network interfaces.'
                 item_prototypes: (veja a tabela abaixo)
                 trigger_prototypes: (veja a tabela abaixo)
                 graph_prototypes: (veja a tabela abaixo)
               (...)

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

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 template.
lifetime		string	Período de tempo (usando segundos, sufixo de tempo ou macro de usuário), após o qual os recursos não mais descobertos serão excluídos. Padrão: 7d.
lifetime_type		string	Cenário para excluir 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 os 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 template, que são os mesmos que para itens de template.
trigger_prototypes			Elemento raiz para elementos de protótipo de trigger de template, que são os mesmos que para triggers de item de template.
graph_prototypes			Elemento raiz para elementos de protótipo de gráfico de template, que são os mesmos que para gráficos de host.
host_prototypes			Elemento raiz para elementos de protótipo de host de template, 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 indica que é um protótipo de regra LLD, filho direto da regra/protótipo de regra referenciado.
	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 de regra de descoberta de baixo nível.
	step		Elemento raiz para elementos de etapa de pré-processamento de valor de regra de descoberta de baixo nível, que são os mesmos que para etapas de pré-processamento de valor de item de template, 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 de template, que são os mesmos que para filtros de regras de descoberta de baixo nível de template.
	operations		Elemento raiz para operações de sobrescrita de regra de descoberta de baixo nível de template.

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 template

zabbix_export:
         (...)
         templates:
           (...)
             discovery_rules:
               - uuid: acfdea9c46ef48c68e6636f43b8f96a2
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.MATCHES}'
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                 (...)
               - uuid: 2bbdc79f082d4c618e01bec625e9c90a
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.MATCHES}'
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                     - macro: '{#DEVTYPE}'
                       value: disk
                 (...)

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 condições de 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 exclusivo arbitrário 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 substituição de regra de descoberta de baixo nível de template

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).
operator		string	Operador da condição de substituição. 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 substituição.
status		string	Status do objeto após a operação de substituição.
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 substituição.
history		string	Período de armazenamento do histórico definido para o protótipo de item após a operação de substituição.
trends		string	Período de armazenamento de tendências definido para o protótipo de item após a operação de substituição.
severity		string	Gravidade do protótipo de trigger definida após a operação de substituição.
tags			Elemento raiz para as tags definidas para o objeto após a operação de substituição.
	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 substituição.
	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 substituição.

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

Template de cenários web

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 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	Verifica o certificado SSL do servidor web. Valores possíveis:¹ NO (0, padrão), YES (1).
verify_host		string	Verifica 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 de cenário web de template.
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 template

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 requisiçã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 do post.
	value	string	(obrigatório) Valor do campo do post.
variables			Elemento raiz das variáveis (macros) no nível da etapa 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 requisiçã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 (usando 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 do cenário web (consulte a propriedade relevante com o nome correspondente).

Configuração de macro de template

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             (...)
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '1'
                   label: 'Segundos desde a última vez que o agent Zabbix foi visto'
                   description: 'Tempo limite após o qual o agent é considerado indisponível.'
               - macro: '{$CPU.UTIL.CRIT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '2'
                   section_name: Thresholds
                   label: 'Limite de utilização da CPU expresso'
                   description: 'Limite crítico de utilização da CPU expresso em %. No intervalo de 0 a 100 inclusive.'
                   regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
               (...)
               - macro: '{$IFCONTROL}'
                 (...)
                 config:
                   type: CHECKBOX
                   priority: '19'
                   label: 'Controle de interfaces'
                   description: 'Dispara um trigger quando o status operacional da interface muda para "Link down".'
                   options:
                     - checked: '1'
                       unchecked: '0'
               (...)

Elemento		Tipo	Descrição
type		string	(obrigatório) Tipo de campo de entrada da macro. Valores possíveis:¹ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).
priority		string	Posição da macro na lista de macros.
section_name		string	Rótulo da seção recolhível onde a macro é agrupada.
label		string	(obrigatório para macros TEXT, LIST, CHECKBOX) Rótulo da macro.
description		text	Texto de ajuda da macro. Suporta formatação Markdown.
required		string	Marca a macro como obrigatória. Valores possíveis:¹ NO (0), YES (1). Suportado para macros TEXT e LIST.
regex		string	Expressão regular para validar a entrada do usuário em um campo de texto. Suportado para macros TEXT.
options			Elemento raiz para itens LIST ou valores CHECKBOX.
	value	string	(obrigatório para macros LIST) Valor do item LIST.
	text	string	(obrigatório para macros LIST) Texto do item LIST.
	checked	string	(obrigatório para macros CHECKBOX) Valor que representa o estado marcado. Valores possíveis:¹ 0 (falso), 1 (verdadeiro). Suportado para macros CHECKBOX.
	unchecked	string	(obrigatório para macros CHECKBOX) Valor que representa o estado desmarcado. Valores possíveis:¹ 0 (falso), 1 (verdadeiro). Suportado para macros CHECKBOX.

Veja também: Objeto de configuração de macro (consulte a propriedade relevante com o nome correspondente).

Dashboards de template

zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Filesystems
                 pages:
                   - name: Overview
                     widgets: (veja a tabela abaixo)
               (...)

Elemento		Tipo	Descrição
uuid		string	(obrigatório) Identificador exclusivo para este dashboard.
name		string	(obrigatório) Nome do dashboard do template.
display period		integer	Período de exibição das páginas do dashboard.
auto_start		string	Início automático da apresentação de slides. Valores possíveis:¹ NO (0), YES (1, padrão).
pages			Elemento raiz para páginas do dashboard do template.
	name	string	Nome da página.
	display period	integer	Período de exibição da página.
	sortorder	integer	Ordem de classificação da página.
widgets			Elemento raiz para widgets do dashboard do template.

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

Widgets do dashboard de template

zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Filesystems
                 pages:
                   - name: Overview
                     widgets:
                       - type: graphprototype
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '3'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux by Zabbix agent'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Space utilization chart (relative to total)'
                           - type: STRING
                             name: reference
                             value: AAAEB
                       - type: graphprototype
                         'y': '5'
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '1'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux by Zabbix agent'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Space usage graph, in % (relative to max available)'
                           - type: STRING
                             name: reference
                             value: AAAEC
               (...)

Elemento		Tipo	Descrição
type		string	(obrigatório) Tipo de widget.
name		string	Nome do widget.
x		integer	Posição horizontal a partir do lado esquerdo do dashboard do template. Valores possíveis:¹ 0-71.
y		integer	Posição vertical a partir do topo do dashboard do template. Valores possíveis:¹ 0-63.
width		integer	Largura do widget. Valores possíveis:¹ 1-72.
height		integer	Altura do widget. Valores possíveis:¹ 1-64.
hide_header		string	Ocultar o cabeçalho do widget. Valores possíveis:¹ NO (0, padrão), YES (1).
fields			Elemento raiz para os campos do widget do dashboard do template.
	type	string	(obrigatório) Tipo de campo do widget. Valores possíveis:¹ INTEGER (0), STRING (1), ITEM (4), ITEM_PROTOTYPE (5), GRAPH (6), GRAPH_PROTOTYPE (7), MAP (8), SERVICE (9), SLA (10), USER (11), ACTION (12), MEDIA_TYPE (13).
	name	string	(obrigatório) Nome do campo do widget.
	value	mixed	(obrigatório) Valor do campo do widget, dependendo do tipo de campo.

Veja também: Objeto widget do dashboard do template (consulte a propriedade relevante com o nome correspondente).

Mapas de valores do template

zabbix_export:
         (...)
         templates:
           (...)
             valuemaps:
               - uuid: 8c048c6cca8248f2860c208e8db0f59e
                 name: ifOperStatus
                 mappings:
                   - value: '0'
                     newvalue: unknown
                   - value: '1'
                     newvalue: notpresent
                   - value: '2'
                     newvalue: down
                   - value: '3'
                     newvalue: lowerlayerdown
                   - value: '4'
                     newvalue: testing
                   - value: '5'
                     newvalue: dormant
                   - value: '6'
                     newvalue: up
               (...)

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