- Objeto de regra de LLD
- Regra de LLD
- Filtro da regra LLD
- Caminho da macro LLD
- Pré-processamento da regra LLD
- Substituições da regra LLD
- Filtro de override da regra LLD
- Operação de substituição da regra LLD
- Status da operação de substituição da regra LLD
- Operação de substituição da regra LLD discover
- Período de operação da substituição da regra de LLD
- Histórico da operação de override da regra LLD
- Tendências da operação de override da regra LLD
- Severidade da operação de substituição da regra LLD
- Tag da operação de substituição da regra LLD
- Template de operação de substituição da regra LLD
- Inventário da operação de substituição da regra 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.
| Propriedade | Tipo | Descrição |
|---|---|---|
| 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, 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ó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 |
| interfaceid | ID | ID da interface de 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"- compatível 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. 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}, {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: - compatível 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: - compatível 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 ocorram 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: - compatível 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: - compatível 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: - compatível se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| ipmi_sensor | string | Sensor IPMI. Comportamento da propriedade: - obrigatório se type estiver definido como "IPMI agent" e key_ não estiver definido como "ipmi.get"- compatível 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: - compatível 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 recursão de até 3 itens dependentes e o número máximo de itens dependentes igual a 999 são permitidos. A regra de descoberta não pode ser o item mestre de outra regra de descoberta. Comportamento da propriedade: - obrigatório se type estiver definido como "Dependent item"- somente leitura para objetos herdados |
| output_format | integer | Define se a resposta deve ser convertida para JSON. Valores possíveis: 0 - (padrão) Armazenar como bruta; 1 - Converter para JSON. Comportamento da propriedade: - compatível 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ório se type estiver definido como "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"- somente leitura para objetos herdados (se type estiver definido como "Script" ou "Browser") |
| parameters | object/array | Parâmetros adicionais se type estiver definido como "Script" ou "Browser".Matriz de objetos com as propriedades name e value, em que name deve ser exclusivo.Comportamento da propriedade: - compatível 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- compatível se type estiver definido como "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"- somente leitura para objetos herdados (se type estiver definido como "HTTP agent") |
| post_type | integer | Tipo do corpo de dados de postagem armazenado na propriedade posts.Valores possíveis: 0 - (padrão) Dados brutos; 2 - Dados JSON; 3 - Dados XML. Comportamento da propriedade: - compatível 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órios se type estiver definido como "HTTP agent" e post_type estiver definido como "JSON data" ou "XML data"- compatíveis se type estiver definido como "HTTP agent" e post_type estiver definido como "Raw data"- somente leitura para objetos herdados |
| privatekey | string | Nome do arquivo de chave privada. Comportamento da propriedade: - obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "public key" |
| publickey | string | Nome do arquivo de chave pública. Comportamento da propriedade: - obrigatório se type estiver definido como "SSH agent" e authtype estiver definido como "public key" |
| query_fields | array | Matriz de campos de consulta que será enviada ao executar uma solicitação HTTP. Comportamento da propriedade: - compatível 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: - compatível 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: - compatível se type estiver definido como "HTTP agent"- somente leitura para objetos herdados |
| snmp_oid | string | OID SNMP. Comportamento da propriedade: - obrigatório se type estiver definido como "SNMP agent"- somente leitura para objetos herdados |
| ssl_cert_file | string | Caminho do arquivo da chave SSL pública. Comportamento da propriedade: - compatível 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: - compatível 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: - compatível 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 compatível. 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: - compatível 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) 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: - compatível 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: - compatível 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" |
| 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- compatível 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 já existentes. Gerado automaticamente se não for fornecido. Comportamento da propriedade: - compatível 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: - compatível 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: - compatível 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 da regra LLD
O objeto de filtro da regra LLD define um conjunto de condições que pode ser usado para filtrar objetos descobertos. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Conjunto de condições de filtro a serem usadas para filtrar os resultados. As condições serão ordenadas na sequência em que aparecem na fórmula. Comportamento da propriedade: - required |
| evaltype | integer | Método de avaliação da condição de filtro. Valores possíveis: 0 - And/Or; 1 - And; 2 - Or; 3 - Expressão personalizada. Comportamento da propriedade: - required |
| eval_formula | string | Expressão gerada que será usada para avaliar as condições de filtro. A expressão contém IDs que fazem referência a condições de filtro específicas por meio de seu formulaid. O valor de eval_formula é igual ao valor de formula para filtros com uma expressão personalizada.Comportamento da propriedade: - read-only |
| formula | string | Expressão definida pelo usuário a ser usada para avaliar 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 meio de seu formulaid. Os IDs usados na expressão devem corresponder exatamente aos definidos nas condições de filtro: nenhuma condição pode permanecer sem uso ou ser omitida.Comportamento da propriedade: - required se evaltype estiver definido como "custom expression" |
Condição de filtro da regra LLD
O objeto de condição de filtro da regra LLD define uma verificação separada a ser executada no valor de uma macro LLD. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| macro | string | Macro LLD na qual a verificação será executada. Property behavior: - required |
| value | string | Valor com o qual comparar. Property behavior: - required se operator estiver definido como "matches regular expression" ou "does not match regular expression" |
| formulaid | string | ID único arbitrário usado para referenciar a condição a partir de uma expressão personalizada. Pode conter apenas letras maiúsculas. O ID deve ser definido pelo usuário ao modificar condições de filtro, mas será gerado novamente ao solicitá-las posteriormente. Property behavior: - required se evaltype do LLD rule filter object estiver definido como "custom expression" |
| operator | integer | Operador da condição. Valores possíveis: 8 - (default) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Para entender melhor como usar filtros com vários tipos de expressões, consulte os 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 - XML XPath; 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 - Valor obtido por 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), "XML XPath" (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 "Valor obtido por 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 o valor; 2 - Definir um valor personalizado; 3 - Definir uma mensagem de erro personalizada. Comportamento da propriedade: - obrigatório se type estiver definido como "Expressão regular" (5), "XML XPath" (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 "Valor obtido por SNMP" (30) |
| error_handler_params | string | Parâmetros do manipulador de erros. Comportamento da propriedade: - obrigatório se error_handler estiver definido como "Definir um valor personalizado" ou "Definir uma 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 | 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 se há erro no JSON | caminho3 | 0, 1, 2, 3 | ||
| 17 | Verificar se há erro no XML | caminho3 | 0, 1, 2, 3 | ||
| 20 | Descartar se não houver alteração 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 pesquisa2 | substituição2 | ||
| 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 | Nome do campo2 | Prefixo do 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 obtido por 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 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 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 no formato "Nome do campo,Prefixo do OID,Formato", delimitados por um caractere de nova linha.
Substituições da regra LLD
O objeto de substituições da regra 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. Ele tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| name | string | Nome único da substituição. Property behavior: - required |
| step | integer | Número de ordem único da substituição. Property behavior: - required |
| stop | integer | Interrompe o processamento das próximas substituições se corresponder. Valores possíveis: 0 - (default) não interromper o processamento das substituições; 1 - interromper 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 override da regra LLD
O objeto de filtro de override da regra LLD define um conjunto de condições que, se corresponderem ao objeto descoberto, fazem com que o override seja aplicado. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Conjunto de condições de filtro de override a serem usadas para corresponder aos objetos descobertos. As condições serão ordenadas na sequência em que aparecem na fórmula. Comportamento da propriedade: - required |
| evaltype | integer | Método de avaliação da condição do filtro de override. Valores possíveis: 0 - And/Or; 1 - And; 2 - Or; 3 - Expressão personalizada. Comportamento da propriedade: - required |
| eval_formula | string | Expressão gerada que será usada para avaliar as condições do filtro de override. A expressão contém IDs que fazem referência a condições específicas do filtro de override por meio de formulaid. O valor de eval_formula é igual ao valor de formula para filtros com expressão personalizada.Comportamento da propriedade: - read-only |
| formula | string | Expressão definida pelo usuário a ser usada para avaliar as condições dos filtros de override com expressão personalizada. A expressão deve conter IDs que façam referência a condições específicas do filtro de override por meio de formulaid. Os IDs usados na expressão devem corresponder exatamente aos definidos nas condições do filtro de override: nenhuma condição pode permanecer sem uso ou ser omitida.Comportamento da propriedade: - required se evaltype estiver definido como "custom expression" |
Condição de filtro de substituição da regra LLD
O objeto de condição de filtro de substituição da regra LLD define uma verificação separada a ser executada no valor de uma macro LLD. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| macro | string | Macro LLD a ser verificada. Property behavior: - required |
| value | string | Valor com o qual comparar. Property behavior: - required se operator estiver definido como "matches regular expression" ou "does not match regular expression" |
| formulaid | string | ID único arbitrário usado para referenciar a condição a partir de uma expressão personalizada. Pode conter apenas letras maiúsculas. O ID deve ser definido pelo usuário ao modificar as condições de filtro, mas será gerado novamente ao solicitá-las posteriormente. Property behavior: - required se evaltype do LLD rule override filter object estiver definido como "custom expression" |
| operator | integer | Operador da condição. Valores possíveis: 8 - (default) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Operação de substituição da regra LLD
A operação de substituição da regra LLD é uma combinação de condições e ações a serem executadas no objeto protótipo. Ela possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| operationobject | integer | Tipo de objeto descoberto no qual executar a ação. Valores possíveis: 0 - protótipo de item; 1 - protótipo de trigger; 2 - protótipo de gráfico; 3 - protótipo de host. Comportamento da propriedade: - required |
| operator | integer | Operador da condição de substituição operator. Valores possíveis: 0 - (padrão) igual a; 1 - não é igual a; 2 - contém; 3 - não contém; 8 - corresponde a; 9 - não corresponde a. |
| 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 da operação de substituição (intervalo de atualizaçã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 definido para o objeto descoberto. Ele tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| status | integer | Substitui o status do objeto selecionado. Valores possíveis: 0 - Criar habilitado; 1 - Criar desabilitado. Property behavior: - required |
Operação de substituição da regra LLD discover
A operação de substituição da regra LLD discover status que é definida para o objeto descoberto. Ela tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| discover | integer | Substitui o status de discover para o objeto selecionado. Valores possíveis: 0 - Sim, continuar descobrindo os objetos; 1 - Não, novos objetos não serão descobertos e os existentes serão marcados como perdidos. Comportamento da propriedade: - required |
Período de operação da substituição da regra de LLD
O período de operação da substituição da regra de LLD é um valor de intervalo de atualização definido para o item descoberto. Ele tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| delay | string | Substitui o intervalo de atualização do protótipo de item. Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Os intervalos personalizados podem ser uma combinação de intervalos flexíveis e de agendamento.Aceita macros de usuário ou macros de LLD (o suporte a macros de LLD foi restaurado no Zabbix 7.0.27). 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 da operação de override da regra LLD
Valor do histórico da operação de override da regra LLD que é definido para o item descoberto. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| history | string | Sobrescreve o histórico do item prototype, que é uma unidade de tempo de quanto tempo os dados de histórico devem ser armazenados. Também aceita macro de usuário e macro LLD (o suporte a macro LLD foi restaurado no Zabbix 7.0.27). Property behavior: - required |
Tendências da operação de override da regra LLD
Valor da operação de override da regra LLD definido para o item descoberto. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| trends | string | Substitui as tendências do prototype de item, que é uma unidade de tempo de por quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário e macro LLD (o suporte a macro LLD foi restaurado no Zabbix 7.0.27). Property behavior: - required |
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. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| severity | integer | Substitui a severidade do protótipo de trigger. Valores possíveis: 0 - (default) não classificado; 1 - informação; 2 - aviso; 3 - média; 4 - alta; 5 - desastre. Property behavior: - required |
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. |
Template de operação de substituição da regra LLD
Objeto de template de operação de substituição da regra LLD que está vinculado ao host descoberto. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| templateid | ID | Substitui o template dos templates vinculados ao protótipo de host. Property behavior: - required |
Inventário da operação de substituição da regra LLD
Valor do modo de inventário da operação de substituição da regra LLD que é definido para o host descoberto. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| inventory_mode | integer | Substitui o modo de inventário do protótipo de host. Valores possíveis: -1 - desativado; 0 - (padrão) manual; 1 - automático. Comportamento da propriedade: - obrigatório |