- Objeto de regra de LLD
- Regra de LLD
- Filtro de regra LLD
- Caminho da macro LLD
- Pré-processamento de 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 de 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 da regra de descoberta de baixo nível tem as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID da regra de LLD. Property behavior: - somente leitura - obrigatório para operações de atualização |
| delay | string | Intervalo de atualização da regra de 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. Várias 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}Property behavior: - 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 a regra de LLD pertence. Property behavior: - constante - obrigatório 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 prototype. Property behavior: - somente leitura |
| interfaceid | ID | ID da interface do host da regra de LLD. Property behavior: - obrigatório se a regra de LLD pertencer ao host e type estiver definido como "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"- suportado se a regra de LLD pertencer ao host e type estiver definido como "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent" |
| key_ | string | Chave da regra de LLD. Property behavior: - obrigatório para operações de criação - somente leitura para objetos herdados |
| name | string | Nome da regra de LLD. Property behavior: - 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 (presumido como vinculado a um host prototype na descoberta) ou um host descoberto (que possui uma regra de LLD em sua raiz). Property behavior: - 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}. Property behavior: - 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 de entrada; 1 - Permitir aceitar dados de entrada. Property behavior: - suportado 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. Property behavior: - suportado 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 de erro se houver problemas ao atualizar o valor da regra de LLD. Property behavior: - 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. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| headers | array | Matriz de headers que serão enviados ao executar uma solicitação HTTP. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| http_proxy | string | String de conexão do proxy HTTP(S). Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| ipmi_sensor | string | Sensor IPMI. Property behavior: - obrigatório se type estiver definido como "IPMI agent" e key_ não estiver definido como "ipmi.get"- suportado se type estiver definido como "IPMI agent"- somente leitura para objetos herdados |
| jmx_endpoint | string | String de conexão personalizada do agent JMX. Padrão: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Property behavior: - suportado se type estiver definido como "JMX agent" |
| lifetime | string | Período de tempo após o qual os itens que não forem 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 de LLD perdidos. Valores possíveis: 0 - (padrão) Excluir após o limite de lifetime ser atingido; 1 - Não excluir; 2 - Excluir imediatamente. |
| enabled_lifetime | string | Período de tempo após o qual os itens que não forem 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 de LLD perdidos. Valores possíveis: 0 - Desabilitar após o limite de lifetime ser atingido; 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. Property behavior: - obrigatório se type estiver 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. Property behavior: - suportado 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 monitor de banco de dados; - fórmula para regras de LLD calculadas; - o script para regras de LLD de script e browser. Property behavior: - 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 propriedades name e value, em que name deve ser único.Property behavior: - suportado se type estiver definido como "Script" ou "Browser"- somente leitura para objetos herdados |
| password | string | Senha para autenticação. Property behavior: - obrigatório se type estiver definido como "JMX agent" e username estiver definido- suportado 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. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| posts | string | Dados do corpo da solicitação HTTP(S). Property behavior: - obrigatório se type estiver definido como "HTTP agent" e post_type estiver definido como "Dados JSON" ou "Dados XML"- suportado se type estiver definido como "HTTP agent" e post_type estiver definido como "Dados brutos"- somente leitura para objetos herdados |
| privatekey | string | Nome do arquivo da chave privada. Property behavior: - obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "chave pública" |
| publickey | string | Nome do arquivo da chave pública. Property behavior: - obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "chave pública" |
| query_fields | array | Matriz de campos de consulta que serão enviados ao executar uma solicitação HTTP. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| request_method | integer | Tipo do método da solicitação. Valores possíveis: 0 - (padrão) GET; 1 - POST; 2 - PUT; 3 - HEAD. Property behavior: - suportado se type estiver 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 estiver definido como "GET", "POST" ou "PUT":0 - (padrão) Corpo; 1 - Headers; 2 - Corpo e headers serão armazenados. Valores possíveis se request_method estiver definido como "HEAD":1 - Headers. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| snmp_oid | string | OID SNMP. Property behavior: - obrigatório se type estiver definido como "SNMP agent"- somente leitura para objetos herdados |
| ssl_cert_file | string | Caminho do arquivo da chave SSL pública. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_file | string | Caminho do arquivo da chave SSL privada. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_password | string | Senha do arquivo da chave SSL. Property behavior: - suportado 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 - não suportado. Property behavior: - 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 dos códigos de status HTTP necessários, separados por vírgulas. Também suporta macros de usuário como parte de uma lista separada por vírgulas. Exemplo: 200,200-{$M},{$M},200-400 Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| templateid | ID | ID da regra de LLD do template pai. Property behavior: - 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. Intervalo de valores possíveis: 1-600s. Padrão: "" - usar configurações do proxy/globais. Property behavior: - suportado 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. Property behavior: - suportado se type estiver definido como "Zabbix trapper", ou se type estiver definido como "HTTP agent" e allow_traps estiver definido como "Permitir aceitar dados de entrada".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, conexões de entrada serão negadas de todos os hosts. |
| username | string | Nome de usuário para autenticação. Property behavior: - obrigatório se type estiver definido como "SSH agent", "TELNET agent" ou se type estiver definido como "JMX agent" e password estiver definido- suportado 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 único universal, usado para vincular regras de LLD importadas às já existentes. Gerado automaticamente, se não for fornecido. Property behavior: - suportado se a regra de LLD pertencer a um template |
| verify_host | integer | Se deve validar que 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. Property behavior: - suportado se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| verify_peer | integer | Se deve validar que o certificado do host é autêntico. Valores possíveis: 0 - (padrão) Não validar; 1 - Validar. Property behavior: - suportado 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 de regra LLD
O objeto de pré-processamento 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 vários registros "Nome do campo,Prefixo OID,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 de operação de substituição da regra LLD
O período de operação de substituição da 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 usadas, 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 |
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 |