Objeto de protótipo de regra de LLD

Os seguintes objetos estão diretamente relacionados à API discoveryruleprototype.

Protótipo de regra de LLD

O objeto de protótipo de regra de descoberta de baixo nível tem as seguintes propriedades.

Property Type Description
itemid ID ID do protótipo de regra de LLD.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
ruleid ID ID da regra de LLD/protótipo de regra de LLD pai.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de criação
delay string Intervalo de atualização do protótipo de regra de LLD.

Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Os intervalos personalizados podem ser uma combinação de intervalos flexíveis e de agendamento.

Aceita macros de usuário. Quando usada, o valor deve ser uma única macro. Não há suporte para várias macros ou macros combinadas com texto. Os intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Exemplo:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Comportamento da propriedade:
- obrigatório se type estiver definido como "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), ou se type estiver definido como "Zabbix agent (active)" (7) e key_ não contiver "mqtt.get"
hostid ID ID do host ao qual o protótipo de regra de LLD pertence.

Comportamento da propriedade:
- constante
- obrigatório para operações de criação
flags integer Origem do protótipo de regra de LLD.

Valores possíveis:
3 - um protótipo de regra de descoberta de baixo nível;
7 - um protótipo de regra de descoberta de baixo nível descoberto.

Comportamento da propriedade:
- somente leitura
interfaceid ID ID da interface do host do protótipo de regra de LLD.

Comportamento da propriedade:
- obrigatório se o protótipo de regra de LLD pertencer a um host e type estiver definido como "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"
- com suporte se o protótipo de regra de LLD pertencer a um host e type estiver definido como "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent"
key_ string Chave do protótipo de regra de LLD. É necessária pelo menos uma macro de LLD.

Comportamento da propriedade:
- obrigatório para operações de criação
- somente leitura para objetos herdados
name string Nome do protótipo de regra de LLD.

Comportamento da propriedade:
- obrigatório para operações de criação
- somente leitura para objetos herdados
type integer Tipo do protótipo de regra de LLD.

Valores possíveis:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - Simple check;
5 - Zabbix internal;
7 - Zabbix agent (active);
10 - External check;
11 - Database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
16 - JMX agent;
18 - Dependent item;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser;
23 - Nested.

Comportamento da propriedade:
- obrigatório para operações de criação
- somente leitura para objetos herdados
url string String de URL.
Oferece suporte a macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Comportamento da propriedade:
- obrigatório se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
allow_traps integer Permite preencher o valor de forma semelhante ao item trapper.

Valores possíveis:
0 - (padrão) Não permitir aceitar dados recebidos;
1 - Permitir aceitar dados recebidos.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
authtype integer Método de autenticação.

Valores possíveis se type estiver definido como "SSH agent":
0 - (padrão) senha;
1 - chave pública.

Valores possíveis se type estiver definido como "HTTP agent":
0 - (padrão) nenhum;
1 - básico;
2 - NTLM.

Comportamento da propriedade:
- com suporte se type estiver definido como "SSH agent" ou "HTTP agent"
- somente leitura para objetos herdados (se type estiver definido como "HTTP agent")
description string Descrição do protótipo de regra de LLD.
error string Texto do erro caso haja problemas ao atualizar o valor do protótipo de regra de LLD.

Comportamento da propriedade:
- somente leitura
follow_redirects integer Seguir redirecionamentos da resposta durante a coleta de dados.

Valores possíveis:
0 - Não seguir redirecionamentos;
1 - (padrão) Seguir redirecionamentos.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
headers array Matriz de cabeçalhos que será enviada ao executar uma solicitação HTTP.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
http_proxy string String de conexão do proxy HTTP(S).

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
ipmi_sensor string Sensor IPMI.

Comportamento da propriedade:
- obrigatório se type estiver definido como "IPMI agent" e key_ não estiver definido como "ipmi.get"
- com suporte se type estiver definido como "IPMI agent"
- somente leitura para objetos herdados
jmx_endpoint string String de conexão personalizada do JMX agent.

Padrão: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Comportamento da propriedade:
- com suporte se type estiver definido como "JMX agent"
lifetime string Período após o qual os itens que não forem mais descobertos serão excluídos. Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou uma macro de usuário.

Padrão: 7d.
lifetime_type integer Cenário para excluir recursos de LLD perdidos.

Valores possíveis:
0 - (padrão) Excluir após atingir o limite de tempo de vida;
1 - Não excluir;
2 - Excluir imediatamente.
enabled_lifetime string Período após o qual os itens que não forem mais descobertos serão desabilitados. Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou uma macro de usuário.

