- Objeto de regra de LLD
- Regra de LLD
- Filtro de regra LLD
- Caminho da macro LLD
- Pré-processamento da regra LLD
- Substituições de regras de LLD
- Filtro de substituição da regra LLD
- Operação de substituição de regra LLD
- Status da operação de substituição da regra LLD
- Operação de descoberta de substituição de regra LLD
- Período da operação de substituição da regra LLD
- Histórico de operação de sobrescrição de regra LLD
- Tendências de operação de substituição de regra LLD
- Severidade da operação de substituição da regra LLD
- Tag da operação de substituição da regra LLD
- Modelo de operação de substituição de regra LLD
- Inventário de operação de sobrescrição de regra de LLD
Objeto de regra de LLD
Os seguintes objetos estão diretamente relacionados à API discoveryrule.
Regra de LLD
O objeto de regra de descoberta de baixo nível tem as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID da regra de LLD. Comportamento da propriedade: - somente leitura - obrigatória para operações de atualização |
| delay | string | Intervalo de atualização da 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. Se usada, a propriedade deve conter 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ória 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 a regra de LLD pertence. Comportamento da propriedade: - constante - obrigatória para operações de criação |
| flags | integer | Origem da regra de descoberta. Valores possíveis: 1 - uma regra de descoberta de baixo nível; 5 - uma regra de descoberta de baixo nível convertida de um protótipo. Comportamento da propriedade: - somente leitura |
| interfaceid | ID | ID da interface do host da regra de LLD. Comportamento da propriedade: - obrigatória se a regra de LLD pertencer a um host e type estiver definido como "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"- com suporte se a 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 da regra de LLD. Comportamento da propriedade: - obrigatória para operações de criação - somente leitura para objetos herdados |
| name | string | Nome da regra de LLD. Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| type | integer | Tipo da 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. Esse tipo é permitido somente se o pai da regra for um template (que se presume estar vinculado a um protótipo de host na descoberta) ou um host descoberto (que tenha uma regra de LLD em sua raiz). Comportamento da propriedade: - obrigatória 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ória 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; 3 - Kerberos; 4 - Digest. 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 da regra de LLD. |
| error | string | Texto do erro caso haja problemas ao atualizar o valor da 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ória 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, 3600), um valor com um sufixo de tempo (por exemplo, 3600s, 180m, 24h, 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 um item mestre de outra regra de descoberta. Comportamento da propriedade: - obrigatória se type estiver definido como "Dependent item"- somente leitura para objetos herdados |
| output_format | integer | Define se a resposta deve ser convertida para JSON. Valores possíveis: 0 - (padrão) Armazenar como bruta; 1 - Converter para 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 da 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ória 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ória 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 dos 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ória 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 da chave privada. Comportamento da propriedade: - obrigatória se type estiver definido como "SSH agent" e authtype estiver definido como "public key" |
| publickey | string | Nome do arquivo da chave pública. Comportamento da propriedade: - obrigatória 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ória se type estiver definido como "SNMP agent"- somente leitura para objetos herdados |
| ssl_cert_file | string | Caminho do arquivo da chave SSL pública. 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 SSL privada. Comportamento da propriedade: - com suporte se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_password | string | Senha do arquivo da chave SSL. Comportamento da propriedade: - com suporte se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| state | integer | Estado da regra de LLD. Valores possíveis: 0 - (padrão) normal; 1 - sem suporte. Comportamento da propriedade: - somente leitura |
| status | integer | Status da regra de LLD. Valores possíveis: 0 - (padrão) regra de LLD habilitada; 1 - regra de LLD desabilitada. |
| status_codes | string | Intervalos de códigos de status HTTP necessários, separados por vírgulas. Também aceita 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 da regra de LLD do template pai. 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 as 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 regras de LLD importadas às regras já existentes. Gerado automaticamente se não for fornecido. Comportamento da propriedade: - com suporte se a regra de LLD pertencer a um template |
| verify_host | integer | Define se deve ser validado que o nome do host da conexão corresponde 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 deve ser validado que o certificado do host é autêntico. 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 é usado 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 regra LLD
O objeto de filtro de regra LLD define um conjunto de condições que podem ser usadas para filtrar objetos descobertos. 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 ordenadas 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 pelo 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 pelo 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 da regra LLD
O objeto de condição de filtro da 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 da 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. |
Para entender melhor como usar filtros com vários tipos de expressões, veja exemplos nas páginas dos métodos discoveryrule.get e discoveryrule.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 da regra LLD
O objeto de pré-processamento da regra LLD tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| 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 se não houver alteração com heartbeat; 21 - JavaScript; 23 - Prometheus para JSON; 24 - CSV para JSON; 25 - Substituir; 27 - XML para JSON; 28 - Valor da varredura SNMP; 29 - Varredura SNMP para JSON; 30 - Obter valor via SNMP. 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 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 se não houver alteração com heartbeat" (20), "JavaScript" (21), "Prometheus para JSON" (23), "CSV para JSON" (24), "Substituir" (25), "Valor da varredura SNMP" (28), "Varredura SNMP 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: - obrigatório 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 da varredura SNMP" (28), "Varredura SNMP para JSON" (29) ou "Obter valor via SNMP" (30) |
| error_handler_params | string | Parâmetros do manipulador de erros. Comportamento da propriedade: - obrigatório 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.
| Tipo de pré-processamento | Nome | Parâmetro 1 | Parâmetro 2 | Parâmetro 3 | Manipuladores de erros compatíveis |
|---|---|---|---|---|---|
| 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 se não houver alteração 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 da varredura SNMP | OID2 | Formato: 0 - Inalterado 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Inteiro de BITS |
0, 1, 2, 3 | |
| 29 | Varredura SNMP 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 "Nome do campo,Prefixo do OID,Registros de formato", delimitados por um caractere de nova linha.
Substituições de regras de LLD
O objeto de substituições de regras 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 parar o processamento das substituições; 1 - parar 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 da regra LLD
O objeto de filtro de substituição da 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 referenciam condições específicas do filtro de substituição pelo 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 pelo 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 regra LLD
O objeto de condição de filtro de substituição 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 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. |
Operação de substituição de regra LLD
A operação de substituição de regra LLD é uma combinação de condições e ações a serem realizadas no objeto protótipo. Ela possui as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| operationobject | integer | Tipo de objeto descoberto para realizar 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; 4 - Protótipo de descoberta. Comportamento da propriedade: - obrigatório |
| operator | integer | Operador da condição de substituiçã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 da operação de substituição para objetos protótipo de item, trigger e host. |
| opdiscover | object | Objeto de status de descoberta da operação de substituição (todos os tipos de objeto). |
| opperiod | object | Objeto de período (intervalo de atualização) da operação de substituição para objeto protótipo de item. |
| ophistory | object | Objeto de histórico da operação de substituição para objeto protótipo de item. |
| optrends | object | Objeto de tendências da operação de substituição para objeto protótipo de item. |
| opseverity | object | Objeto de severidade da operação de substituição para objeto protótipo de trigger. |
| optag | object/array | Objeto de tag da operação de substituição para objetos protótipo de trigger e host. |
| optemplate | object/array | Objeto de template da operação de substituição para objeto protótipo de host. |
| opinventory | object | Objeto de inventário da operação de substituição para objeto protótipo de host. |
Status da operação de substituição da regra LLD
Status da operação de substituição da regra LLD que é definida para o objeto descoberto. Possui as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| status | integer | Substitui 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 substituição de regra LLD
Status de descoberta da operação de substituição 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 da operação de substituição da regra LLD
O período da operação de substituição da regra 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 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 regra LLD
Valor do histórico de operação de sobrescrição 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 |
Tendências de operação de substituição de regra LLD
Valor de tendências de operação de substituição 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 da regra LLD
Valor de severidade da operação de substituição 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 da operação de substituição da regra LLD
O objeto tag da operação de substituição da regra LLD contém o nome e o valor da tag que são definidos para o objeto descoberto. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| tag | string | Novo nome da tag. Também aceita macro de usuário e macro LLD. Property behavior: - required |
| value | string | Novo valor da tag. Também aceita macro de usuário e macro LLD. |
Modelo de operação de substituição de regra LLD
Objeto de modelo de operação de substituição de regra LLD que está vinculado ao host descoberto. 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 sobrescrição de regra de LLD
Valor do modo de inventário da operação de sobrescrição de regra de LLD que é definido para o host descoberto. Possui as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| inventory_mode | integer | Sobrescreve 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 |