Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

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:

  1. Vá para Coleta de dadosTemplates.
  2. Marque as caixas de seleção dos templates a serem exportados.
  3. 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:

  1. Vá para Coleta de dadosTemplates.
  2. Clique em Importar no canto superior direito.
  3. Selecione o arquivo de importação.
  4. 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. 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

Formato de exportação em YAML:

zabbix_export:
         version: '7.0'
         template_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Templates/Applications
         host_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Applications
         templates:
           - uuid: 56079badd056419383cc26e6a4fcc7e0
             template: VMware
             name: VMware
             description: |
               Você pode discutir este template ou deixar seu feedback em nosso fórum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/
       
               Versão da ferramenta de template utilizada: 0.41
             groups:
               - name: Templates/Applications
             items:
               - uuid: 5ce209f4d94f460488a74a92a52d92b1
                 name: 'VMware: Event log'
                 type: SIMPLE
                 key: 'vmware.eventlog[{$VMWARE.URL},skip]'
                 history: 7d
                 trends: '0'
                 value_type: LOG
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Coleta do log de eventos do VMware.'
                 tags:
                   - tag: component
                     value: log
               - uuid: ee2edadb8ce943ef81d25dbbba8667a4
                 name: 'VMware: Full name'
                 type: SIMPLE
                 key: 'vmware.fullname[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Nome completo do serviço VMware.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
               - uuid: a0ec9145f2234fbea79a28c57ebdb44d
                 name: 'VMware: Version'
                 type: SIMPLE
                 key: 'vmware.version[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Versão do serviço VMware.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
             discovery_rules:
               - uuid: 16ffc933cce74cf28a6edf306aa99782
                 name: 'Discover VMware clusters'
                 type: SIMPLE
                 key: 'vmware.cluster.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Descoberta de clusters'
                 item_prototypes:
                   - uuid: 46111f91dd564a459dbc1d396e2e6c76
                     name: 'VMware: Status of "{#CLUSTER.NAME}" cluster'
                     type: SIMPLE
                     key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Status do cluster VMware.'
                     valuemap:
                       name: 'VMware status'
                     tags:
                       - tag: cluster
                         value: '{#CLUSTER.NAME}'
                       - tag: component
                         value: cluster
               - uuid: 8fb6a45cbe074b0cb6df53758e2c6623
                 name: 'Discover VMware datastores'
                 type: SIMPLE
                 key: 'vmware.datastore.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 item_prototypes:
                   - uuid: 4b61838ba4c34e709b25081ae5b059b5
                     name: 'VMware: Average read latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Tempo de leitura de uma operação no datastore (milissegundos).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 5355c401dc244bc588ccd18767577c93
                     name: 'VMware: Free space on datastore {#DATASTORE} (percentage)'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]'
                     delay: 5m
                     history: 7d
                     value_type: FLOAT
                     units: '%'
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Espaço do datastore VMware em porcentagem do total.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0
                     name: 'VMware: Total size of datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]'
                     delay: 5m
                     history: 7d
                     units: B
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Espaço do datastore VMware em bytes.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d
                     name: 'VMware: Average write latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Tempo de escrita de uma operação no datastore (milissegundos).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
               - uuid: a5bc075e89f248e7b411d8f960897a08
                 name: 'Discover VMware hypervisors'
                 type: SIMPLE
                 key: 'vmware.hv.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Descoberta de hipervisores.'
                 host_prototypes:
                   - uuid: 051a1469d4d045cbbf818fcc843a352e
                     host: '{#HV.UUID}'
                     name: '{#HV.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME}'
                       - name: '{#DATACENTER.NAME}'
                     templates:
                       - name: 'VMware Hypervisor'
                     macros:
                       - macro: '{$VMWARE.HV.UUID}'
                         value: '{#HV.UUID}'
                         description: 'UUID do hipervisor.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#HV.IP}'
               - uuid: 9fd559f4e88c4677a1b874634dd686f5
                 name: 'Discover VMware VMs'
                 type: SIMPLE
                 key: 'vmware.vm.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Descoberta de máquinas virtuais convidadas.'
                 host_prototypes:
                   - uuid: 23b9ae9d6f33414880db1cb107115810
                     host: '{#VM.UUID}'
                     name: '{#VM.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME} (vm)'
                       - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)'
                       - name: '{#HV.NAME}'
                     templates:
                       - name: 'VMware Guest'
                     macros:
                       - macro: '{$VMWARE.VM.UUID}'
                         value: '{#VM.UUID}'
                         description: 'UUID da máquina virtual convidada.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#VM.IP}'
             tags:
               - tag: class
                 value: software
               - tag: target
                 value: vmware
             macros:
               - macro: '{$VMWARE.PASSWORD}'
                 description: 'Senha do usuário {$USERNAME} do serviço VMware'
               - macro: '{$VMWARE.URL}'
                 description: 'URL do SDK do serviço VMware (vCenter ou hipervisor ESX) (https://servername/sdk)'
               - macro: '{$VMWARE.USERNAME}'
                 description: 'Nome do usuário do serviço VMware'
             valuemaps:
               - uuid: 3c59c22905054d42ac4ee8b72fe5f270
                 name: 'VMware status'
                 mappings:
                   - value: '0'
                     newvalue: gray
                   - value: '1'
                     newvalue: green
                   - value: '2'
                     newvalue: yellow
                   - value: '3'
                     newvalue: red

