Os seguintes objetos estão diretamente relacionados à API discoveryruleprototype.
O objeto protótipo de regra de descoberta de baixo nível possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| itemid | ID | ID do protótipo de regra LLD. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| ruleid | ID | ID da regra LLD/rule LLD protótipo 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 LLD. Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m, 2h, 1d) e, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Intervalos personalizados podem ser uma mistura de intervalos flexíveis e de agendamento. Aceita macros de usuário. Se usado, o valor deve ser uma única macro. Múltiplas macros ou macros misturadas com texto não são suportadas. 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 for 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 for 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 LLD pertence. Comportamento da propriedade: - constante - obrigatório para operações de criação |
| flags | integer | Origem do protótipo de regra 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 LLD. Comportamento da propriedade: - obrigatório se o protótipo de regra LLD pertencer ao host e type for definido como "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"- suportado se o protótipo de regra LLD pertencer ao host e type for definido como "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent" |
| key_ | string | Chave do protótipo de regra LLD. Pelo menos uma macro LLD é obrigatória. Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| name | string | Nome do protótipo de regra 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 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. Suporta 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 for definido como "HTTP agent"- somente leitura para objetos herdados |
| allow_traps | integer | Permitir popular 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: - suportado se type for definido como "HTTP agent" |
| authtype | integer | Método de autenticação. Valores possíveis se type for definido como "SSH agent":0 - (padrão) senha; 1 - chave pública. Valores possíveis se type for definido como "HTTP agent":0 - (padrão) nenhum; 1 - básico; 2 - NTLM. Comportamento da propriedade: - suportado se type for definido como "SSH agent" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| description | string | Descrição do protótipo de regra LLD. |
| error | string | Texto de erro se houver problemas ao atualizar o valor do protótipo de regra LLD. Comportamento da propriedade: - somente leitura |
| follow_redirects | integer | Seguir redirecionamentos de resposta ao coletar dados. Valores possíveis: 0 - Não seguir redirecionamentos; 1 - (padrão) Seguir redirecionamentos. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| headers | array | Array de cabeçalhos que serão enviados ao executar uma solicitação HTTP. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| http_proxy | string | String de conexão do proxy HTTP(S). Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ipmi_sensor | string | Sensor IPMI. Comportamento da propriedade: - obrigatório se type for definido como "IPMI agent" e key_ não for definido como "ipmi.get"- suportado se type for definido como "IPMI agent"- somente leitura para objetos herdados |
| jmx_endpoint | string | String de conexão personalizada do Java gateway. Padrão: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Comportamento da propriedade: - suportado se type for definido como "JMX agent" |
| lifetime | string | Período de tempo após o qual os itens que não são mais descobertos serão excluídos. Aceita segundos, unidade de tempo com sufixo ou uma macro de usuário. Padrão: 7d. |
| lifetime_type | integer | Cenário para excluir recursos 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 de tempo após o qual os itens que não são mais descobertos serão desabilitados. Aceita segundos, unidade de tempo com sufixo ou uma macro de usuário. Padrão: 0. |
| enabled_lifetime_type | integer | Cenário para desabilitar recursos 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 para outra regra de descoberta. Comportamento da propriedade: - obrigatório se type for definido como "Dependent item"- somente leitura para objetos herdados |
| output_format | integer | Se a resposta deve ser convertida para JSON. Valores possíveis: 0 - (padrão) Armazenar bruto; 1 - Converter para JSON. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| params | string | Parâmetros adicionais dependendo do tipo do protótipo de regra LLD: - script executado para regras LLD SSH e Telnet; - consulta SQL para regras LLD de monitoramento de banco de dados; - fórmula para regras LLD calculadas; - o script para regras LLD de script e browser. Comportamento da propriedade: - obrigatório se type for definido como "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"- somente leitura para objetos herdados (se type for definido como "Script" ou "Browser") |
| parameters | object/array | Parâmetros adicionais se type for definido como "Script" ou "Browser".Array de objetos com propriedades name e value, onde name deve ser único.Comportamento da propriedade: - suportado se type for definido como "Script" ou "Browser"- somente leitura para objetos herdados |
| password | string | Senha para autenticação. Comportamento da propriedade: - obrigatório se type for definido como "JMX agent" e username estiver definido- suportado se type for definido como "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| post_type | integer | Tipo de corpo de dados post armazenado na propriedade posts.Valores possíveis: 0 - (padrão) Dados brutos; 2 - Dados JSON; 3 - Dados XML. Comportamento da propriedade: - suportado se type for 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 for definido como "HTTP agent" e post_type for definido como "JSON data" ou "XML data"- suportado se type for definido como "HTTP agent" e post_type for definido como "Raw data"- somente leitura para objetos herdados |
| privatekey | string | Nome do arquivo de chave privada. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent" e authtype for definido como "public key" |
| publickey | string | Nome do arquivo de chave pública. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent" e authtype for definido como "public key" |
| query_fields | array | Array de campos de consulta que serão enviados ao executar uma solicitação HTTP. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| request_method | integer | Tipo de método de solicitação. Valores possíveis: 0 - (padrão) GET; 1 - POST; 2 - PUT; 3 - HEAD. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| retrieve_mode | integer | Qual parte da resposta deve ser armazenada. Valores possíveis se request_method for definido como "GET", "POST" ou "PUT":0 - (padrão) Corpo; 1 - Cabeçalhos; 2 - Corpo e cabeçalhos serão armazenados. Valores possíveis se request_method for definido como "HEAD":1 - Cabeçalhos. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| snmp_oid | string | OID SNMP. Comportamento da propriedade: - obrigatório se type for definido como "SNMP agent"- somente leitura para objetos herdados |
| ssl_cert_file | string | Caminho do arquivo de chave pública SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_file | string | Caminho do arquivo de chave privada SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_password | string | Senha para o arquivo de chave SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| state | integer | Estado do protótipo de regra LLD. Valores possíveis: 0 - (padrão) normal; 1 - não suportado. Comportamento da propriedade: - somente leitura |
| status | integer | Status do protótipo de regra LLD. Valores possíveis: 0 - (padrão) protótipo de regra LLD habilitado; 1 - protótipo de regra LLD desabilitado. |
| status_codes | string | Intervalos de códigos de status HTTP necessários, separados por vírgulas. Também suporta macros de usuário como parte da lista separada por vírgulas. Exemplo: 200,200-{$M},{$M},200-400 Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| templateid | ID | ID do protótipo de regra LLD do template pai. Comportamento da propriedade: - somente leitura |
| timeout | string | Tempo limite da solicitação de coleta de dados do item. Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m). Também aceita macros de usuário. Faixa de valores possível: 1-600s. Padrão: "" - usar configurações do proxy/globais. Comportamento da propriedade: - suportado se type for 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: - suportado se type for definido como "Zabbix trapper", ou se type for definido como "HTTP agent" e allow_traps for definido como "Permitir aceitar dados recebidos" |
| username | string | Nome de usuário para autenticação. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent", "TELNET agent", ou se type for definido como "JMX agent" e password estiver definido- suportado se type for definido como "Simple check", "Database monitor" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| uuid | string | Identificador único universal, usado para vincular protótipos de regra LLD importados aos já existentes. Gerado automaticamente, se não fornecido. Comportamento da propriedade: - suportado se o protótipo de regra LLD pertencer a um template |
| verify_host | integer | Se deve validar se o nome do host para a conexão corresponde ao do certificado do host. Valores possíveis: 0 - (padrão) Não validar; 1 - Validar. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| verify_peer | integer | Se deve validar se o certificado do host é autêntico. Valores possíveis: 0 - (padrão) Não validar; 1 - Validar. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
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 |
O objeto de campo de consulta define um nome e valor que são usados para especificar um parâmetro de URL. 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 |
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 fazem referência a 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 fazem referência a 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" |
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 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 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, veja exemplos nas páginas dos métodos discoveryruleprototype.get e discoveryruleprototype.create.
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 |
O objeto de pré-processamento de protótipo de regra LLD possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| type | integer | O tipo de opção de pré-processamento. Valores possíveis: 5 - Expressão regular; 11 - XML XPath; 12 - JSONPath; 14 - Corresponde à expressão regular; 15 - Não corresponde à expressão regular; 16 - Verificar erro em JSON; 17 - Verificar erro em XML; 20 - Descartar inalterado com heartbeat; 21 - JavaScript; 23 - Prometheus para JSON; 24 - CSV para JSON; 25 - Substituir; 27 - XML para JSON; 28 - Valor SNMP walk; 29 - SNMP walk para JSON; 30 - Valor SNMP get. Comportamento da propriedade: - obrigatório |
| 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: - obrigatório se type for definido como "Expressão regular" (5), "XML XPath" (11), "JSONPath" (12), "Corresponde à expressão regular" (14), "Não corresponde à expressão regular" (15), "Verificar erro em JSON" (16), "Verificar erro em XML" (17), "Descartar inalterado com heartbeat" (20), "JavaScript" (21), "Prometheus para JSON" (23), "CSV para JSON" (24), "Substituir" (25), "Valor SNMP walk" (28), "SNMP walk para JSON" (29) ou "Valor SNMP get" (30) |
| error_handler | integer | Tipo de ação usada em caso de falha na etapa de pré-processamento. Valores possíveis: 0 - Mensagem de erro definida pelo Zabbix server; 1 - Descartar valor; 2 - Definir valor personalizado; 3 - Definir mensagem de erro personalizada. Comportamento da propriedade: - obrigatório se type for definido como "Expressão regular" (5), "XML XPath" (11), "JSONPath" (12), "Corresponde à expressão regular" (14), "Não corresponde à expressão regular" (15), "Verificar erro em JSON" (16), "Verificar erro em XML" (17), "Prometheus para JSON" (23), "CSV para JSON" (24), "XML para JSON" (27), "Valor SNMP walk" (28), "SNMP walk para JSON" (29) ou "Valor SNMP get" (30) |
| error_handler_params | string | Parâmetros do manipulador de erro. Comportamento da propriedade: - obrigatório se error_handler for definido como "Definir valor personalizado" ou "Definir mensagem de erro personalizada" |
Os seguintes parâmetros e manipuladores de erro são suportados para cada tipo de pré-processamento.
| Tipo de pré-processamento | Nome | Parâmetro 1 | Parâmetro 2 | Parâmetro 3 | Manipuladores de erro suportados |
|---|---|---|---|---|---|
| 5 | Expressão regular | padrão1 | saída2 | 0, 1, 2, 3 | |
| 11 | XML XPath | caminho3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | caminho3 | 0, 1, 2, 3 | ||
| 14 | Corresponde à expressão regular | padrão1 | 0, 1, 2, 3 | ||
| 15 | Não corresponde à expressão regular | padrão1 | 0, 1, 2, 3 | ||
| 16 | Verificar erro em JSON | caminho3 | 0, 1, 2, 3 | ||
| 17 | Verificar erro em XML | caminho3 | 0, 1, 2, 3 | ||
| 20 | Descartar inalterado com heartbeat | segundos4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus para JSON | padrão5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV para JSON | caractere2 | caractere2 | 0,1 | 0, 1, 2, 3 |
| 25 | Substituir | string de busca2 | substituição2 | ||
| 27 | XML para JSON | 0, 1, 2, 3 | |||
| 28 | Valor 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 | Nome do campo2 | Prefixo OID2 | Formato: 0 - Inalterado 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Inteiro de BITS |
0, 1, 2, 3 |
| 30 | Valor SNMP get | 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 XML XPath
4 inteiro positivo (com suporte a sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)
5 macro de usuário
6 padrão Prometheus seguindo a sintaxe: <nome da métrica>{<nome do rótulo>="<valor do rótulo>", ...} == <valor>. Cada componente do padrão Prometheus (métrica, nome do rótulo, valor do rótulo e valor da métrica) pode ser macro de usuário.
7 Suporta múltiplos registros "Nome do campo,Prefixo OID,Formato" delimitados por um caractere de nova linha.
O objeto de substituições de protótipos de regras LLD define um conjunto de regras (filtros, condições e operações) que são usadas para substituir propriedades de diferentes objetos de protótipos. Ele 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. |
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 é aplicada. 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 do 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 fazem referência a 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 fazem referência a 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" |
O objeto de condição de filtro de sobrescriçã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 ú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 sobrescriçã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. |
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 - Item prototype; 1 - Trigger prototype; 2 - Graph prototype; 3 - Host prototype. 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 item, trigger, gráfico ou protótipo de host, dependendo do objeto selecionado. |
| opstatus | object | Objeto de status da operação de sobrescrição para objetos de item, trigger e protótipo de host. |
| opdiscover | object | Objeto de status de descoberta da operação de sobrescrição (todos os tipos de objeto). |
| opperiod | object | Objeto de período da operação de sobrescrição (intervalo de atualização) para objeto de protótipo de item. |
| ophistory | object | Objeto de histórico da operação de sobrescrição para objeto de protótipo de item. |
| optrends | object | Objeto de tendências da operação de sobrescrição para objeto de protótipo de item. |
| opseverity | object | Objeto de severidade da operação de sobrescrição para objeto de protótipo de trigger. |
| optag | object/array | Objeto de tag da operação de sobrescrição para objetos de protótipo de trigger e host. |
| optemplate | object/array | Objeto de template da operação de sobrescrição para objeto de protótipo de host. |
| opinventory | object | Objeto de inventário da operação de sobrescrição para objeto de protótipo de host. |
Status da operação de sobrescrição do protótipo da regra LLD que é definido para o objeto descoberto. Ele 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 |
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 |
O período de operação de substituição do protótipo de regra LLD é um valor de intervalo de atualização que é definido para o item descoberto. Possui as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| delay | string | Substitui o intervalo de atualização do protótipo de item. Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m, 2h, 1d) e, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Os intervalos personalizados podem ser uma mistura de intervalos flexíveis e de agendamento. Aceita macros de usuário ou macros LLD. Se usado, o valor deve ser uma única macro. Múltiplas macros ou macros misturadas com texto não são suportadas. 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 |
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 | Sobrescreve 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 |
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 |
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édia; 4 - alta; 5 - desastre. Comportamento da propriedade: - obrigatório |
O objeto de tag de operação de substituição de protótipo de regra 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. |
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 | Substitua o template dos templates vinculados ao protótipo de host. Comportamento da propriedade: - obrigatório |
O valor do modo de inventário da operação de substituição do protótipo da 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 |