Padrão: 0.
enabled_lifetime_type integer Cenário para desabilitar recursos de LLD perdidos.

Valores possíveis:
0 - Desabilitar após atingir o limite de tempo de vida;
1 - Não desabilitar;
2 - (padrão) Desabilitar imediatamente.
master_itemid ID ID do item mestre.
A regra de descoberta não pode ser item mestre de outra regra de descoberta.

Comportamento da propriedade:
- obrigatório se type estiver definido como "Dependent item"
- somente leitura para objetos herdados
output_format integer Define se a resposta deve ser convertida em JSON.

Valores possíveis:
0 - (padrão) Armazenar como bruta;
1 - Converter em JSON.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
params string Parâmetros adicionais dependendo do tipo de protótipo de regra de LLD:
- script executado para regras de LLD SSH e Telnet;
- consulta SQL para regras de LLD de monitoramento de banco de dados;
- fórmula para regras de LLD calculadas;
- script para regras de LLD de script e navegador.

Comportamento da propriedade:
- obrigatório se type estiver definido como "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"
- somente leitura para objetos herdados (se type estiver definido como "Script" ou "Browser")
parameters object/array Parâmetros adicionais se type estiver definido como "Script" ou "Browser".
Matriz de objetos com as propriedades name e value, em que name deve ser exclusivo.

Comportamento da propriedade:
- com suporte se type estiver definido como "Script" ou "Browser"
- somente leitura para objetos herdados
password string Senha para autenticação.

Comportamento da propriedade:
- obrigatório se type estiver definido como "JMX agent" e username estiver definido
- com suporte se type estiver definido como "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"
- somente leitura para objetos herdados (se type estiver definido como "HTTP agent")
post_type integer Tipo do corpo de dados de postagem armazenado na propriedade posts.

Valores possíveis:
0 - (padrão) Dados brutos;
2 - Dados JSON;
3 - Dados XML.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
posts string Dados do corpo da solicitação HTTP(S).

Comportamento da propriedade:
- obrigatório se type estiver definido como "HTTP agent" e post_type estiver definido como "JSON data" ou "XML data"
- com suporte se type estiver definido como "HTTP agent" e post_type estiver definido como "Raw data"
- somente leitura para objetos herdados
privatekey string Nome do arquivo de chave privada.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "public key"
publickey string Nome do arquivo de chave pública.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "public key"
query_fields array Matriz de campos de consulta que será enviada ao executar uma solicitação HTTP.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
request_method integer Tipo do método de solicitação.

Valores possíveis:
0 - (padrão) GET;
1 - POST;
2 - PUT;
3 - HEAD.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
retrieve_mode integer Parte da resposta que deve ser armazenada.

Valores possíveis se request_method estiver definido como "GET", "POST" ou "PUT":
0 - (padrão) Corpo;
1 - Cabeçalhos;
2 - O corpo e os cabeçalhos serão armazenados.

Valores possíveis se request_method estiver definido como "HEAD":
1 - Cabeçalhos.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
snmp_oid string OID SNMP.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SNMP agent"
- somente leitura para objetos herdados
ssl_cert_file string Caminho do arquivo da chave pública SSL.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
ssl_key_file string Caminho do arquivo da chave privada SSL.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
ssl_key_password string Senha do arquivo de chave SSL.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
state integer Estado do protótipo de regra de LLD.

Valores possíveis:
0 - (padrão) normal;
1 - sem suporte.

Comportamento da propriedade:
- somente leitura
status integer Status do protótipo de regra de LLD.

Valores possíveis:
0 - (padrão) protótipo de regra de LLD habilitado;
1 - protótipo de regra de LLD desabilitado.
status_codes string Intervalos de códigos de status HTTP necessários, separados por vírgulas. Também oferece suporte a macros de usuário como parte da lista separada por vírgulas.

Exemplo: 200,200-{$M},{$M},200-400

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
templateid ID ID do protótipo de regra de LLD pai do template.

Comportamento da propriedade:
- somente leitura
timeout string Tempo limite da solicitação de coleta de dados do item.
Aceita um número de segundos (por exemplo, 1, 60, 300) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m). Também aceita macros de usuário.

O intervalo de valores possíveis é: 1-600s.

Padrão: "" - usar configurações do proxy/globais.

