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 dados → Templates.
  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 dados → Templates.
  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:

Rule Description
Update existing Os elementos existentes serão atualizados usando os dados do arquivo de importação. Caso contrário, eles não serão atualizados.
Create new Novos elementos serão criados usando os dados do arquivo de importação. Caso contrário, eles não serão criados.
Delete missing 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 Delete missing estiver marcado para Template linkage, o vínculo atual do template 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 Delete missing também seja selecionada para cada entidade).

Na próxima tela, você poderá visualizar o conteúdo de um template sendo importado. Se 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 Updated destaca todas as alterações feitas nos elementos existentes do template. A seção Added 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, em seguida, clique em Importar para executar 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.

Element Type Description
template_groups (obrigatório) Elemento raiz para grupos de template.
uuid string (obrigatório) Identificador exclusivo para este grupo de template.
name string (obrigatório) Nome do grupo de template.
host_groups (obrigatório) Elemento raiz para grupos de host usados por protótipos de host.
uuid string (obrigatório) Identificador exclusivo para este grupo de host.
name string (obrigatório) Nome do grupo de host.
templates Elemento raiz para templates.

Templates

Element Type Description
uuid string (obrigatório) Identificador único para este template.
template string (obrigatório) Nome único 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 da revisão (aumentado a cada nova versão do template e reiniciado 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 da macro de usuário.
Valores possíveis:1 TEXT (0, padrão), SECRET_TEXT (1), VAULT (2).
Veja também: Objeto de 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

Element Type Description
uuid string (obrigatório) Identificador exclusivo deste item.
name string (obrigatório) Nome do item.
type string Tipo do 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) ID do objeto 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) durante o qual os dados de 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) durante o qual 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 do 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 de hosts, separados por vírgulas, 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; o 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), Kerberos (3) ou Digest (4).
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 preenchido pelo item.
Valores possíveis:1 NONE (0), ALIAS (4), etc. (consulte Inventário do host para os 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 o pré-processamento do valor do item.
step Elemento raiz para etapas de pré-processamento do valor de 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 coleta de dados do item.
Suportado para a lista de tipos de item em Tempos limite.
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 da resposta durante a coleta de dados.
Suportado para itens HTTP_AGENT.
Valores possíveis:1 NO (0), YES (1, padrão).
post_type string Tipo do corpo dos dados de postagem.
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 da 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 do método da 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 SSL pública.
Suportado para itens HTTP_AGENT.
ssl_key_file string Caminho do arquivo da chave SSL privada.
Suportado para itens HTTP_AGENT.
ssl_key_password string Senha do 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:1 NO (0, padrão), YES (1).
verify_host string Se deve validar se o nome do host para a conexão corresponde ao nome no 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
Element Type Description
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 do último check)), 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 usado 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 de item (consulte a propriedade relevante com o nome correspondente).

Triggers de item de template
Element Type Description
uuid string (obrigatório) Identificador único 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 eventos ou correlação de eventos por tag).
Valores possíveis:1 DISABLED (0, padrão), TAG_VALUE (1).
correlation_tag string O nome da tag a ser usado 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 do trigger.
tag string (obrigatório) Nome da tag.
value string Valor da tag.

Veja também: Trigger object (consulte a propriedade relevante com o mesmo nome).

Regras de descoberta em baixo nível de template

A maioria dos elementos da regra de descoberta em baixo nível de template é a mesma que a dos itens de template. A tabela abaixo descreve os elementos que diferem dos itens de template.

Element Type Description
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 em baixo nível.
filter Elemento raiz para filtros de regras de descoberta em 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 descobertos que não existirem mais 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 descobertos que não existirem mais 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 os de itens de template.
trigger_prototypes Elemento raiz para elementos de protótipo de trigger de template, que são os mesmos que os de 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 os de gráficos de host.
host_prototypes Elemento raiz para elementos de protótipo de host de template, que são os mesmos que os de 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 da regra de descoberta em baixo nível.
lld_macro string (obrigatório) Nome da macro da regra de descoberta em baixo nível.
path string (obrigatório) Seletor do valor, que será atribuído à macro correspondente.
preprocessing Elemento raiz para o pré-processamento do valor da regra de descoberta em baixo nível.
step Elemento raiz para elementos de etapa de pré-processamento do valor da regra de descoberta em baixo nível, que são os mesmos que os de etapas de pré-processamento de valor de item de template, exceto por haver menos valores possíveis. Veja também: objeto de pré-processamento da regra LLD.
overrides Elemento raiz para regras de substituição da regra de descoberta em baixo nível.
name string (obrigatório) Nome exclusivo da substituição.
step string (obrigatório) Número de ordem exclusivo da substituição.
stop string Interrompe o processamento das próximas substituições se corresponder.
filter Elemento raiz para elementos de filtro da regra de substituição da regra de descoberta em baixo nível de template, que são os mesmos que os de filtros de regras de descoberta em baixo nível de template.
operations Elemento raiz para operações de substituição da regra de descoberta em baixo nível de template.

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

Filtros da regra de descoberta de baixo nível do template
Element Type Description
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 a ser verificada.
value string Valor com o qual comparar.
operator string Operador da condição.
Valores possíveis:1 MATCHES_REGEX (8, padrão), NOT_MATCHES_REGEX (9).
formulaid string (obrigatório) ID único arbitrário usado para referenciar uma condição a partir da expressão personalizada. Pode conter apenas 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 depois.

Veja também: Objeto de filtro da 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: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 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 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), Kerberos (3) ou Digest (4).
http_user string Nome de usuário usado para autenticação BASIC (HTTP), NTLM, Kerberos ou Digest.
http_password string Senha usada para autenticação BASIC (HTTP), NTLM, Kerberos ou Digest.
verify_peer string Verifica o certificado SSL do servidor web.
Valores possíveis:1 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: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 cenário web do 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: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

Element Type Description
uuid string (obrigatório) Identificador único para este dashboard.
name string (obrigatório) Nome do dashboard de 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 as páginas do dashboard de 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 de template.

Veja também: Objeto Template dashboard (consulte a propriedade correspondente com o mesmo nome).

Widgets do dashboard de template
Element Type Description
type string (obrigatório) Tipo do 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 do 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 do template

Element Type Description
uuid string (obrigatório) Identificador único 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 correspondente com o mesmo nome).

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.