4 Hosts

Visão geral

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

A exportação de host contém:

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

Exportando

Para exportar hosts, faça o seguinte:

  1. Vá para Coleta de dadosHosts.
  2. Marque as caixas de seleção dos hosts a serem exportados.
  3. Clique em Exportar abaixo da lista.

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

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

Importando

Para importar hosts, faça o seguinte:

  1. Vá para Coleta de dadosHosts.
  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. Entidades (items, triggers, gráficos, etc.) herdadas dos templates desvinculados não serão removidas (a menos que a opção Excluir ausentes também seja selecionada para cada entidade).

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

Formato de exportação

Formato de exportação em YAML:

zabbix_export:
  version: '7.0'
  host_groups:
    - uuid: f2481361f99448eea617b7b1d4765566
      name: 'Discovered hosts'
    - uuid: 6f6799aa69e844b4b3918f779f2abf08
      name: 'Zabbix servers'
  hosts:
    - host: 'Zabbix server 1'
      name: 'Main Zabbix server'
      monitored_by: 'SERVER'
      templates:
        - name: 'Linux by Zabbix agent'
        - name: 'Zabbix server health'
      groups:
        - name: 'Discovered hosts'
        - name: 'Zabbix servers'
      interfaces:
        - ip: 192.168.1.1
          interface_ref: if1
      items:
        - name: 'Zabbix trap'
          type: TRAP
          key: trap
          delay: '0'
          history: 1w
          preprocessing:
            - type: MULTIPLIER
              parameters:
                - '8'
          tags:
            - tag: component
              value: 'raw'
          triggers:
            - expression: 'last(/Zabbix server 1/trap)=0'
              name: 'Último valor é zero'
              priority: WARNING
              tags:
                - tag: scope
                  value: 'availability'
      tags:
        - tag: service
          value: zabbix-server
      macros:
        - macro: '{$HOST.MACRO}'
          value: '123'
        - macro: '{$PASSWORD1}'
          type: SECRET_TEXT
      inventory:
        type: 'Zabbix server'
        name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
        os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
      inventory_mode: AUTOMATIC
  graphs:
    - name: 'Utilização de CPU do server'
      show_work_period: 'NO'
      show_triggers: 'NO'
      graph_items:
        - drawtype: FILLED_REGION
          color: FF5555
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,steal]'
        - sortorder: '1'
          drawtype: FILLED_REGION
          color: 55FF55
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,softirq]'
        - sortorder: '2'
          drawtype: FILLED_REGION
          color: '009999'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,interrupt]'
        - sortorder: '3'
          drawtype: FILLED_REGION
          color: '990099'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,nice]'
        - sortorder: '4'
          drawtype: FILLED_REGION
          color: '999900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,iowait]'
        - sortorder: '5'
          drawtype: FILLED_REGION
          color: '990000'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,system]'
        - sortorder: '6'
          drawtype: FILLED_REGION
          color: '000099'
          calc_fnc: MIN
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,user]'
        - sortorder: '7'
          drawtype: FILLED_REGION
          color: '009900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,idle]'

Elementos exportados

Os elementos exportados são explicados nas tabelas abaixo.

Elemento Tipo Descrição
version string (obrigatório) Versão do Zabbix.
host_groups (obrigatório) Elemento raiz para grupos de hosts.
uuid string (obrigatório) Identificador único para este grupo de hosts.
name string (obrigatório) Nome do grupo de hosts.
hosts Elemento raiz para hosts.

Hosts

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

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

Interfaces do host

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

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

Itens do host

Element Type Description
name string (required) 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 (required for SNMP_AGENT items) ID do objeto SNMP.
key string (required) 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 (required for SSH and TELNET items) 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 (required for SSH and TELNET items) 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 (required for SSH items) Nome do arquivo da chave pública.
privatekey string (required for SSH items) 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 (required) 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 de valores do item.
step Elemento raiz para etapas de pré-processamento de valores de itens do host.
interface_ref string Referência à interface do host (formato: if<N>).
jmx_endpoint string Endpoint JMX.
Suportado para itens JMX.
master_item (required for DEPENDENT items) Elemento raiz para o item mestre do item dependente.
key string (required) 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 Timeouts.
url string (required for HTTP_AGENT items) String de URL.
query_fields Elemento raiz para parâmetros de consulta.
Suportado para itens HTTP_AGENT.
name string (required for HTTP_AGENT items) 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 (required for ITEM_TYPE_SCRIPT and ITEM_TYPE_BROWSER items) 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 obrigató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, padrão), YES (1).
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 (required for HTTP_AGENT items) Nome do cabeçalho.
value string (required for HTTP_AGENT items) 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 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 (required) Nome da tag.
value string Valor da tag.
triggers Elemento raiz para triggers de itens do host.

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