Comportamento da propriedade:
- com suporte se type estiver definido como "Zabbix agent" (0), "Simple check" (3) e key_ não começar com "vmware." e "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) e snmp_oid começar com "walk[" ou "get[", "Script" (21), "Browser" (22)
- somente leitura para objetos herdados
trapper_hosts string Hosts permitidos.

Comportamento da propriedade:
- com suporte se type estiver definido como "Zabbix trapper", ou se type estiver definido como "HTTP agent" e allow_traps estiver definido como "Allow to accept incoming data".
Se a propriedade for omitida, ela será definida automaticamente como a macro de usuário {$TRAPPER.ALLOWED_HOSTS} (valor padrão). Por padrão, {$TRAPPER.ALLOWED_HOSTS} é 127.0.0.1,::1.
Se a propriedade for definida como uma string vazia, as conexões recebidas serão negadas de todos os hosts.
username string Nome de usuário para autenticação.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SSH agent", "TELNET agent", ou se type estiver definido como "JMX agent" e password estiver definido
- com suporte se type estiver definido como "Simple check", "Database monitor" ou "HTTP agent"
- somente leitura para objetos herdados (se type estiver definido como "HTTP agent")
uuid string Identificador universal exclusivo, usado para vincular protótipos de regra de LLD importados aos já existentes. Gerado automaticamente se não for fornecido.

Comportamento da propriedade:
- com suporte se o protótipo de regra de LLD pertencer a um template
verify_host integer Define se o nome do host da conexão deve ser validado para corresponder ao nome no certificado do host.

Valores possíveis:
0 - (padrão) Não validar;
1 - Validar.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados
verify_peer integer Define se o certificado do host deve ser validado quanto à autenticidade.

Valores possíveis:
0 - (padrão) Não validar;
1 - Validar.

Comportamento da propriedade:
- com suporte se type estiver definido como "HTTP agent"
- somente leitura para objetos herdados

Cabeçalho HTTP

O objeto header possui as seguintes propriedades:

Propriedade Tipo Descrição
name string Nome do cabeçalho HTTP.

Comportamento da propriedade:
- obrigatório
value string Valor do cabeçalho.

Comportamento da propriedade:
- obrigatório

Campo de consulta HTTP

O objeto de campo de consulta define um nome e valor que são usados para especificar um parâmetro de URL. Ele possui as seguintes propriedades:

Propriedade Tipo Descrição
name string Nome do parâmetro.

Comportamento da propriedade:
- obrigatório
value string Valor do parâmetro.

Comportamento da propriedade:
- obrigatório

Filtro de protótipo de regra LLD

O objeto de filtro de protótipo de regra LLD define um conjunto de condições que podem ser usadas para filtrar objetos descobertos. Ele possui as seguintes propriedades:

Propriedade Tipo Descrição
conditions object/array Conjunto de condições de filtro a serem usadas para filtrar resultados. As condições serão classificadas na ordem de sua colocação na fórmula.

Comportamento da propriedade:
- obrigatório
evaltype integer Método de avaliação da condição de filtro.

Valores possíveis:
0 - E/Ou;
1 - E;
2 - Ou;
3 - Expressão personalizada.

Comportamento da propriedade:
- obrigatório
eval_formula string Expressão gerada que será usada para avaliar as condições do filtro. A expressão contém IDs que referenciam condições de filtro específicas por seu formulaid. O valor de eval_formula é igual ao valor de formula para filtros com uma expressão personalizada.

Comportamento da propriedade:
- somente leitura
formula string Expressão definida pelo usuário a ser usada para avaliar as condições de filtros com uma expressão personalizada. A expressão deve conter IDs que referenciem condições de filtro específicas por seu formulaid. Os IDs usados na expressão devem corresponder exatamente aos definidos nas condições do filtro: nenhuma condição pode permanecer não utilizada ou omitida.

Comportamento da propriedade:
- obrigatório se evaltype estiver definido como "expressão personalizada"

Condição de filtro de protótipo de regra LLD

O objeto de condição de filtro de protótipo de regra LLD define uma verificação separada a ser realizada no valor de uma macro LLD. Possui as seguintes propriedades:

Propriedade Tipo Descrição
macro string Macro LLD para realizar a verificação.

Comportamento da propriedade:
- obrigatório
value string Valor para comparar.

Comportamento da propriedade:
- obrigatório se operator estiver definido como "corresponde à expressão regular" ou "não corresponde à expressão regular"
formulaid string ID único arbitrário usado para referenciar a condição a partir de uma 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.

Comportamento da propriedade:
- obrigatório se evaltype do objeto de filtro de protótipo de regra LLD estiver definido como "expressão personalizada"
operator integer Operador de condição.

Valores possíveis:
8 - (padrão) corresponde à expressão regular;
9 - não corresponde à expressão regular;
12 - existe;
13 - não existe.

Para entender melhor como usar filtros com vários tipos de expressões, consulte exemplos nas páginas dos métodos discoveryruleprototype.get e discoveryruleprototype.create.

Caminho da macro LLD

O caminho da macro LLD possui as seguintes propriedades:

Propriedade Tipo Descrição
lld_macro string Macro LLD.

Comportamento da propriedade:
- obrigatório
path string Seletor para o valor que será atribuído à macro correspondente.

Comportamento da propriedade:
- obrigatório

Pré-processamento do protótipo de regra LLD

O objeto de pré-processamento do protótipo de regra LLD tem as seguintes propriedades.

Property Type Description
type integer O tipo da opção de pré-processamento.

Valores possíveis:
5 - Expressão regular;
11 - XPath XML;
12 - JSONPath;
14 - Corresponde à expressão regular;
15 - Não corresponde à expressão regular;
16 - Verificar se há erro no JSON;
17 - Verificar se há erro no XML;
20 - Descartar valor inalterado com heartbeat;
21 - JavaScript;
23 - Prometheus para JSON;
24 - CSV para JSON;
25 - Substituir;
27 - XML para JSON;
28 - Valor de SNMP walk;
29 - SNMP walk para JSON;
30 - Obter valor via SNMP.

Comportamento da propriedade:
- required
params string Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere de nova linha (\n).

Comportamento da propriedade:
- required se type estiver definido como "Expressão regular" (5), "XPath XML" (11), "JSONPath" (12), "Corresponde à expressão regular" (14), "Não corresponde à expressão regular" (15), "Verificar se há erro no JSON" (16), "Verificar se há erro no XML" (17), "Descartar valor inalterado com heartbeat" (20), "JavaScript" (21), "Prometheus para JSON" (23), "CSV para JSON" (24), "Substituir" (25), "Valor de SNMP walk" (28), "SNMP walk para JSON" (29) ou "Obter valor via SNMP" (30)
error_handler integer Tipo de ação usado em caso de falha da etapa de pré-processamento.

Valores possíveis:
0 - A mensagem de erro é definida pelo Zabbix server;
1 - Descartar valor;
2 - Definir valor personalizado;
3 - Definir mensagem de erro personalizada.

Comportamento da propriedade:
- required se type estiver definido como "Expressão regular" (5), "XPath XML" (11), "JSONPath" (12), "Corresponde à expressão regular" (14), "Não corresponde à expressão regular" (15), "Verificar se há erro no JSON" (16), "Verificar se há erro no XML" (17), "Prometheus para JSON" (23), "CSV para JSON" (24), "XML para JSON" (27), "Valor de SNMP walk" (28), "SNMP walk para JSON" (29) ou "Obter valor via SNMP" (30)
error_handler_params string Parâmetros do manipulador de erros.

Comportamento da propriedade:
- required se error_handler estiver definido como "Definir valor personalizado" ou "Definir mensagem de erro personalizada"

Os parâmetros e manipuladores de erros a seguir são compatíveis com cada tipo de pré-processamento.

Preprocessing type Name Parameter 1 Parameter 2 Parameter 3 Supported error handlers
5 Expressão regular pattern1 output2 0, 1, 2, 3
11 XPath XML path3 0, 1, 2, 3
12 JSONPath path3 0, 1, 2, 3
14 Corresponde à expressão regular pattern1 0, 1, 2, 3
15 Não corresponde à expressão regular pattern1 0, 1, 2, 3
16 Verificar se há erro no JSON path3 0, 1, 2, 3
17 Verificar se há erro no XML path3 0, 1, 2, 3
20 Descartar valor inalterado com heartbeat seconds4, 5
21 JavaScript script2
23 Prometheus para JSON pattern5, 6 0, 1, 2, 3
24 CSV para JSON character2 character2 0,1 0, 1, 2, 3
25 Substituir search string2 replacement2
27 XML para JSON 0, 1, 2, 3
28 Valor de SNMP walk OID2 Formato:
0 - Inalterado
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Inteiro de BITS		 0, 1, 2, 3
29 SNMP walk para JSON7 Field name2 OID prefix2 Formato:
0 - Inalterado
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Inteiro de BITS		 0, 1, 2, 3
30 Obter valor via SNMP Formato:
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Inteiro de BITS		 0, 1, 2, 3

1 expressão regular
2 string
3 JSONPath ou XPath XML
4 inteiro positivo (com suporte a sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)
5 macro de usuário
6 padrão do Prometheus seguindo a sintaxe: <metric name>{<label name>="<label value>", ...} == <value>. Cada componente do padrão do Prometheus (métrica, nome do label, valor do label e valor da métrica) pode ser uma macro de usuário.
7 Compatível com vários registros "Field name,OID prefix,Format" delimitados por um caractere de nova linha.

Substituições de protótipo de regra de LLD

O objeto de substituições de protótipo de regra de LLD define um conjunto de regras (filtros, condições e operações) que são usadas para substituir propriedades de diferentes objetos de protótipo. Possui as seguintes propriedades:

Propriedade Tipo Descrição
name string Nome único da substituição.

Comportamento da propriedade:
- obrigatório
step integer Número de ordem único da substituição.

Comportamento da propriedade:
- obrigatório
stop integer Parar o processamento das próximas substituições se corresponder.

Valores possíveis:
0 - (padrão) não para o processamento das substituições;
1 - para o processamento das substituições se o filtro corresponder.
filter object Filtro de substituição.
operations object/array Operações de substituição.

Filtro de substituição de protótipo de regra LLD

O objeto de filtro de substituição de protótipo de regra LLD define um conjunto de condições que, se corresponderem ao objeto descoberto, a substituição será aplicada. Ele possui as seguintes propriedades:

Propriedade Tipo Descrição
conditions object/array Conjunto de condições de filtro de substituição a serem usadas para corresponder aos objetos descobertos. As condições serão classificadas na ordem de sua colocação na fórmula.

Comportamento da propriedade:
- obrigatório
evaltype integer Método de avaliação da condição de filtro de substituição.

Valores possíveis:
0 - E/Ou;
1 - E;
2 - Ou;
3 - Expressão personalizada.

Comportamento da propriedade:
- obrigatório
eval_formula string Expressão gerada que será usada para avaliar as condições do filtro de substituição. A expressão contém IDs que referenciam condições específicas do filtro de substituição por seu formulaid. O valor de eval_formula é igual ao valor de formula para filtros com uma expressão personalizada.

Comportamento da propriedade:
- somente leitura
formula string Expressão definida pelo usuário a ser usada para avaliar as condições dos filtros de substituição com uma expressão personalizada. A expressão deve conter IDs que referenciem condições específicas do filtro de substituição por seu formulaid. Os IDs usados na expressão devem corresponder exatamente aos definidos nas condições do filtro de substituição: nenhuma condição pode permanecer não utilizada ou omitida.

Comportamento da propriedade:
- obrigatório se evaltype estiver definido como "expressão personalizada"
Condição de filtro de substituição de protótipo de regra LLD

O objeto de condição de filtro de substituição de protótipo de regra LLD define uma verificação separada a ser realizada no valor de uma macro LLD. Possui as seguintes propriedades:

Propriedade Tipo Descrição
macro string Macro LLD para realizar a verificação.

Comportamento da propriedade:
- obrigatório
value string Valor para comparar.

Comportamento da propriedade:
- obrigatório se operator estiver definido como "corresponde à expressão regular" ou "não corresponde à expressão regular"
formulaid string ID exclusivo arbitrário usado para referenciar a condição a partir de uma 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.

Comportamento da propriedade:
- obrigatório se evaltype do objeto de filtro de substituição de protótipo de regra LLD estiver definido como "expressão personalizada"
operator integer Operador da condição.

Valores possíveis:
8 - (padrão) corresponde à expressão regular;
9 - não corresponde à expressão regular;
12 - existe;
13 - não existe.

Operação de sobrescrição de protótipo de regra LLD

A operação de sobrescrição de protótipo de regra LLD é uma combinação de condições e ações a serem realizadas no objeto protótipo. Possui as seguintes propriedades:

Propriedade Tipo Descrição
operationobject integer Tipo de objeto descoberto para executar a ação.

Valores possíveis:
0 - Protótipo de item;
1 - Protótipo de trigger;
2 - Protótipo de gráfico;
3 - Protótipo de host.

Comportamento da propriedade:
- obrigatório
operator integer Operador da condição de sobrescrição.

Valores possíveis:
0 - (padrão) igual;
1 - diferente;
2 - contém;
3 - não contém;
8 - corresponde;
9 - não corresponde.
value string Padrão para corresponder ao nome do protótipo de item, trigger, gráfico ou host, dependendo do objeto selecionado.
opstatus object Objeto de status de operação de sobrescrição para objetos de protótipo de item, trigger e host.
opdiscover object Objeto de status de descoberta de operação de sobrescrição (todos os tipos de objeto).
opperiod object Objeto de período de operação de sobrescrição (intervalo de atualização) para objeto de protótipo de item.
ophistory object Objeto de histórico de operação de sobrescrição para objeto de protótipo de item.
optrends object Objeto de tendências de operação de sobrescrição para objeto de protótipo de item.
opseverity object Objeto de severidade de operação de sobrescrição para objeto de protótipo de trigger.
optag object/array Objeto de tag de operação de sobrescrição para objetos de protótipo de trigger e host.
optemplate object/array Objeto de template de operação de sobrescrição para objeto de protótipo de host.
opinventory object Objeto de inventário de operação de sobrescrição para objeto de protótipo de host.
Status da operação de sobrescrição da regra LLD

Status da operação de sobrescrição da regra LLD que é definida para o objeto descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
status integer Sobrescreve o status para o objeto selecionado.

Valores possíveis:
0 - Criar habilitado;
1 - Criar desabilitado.

Comportamento da propriedade:
- obrigatório
Operação de descoberta de protótipo de regra LLD de substituição

Status de descoberta da operação de substituição de protótipo de regra LLD que é definido para o objeto descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
discover integer Substitui o status de descoberta para o objeto selecionado.

Valores possíveis:
0 - Sim, continue descobrindo os objetos;
1 - Não, novos objetos não serão descobertos e os existentes serão marcados como perdidos.

Comportamento da propriedade:
- obrigatório
Período de operação de substituição do protótipo de regra de LLD

O período de operação de substituição do protótipo de regra de LLD é um valor de intervalo de atualização definido para o item descoberto. Ele tem as seguintes propriedades:

Property Type Description
delay string Substitui o intervalo de atualização do protótipo de item.

Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Os intervalos personalizados podem ser uma combinação de intervalos flexíveis e de agendamento.

Aceita macros de usuário ou macros de LLD. Quando usado, o valor deve ser uma única macro. Não há suporte para várias macros ou macros combinadas com texto. Os intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Exemplo:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Comportamento da propriedade:
- obrigatório
Histórico de operação de sobrescrição de protótipo de regra LLD

Valor do histórico de operação de sobrescrição de protótipo de regra LLD que é definido para o item descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
history string Substitui o histórico do protótipo de item, que é uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Também aceita macro de usuário e macro LLD.

Comportamento da propriedade:
- obrigatório
Tendências de operação de substituição de protótipo de regra LLD

Valor de tendências de operação de substituição de protótipo de regra LLD que é definido para o item descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
trends string Substitui as tendências do protótipo de item, que é uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário e macro LLD.

Comportamento da propriedade:
- obrigatório
Severidade da operação de substituição do protótipo da regra LLD

Valor de severidade da operação de substituição do protótipo da regra LLD que é definido para o trigger descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
severity integer Substitui a severidade do protótipo de trigger.

Valores possíveis:
0 - (padrão) não classificado;
1 - informação;
2 - aviso;
3 - médio;
4 - alto;
5 - desastre.

Comportamento da propriedade:
- obrigatório
Tag de operação de substituição de protótipo de regra de LLD

O objeto de tag de operação de substituição de protótipo de regra de LLD contém o nome e o valor da tag que são definidos para o objeto descoberto. Ele possui as seguintes propriedades:

Propriedade Tipo Descrição
tag string Novo nome da tag.

Comportamento da propriedade:
- obrigatório
value string Novo valor da tag.
Template de operação de substituição de protótipo de regra LLD

Objeto de template de operação de substituição de protótipo de regra LLD que está vinculado ao host descoberto. Ele possui as seguintes propriedades:

Propriedade Tipo Descrição
templateid ID Substitui o template dos templates vinculados ao protótipo de host.

Comportamento da propriedade:
- obrigatório
Inventário de operação de substituição de protótipo de regra LLD

Valor do modo de inventário de operação de substituição de protótipo de regra LLD que é definido para o host descoberto. Possui as seguintes propriedades:

Propriedade Tipo Descrição
inventory_mode integer Substitui o modo de inventário do protótipo de host.

Valores possíveis:
-1 - desabilitado;
0 - (padrão) manual;
1 - automático.

Comportamento da propriedade:
- obrigatório