Elementos exportados

Os elementos exportados são explicados nas tabelas abaixo.

Elemento Tipo Descrição
template_groups (obrigatório) Elemento raiz para grupos de templates.
uuid string (obrigatório) Identificador exclusivo para este grupo de templates.
name string (obrigatório) Nome do grupo de templates.
host_groups (obrigatório) Elemento raiz para grupos de hosts que são usados por protótipos de host.
uuid string (obrigatório) Identificador exclusivo para este grupo de hosts.
name string (obrigatório) Nome do grupo de hosts.
templates Elemento raiz para templates.

Templates

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.
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, 6.4-0, 6.4-3, 7.0-0, 7.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 de macro de usuário.
Valores possíveis:1 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.
dashboards Elemento raiz para dashboards do template.
valuemaps Elemento raiz para mapas de valor do template.

Itens do template

Elemento Tipo Descrição
uuid string (obrigatório) Identificador exclusivo para este item.
name string (obrigatório) Nome do item.
type string Tipo de item.
Valores possíveis:1 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) 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:1 ENABLED (0, padrão), DISABLED (1).
value_type string Tipo de valor recebido.
Valores possíveis:1 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 autorizados 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:1 PASSWORD (0, padrão), PUBLIC_KEY (1).
Valores possíveis para itens HTTP_AGENT:1 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:1 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 Tempo limite da solicitação de polling 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 solicitação HTTP(S).
Suportado para itens HTTP_AGENT.
status_codes string Intervalos de códigos de status HTTP necessários, separados por vírgulas.
Suportado para itens HTTP_AGENT.
follow_redirects string Seguir redirecionamentos de resposta ao coletar dados.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 NO (0), YES (1, padrão).
post_type string Tipo de corpo de dados postados.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 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 solicitaçã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:1 BODY (0, padrão), HEADERS (1), BOTH (2).
request_method string Tipo de método de solicitação.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 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:1 RAW (0, padrão), JSON (1).
allow_traps string Permitir preencher o valor de forma semelhante ao item trapper.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 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 que o certificado do host é autêntico.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 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:1 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 itens do template.

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

Etapas de pré-processamento do valor do item do template
Elemento Tipo Descrição
type string (obrigatório) O tipo da etapa de pré-processamento do valor do item.
Valores possíveis:1 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:1 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 do item (consulte a propriedade relevante com o mesmo nome).

Triggers de item de template
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 gerar eventos OK.
Valores possíveis:1 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:1 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:1 ENABLED (0, padrão), DISABLED (1).
priority string Severidade do trigger.
Valores possíveis:1 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:1 SINGLE (0, padrão), MULTIPLE (1).
manual_close string Fechamento manual de eventos de problema.
Valores possíveis:1 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 do template

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

Elemento Tipo Descrição
type string Tipo de item.
Valores possíveis:1 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 regra de descoberta de baixo nível do 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 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 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 do template, que são os mesmos que para itens do template.
trigger_prototypes Elemento raiz para elementos de protótipo de trigger do template, que são os mesmos que para triggers de item do template.
graph_prototypes Elemento raiz para elementos de protótipo de gráfico do template, que são os mesmos que para gráficos do host.
host_prototypes Elemento raiz para elementos de protótipo de host do template, que são os mesmos que para hosts.
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 do 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 do template, que são os mesmos que para filtros de regra de descoberta de baixo nível do template.
operations Elemento raiz para operações de sobrescrita de regra de descoberta de baixo nível do 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
Elemento Tipo Descrição
evaltype string Substitui o método de avaliação da condição do filtro.
Valores possíveis:1 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 as condições do 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 de condição.
Valores possíveis:1 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 substituição de regras de descoberta de baixo nível de template
Elemento Tipo Descrição
operationobject string Objeto ao qual a operação é aplicada.
Valores possíveis:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Operador da condição de substituição.
Valores possíveis:1 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 Severidade 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 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 executar uma solicitaçã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:1 ENABLED (0, padrão), DISABLED (1).
authentication string Método de autenticação.
Valores possíveis:1 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:1 NO (0, padrão), YES (1).
verify_host string Verifique se o campo Common Name ou o campo Subject Alternate Name do certificado do servidor web corresponde.
Valores possíveis:1 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 template de cenário web.
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 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 do campo do 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 que segue 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:1 NÃO (0), SIM (1, padrão).
retrieve_mode string Modo de obtenção da resposta HTTP.
Valores possíveis:1 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).

Dashboards de template

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:1 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
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 de template.
Valores possíveis:1 0-71.
y integer Posição vertical a partir do topo do dashboard de template.
Valores possíveis:1 0-63.
width integer Largura do widget.
Valores possíveis:1 1-72.
height integer Altura do widget.
Valores possíveis:1 1-64.
hide_header string Ocultar o cabeçalho do widget.
Valores possíveis:1 NO (0, padrão), YES (1).
fields Elemento raiz para os campos do widget do dashboard de template.
type string (obrigatório) Tipo de campo do widget.
Valores possíveis:1 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 de template (consulte a propriedade relevante com o nome correspondente).

Mapas de valores de template

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:1 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é

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