Etapas de pré-processamento do valor do item do host
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)/(tempo atual - tempo 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 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 erro.

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

Triggers de item do host
Element Type Description
uuid string (required) Identificador único para este trigger.
expression string (required) 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 Nome da tag a ser usada para correlação de eventos.
name string (required) 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 (required) Nome do trigger de dependência.
expression string (required) 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 (required) Nome da tag.
value string Valor da tag.

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

Regras de descoberta em baixo nível de host

A maioria dos elementos das regras de descoberta em baixo nível de host é a mesma que a dos itens de host. A tabela abaixo descreve os elementos que diferem dos itens de host.

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 host.
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 host, que são os mesmos que os de itens de host.
trigger_prototypes Elemento raiz para elementos de protótipo de trigger de host, que são os mesmos que os de triggers de item de host.
graph_prototypes Elemento raiz para protótipos de gráfico de host, que são os mesmos que os de gráficos de host.
host_prototypes Elemento raiz para protótipos de host, 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 os 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 do valor do item de host, 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, que são os mesmos que os de filtros de regras de descoberta em baixo nível de host.
operations Elemento raiz para operações de substituição da regra de descoberta em baixo nível de host.

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 host
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 na qual realizar a verificação.
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 exclusivo 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 da regra de descoberta em baixo nível de host
Element Type Description
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 da 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 item prototype após a operação de substituição.
history string Período de armazenamento do histórico definido para o item prototype após a operação de substituição.
trends string Período de armazenamento de tendências definido para o item prototype após a operação de substituição.
severity string Severidade do trigger prototype 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 host prototype após a operação de substituição.
name string (obrigatório) Nome do template.
inventory_mode string Modo de inventário do host prototype definido após a operação de substituição.

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

Cenários web do host

Elemento Tipo Descrição
uuid string (obrigatório) Identificador exclusivo para este cenário web.
name string (obrigatório) Nome do cenário web.
delay string Frequência (usando segundos, sufixo de tempo ou macro de usuário) de execução do cenário web.
Padrão: 1m.
attempts integer O número de tentativas para executar as etapas do cenário web.
Valores possíveis: 1-10 (padrão: 1).
agent string Agent do cliente. O Zabbix irá simular ser o navegador selecionado.
Isso é ú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 do 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 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 host.
tags Elemento raiz para tags do cenário web.
tag string (obrigatório) Nome da tag.
value string Valor da tag.

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

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

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

Gráficos do host

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

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

Itens do gráfico do host
Element < Type Description
sortorder < integer Ordem de desenho. O valor menor é desenhado primeiro. Pode ser usado para desenhar linhas ou regiões atrás (ou na frente) de outra.
drawtype < string Estilo de desenho do item do gráfico.
Suportado para gráficos NORMAL.
Valores possíveis:1 SINGLE_LINE (0, padrão), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color < string Cor do elemento (6 símbolos, hexadecimal).
yaxisside < string Lado do gráfico onde a escala Y do item do gráfico será desenhada.
Suportado para gráficos NORMAL e STACKED.

Valores possíveis:1 LEFT (0, padrão), RIGHT (1).
calc_fnc < string Dados a serem desenhados se existir mais de um valor para um item.
Valores possíveis:1 MIN (1), AVG (2, padrão), MAX (4), ALL (7; mínimo, média e máximo; suportado para gráficos simples), LAST (9, suportado para gráficos de pizza/explodidos).
type < string Tipo do item do gráfico.
Valores possíveis:1 SIMPLE (0, padrão), GRAPH_SUM (2; o valor do item representa a pizza inteira; suportado para gráficos de pizza/explodidos).
item < (obrigatório) Item individual.
< host string (obrigatório) Host do item.
^ key string (obrigatório) Chave do item.

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

Mapas de valores do host

Element Type Description
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.

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.