- Objeto de regra de LLD
- Regra LLD
- Filtro da regra de 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 de LLD
- Operação de substituição da regra LLD discover
- Período da operação de override da regra 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 override da regra LLD
Objeto de regra de LLD
Os seguintes objetos estão diretamente relacionados à API discoveryrule.
Regra LLD
O objeto de regra de descoberta de baixo nível possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| itemid | ID | ID da regra LLD. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| delay | string | Intervalo de atualização da regra LLD. Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m, 2h, 1d) e, opcionalmente, um ou mais intervalos personalizados, todos separados por ponto e vírgula. Os intervalos personalizados podem ser uma mistura de intervalos flexíveis e de agendamento. Aceita macros de usuário. Se usado, o valor deve ser uma única macro. Múltiplas macros ou macros misturadas com texto não são suportadas. Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Exemplo: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Comportamento da propriedade: - obrigatório se type for definido como "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), ou se type for definido como "Zabbix agent (active)" (7) e key_ não contiver "mqtt.get" |
| hostid | ID | ID do host ao qual a regra LLD pertence. Comportamento da propriedade: - 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 protótipo. Comportamento da propriedade: - somente leitura |
| interfaceid | ID | ID da interface do host da regra LLD. Comportamento da propriedade: - obrigatório se a regra LLD pertencer ao host e type for definido como "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"- suportado se a regra LLD pertencer ao host e type for definido como "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent" |
| key_ | string | Chave da regra LLD. Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| name | string | Nome da regra LLD. Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| type | integer | Tipo da regra LLD. Valores possíveis: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 16 - JMX agent; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser; 23 - Nested. Este tipo é permitido apenas se o pai da regra for um template (presume-se que esteja vinculado a um protótipo de host na descoberta) ou host descoberto (que possui uma regra LLD em sua raiz). Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| url | string | String de URL. Suporta macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}. Comportamento da propriedade: - obrigatório se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| allow_traps | integer | Permitir popular valor de forma semelhante ao item trapper. Valores possíveis: 0 - (padrão) Não permitir aceitar dados recebidos; 1 - Permitir aceitar dados recebidos. Comportamento da propriedade: - suportado se type for definido como "HTTP agent" |
| authtype | integer | Método de autenticação. Valores possíveis se type for definido como "SSH agent":0 - (padrão) senha; 1 - chave pública. Valores possíveis se type for definido como "HTTP agent":0 - (padrão) nenhum; 1 - básico; 2 - NTLM; 3 - Kerberos; 4 - Digest. Comportamento da propriedade: - suportado se type for definido como "SSH agent" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| description | string | Descrição da regra LLD. |
| error | string | Texto de erro se houver problemas ao atualizar o valor da regra LLD. Comportamento da propriedade: - somente leitura |
| follow_redirects | integer | Seguir redirecionamentos de resposta ao coletar dados. Valores possíveis: 0 - Não seguir redirecionamentos; 1 - (padrão) Seguir redirecionamentos. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| headers | array | Array de cabeçalhos que serão enviados ao executar uma solicitação HTTP. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| http_proxy | string | String de conexão do proxy HTTP(S). Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ipmi_sensor | string | Sensor IPMI. Comportamento da propriedade: - obrigatório se type for definido como "IPMI agent" e key_ não for definido como "ipmi.get"- suportado se type for definido como "IPMI agent"- somente leitura para objetos herdados |
| jmx_endpoint | string | String de conexão personalizada do JMX agent. Padrão: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Comportamento da propriedade: - suportado se type for definido como "JMX agent" |
| lifetime | string | Período de tempo após o qual os itens que não são mais descobertos serão excluídos. Aceita segundos, unidade de tempo com sufixo ou uma macro de usuário. Padrão: 7d. |
| lifetime_type | integer | Cenário para excluir recursos LLD perdidos. Valores possíveis: 0 - (padrão) Excluir após atingir o limite de tempo de vida; 1 - Não excluir; 2 - Excluir imediatamente. |
| enabled_lifetime | string | Período de tempo após o qual os itens que não são mais descobertos serão desabilitados. Aceita segundos, unidade de tempo com sufixo ou uma macro de usuário. Padrão: 0. |
| enabled_lifetime_type | integer | Cenário para desabilitar recursos LLD perdidos. Valores possíveis: 0 - Desabilitar após atingir o limite de tempo de vida; 1 - Não desabilitar; 2 - (padrão) Desabilitar imediatamente. |
| master_itemid | ID | ID do item mestre. A regra de descoberta não pode ser item mestre para outra regra de descoberta. Comportamento da propriedade: - obrigatório se type for definido como "Dependent item"- somente leitura para objetos herdados |
| output_format | integer | Se a resposta deve ser convertida para JSON. Valores possíveis: 0 - (padrão) Armazenar bruto; 1 - Converter para JSON. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| params | string | Parâmetros adicionais dependendo do tipo da regra LLD: - script executado para regras LLD SSH e Telnet; - consulta SQL para regras LLD de monitor de banco de dados; - fórmula para regras LLD calculadas; - o script para regras LLD de script e browser. Comportamento da propriedade: - obrigatório se type for definido como "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"- somente leitura para objetos herdados (se type for definido como "Script" ou "Browser") |
| parameters | object/array | Parâmetros adicionais se type for definido como "Script" ou "Browser".Array de objetos com propriedades name e value, onde name deve ser único.Comportamento da propriedade: - suportado se type for definido como "Script" ou "Browser"- somente leitura para objetos herdados |
| password | string | Senha para autenticação. Comportamento da propriedade: - obrigatório se type for definido como "JMX agent" e username for definido- suportado se type for definido como "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| post_type | integer | Tipo de corpo de dados post armazenado na propriedade posts.Valores possíveis: 0 - (padrão) Dados brutos; 2 - Dados JSON; 3 - Dados XML. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| posts | string | Dados do corpo da solicitação HTTP(S). Comportamento da propriedade: - obrigatório se type for definido como "HTTP agent" e post_type for definido como "JSON data" ou "XML data"- suportado se type for definido como "HTTP agent" e post_type for definido como "Raw data"- somente leitura para objetos herdados |
| privatekey | string | Nome do arquivo de chave privada. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent" e authtype for definido como "public key" |
| publickey | string | Nome do arquivo de chave pública. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent" e authtype for definido como "public key" |
| query_fields | array | Array de campos de consulta que serão enviados ao executar uma solicitação HTTP. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| request_method | integer | Tipo de método de solicitação. Valores possíveis: 0 - (padrão) GET; 1 - POST; 2 - PUT; 3 - HEAD. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| retrieve_mode | integer | Qual parte da resposta deve ser armazenada. Valores possíveis se request_method for definido como "GET", "POST" ou "PUT":0 - (padrão) Corpo; 1 - Cabeçalhos; 2 - Corpo e cabeçalhos serão armazenados. Valores possíveis se request_method for definido como "HEAD":1 - Cabeçalhos. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| snmp_oid | string | SNMP OID. Comportamento da propriedade: - obrigatório se type for definido como "SNMP agent"- somente leitura para objetos herdados |
| ssl_cert_file | string | Caminho do arquivo de chave pública SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_file | string | Caminho do arquivo de chave privada SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| ssl_key_password | string | Senha para o arquivo de chave SSL. Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| state | integer | Estado da regra LLD. Valores possíveis: 0 - (padrão) normal; 1 - não suportado. Comportamento da propriedade: - somente leitura |
| status | integer | Status da regra LLD. Valores possíveis: 0 - (padrão) regra LLD habilitada; 1 - regra LLD desabilitada. |
| status_codes | string | Intervalos de códigos de status HTTP necessários, separados por vírgulas. Também suporta macros de usuário como parte da lista separada por vírgulas. Exemplo: 200,200-{$M},{$M},200-400 Comportamento da propriedade: - suportado se type for definido como "HTTP agent"- somente leitura para objetos herdados |
| templateid | ID | ID da regra LLD do template pai. Comportamento da propriedade: - somente leitura |
| timeout | string | Tempo limite da solicitação de coleta de dados do item. Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m). Também aceita macros de usuário. Faixa de valores possíveis: 1-600s. Padrão: "" - usar configurações do proxy/globais. Comportamento da propriedade: - suportado se type for definido como "Zabbix agent" (0), "Simple check" (3) e key_ não começar com "vmware." e "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) e snmp_oid começar com "walk[" ou "get[", "Script" (21), "Browser" (22)- somente leitura para objetos herdados |
| trapper_hosts | string | Hosts permitidos. Comportamento da propriedade: - suportado se type for definido como "Zabbix trapper", ou se type for definido como "HTTP agent" e allow_traps for definido como "Allow to accept incoming data" |
| username | string | Nome de usuário para autenticação. Comportamento da propriedade: - obrigatório se type for definido como "SSH agent", "TELNET agent", ou se type for definido como "JMX agent" e password for definido- suportado se type for definido como "Simple check", "Database monitor" ou "HTTP agent"- somente leitura para objetos herdados (se type for definido como "HTTP agent") |
| uuid | string | Identificador único universal, usado para vincular regras LLD importadas a regras já existentes. Gerado automaticamente, se não fornecido. Comportamento da propriedade: - suportado se a regra 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. Comportamento da propriedade: - suportado se type for 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. Comportamento da propriedade: - suportado se type for 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 de LLD
O objeto de filtro da regra de LLD define um conjunto de condições que podem ser usadas 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 de acordo com sua posição na fórmula. Comportamento da propriedade: - required |
| evaltype | integer | Método de avaliação das condições 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 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 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 "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 executada no valor de uma macro LLD. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| macro | string | Macro LLD na qual executar a verificação. 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) 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 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.
| Property | Type | Description |
|---|---|---|
| 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 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 de walk SNMP; 29 - Walk SNMP para JSON; 30 - Valor de get SNMP. Property behavior: - required |
| params | string | Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere de nova linha (\n). Property behavior: - required 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 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 de walk SNMP" (28), "Walk SNMP para JSON" (29) ou "Valor de get SNMP" (30) |
| error_handler | integer | Tipo de ação usado em caso de falha na 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. Property behavior: - required 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 erro em JSON" (16), "Verificar erro em XML" (17), "Prometheus para JSON" (23), "CSV para JSON" (24), "XML para JSON" (27), "Valor de walk SNMP" (28), "Walk SNMP para JSON" (29) ou "Valor de get SNMP" (30) |
| error_handler_params | string | Parâmetros do manipulador de erro. Property behavior: - required se error_handler estiver 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.
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 5 | Expressão regular | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | 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 erro em JSON | path3 | 0, 1, 2, 3 | ||
| 17 | Verificar erro em XML | path3 | 0, 1, 2, 3 | ||
| 20 | Descartar inalterado com heartbeat | seconds4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus para JSON | pattern5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV para JSON | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Substituir | string de pesquisa2 | substituição2 | ||
| 27 | XML para JSON | 0, 1, 2, 3 | |||
| 28 | Valor de walk SNMP | OID2 | Format: 0 - Inalterado 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Inteiro de BITS |
0, 1, 2, 3 | |
| 29 | Walk SNMP para JSON7 | Nome do campo2 | Prefixo OID2 | Format: 0 - Inalterado 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Inteiro de BITS |
0, 1, 2, 3 |
| 30 | Valor de get SNMP | Format: 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:
<metric name>{<label name>="<label value>", ...} == <value>. Cada
componente do padrão Prometheus (nome da 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 "Field name,OID prefix,Format" 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 exclusivo da substituição. Property behavior: - required |
| step | integer | Número de ordem exclusivo da substituição. Property behavior: - required |
| stop | integer | Interrompe o processamento das próximas substituições se houver correspondência. Valores possíveis: 0 - (default) não interrompe o processamento das substituições; 1 - interrompe o processamento das substituições se o filtro corresponder. |
| filter | object | Filtro da substituição. |
| operations | object/array | Operações da 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, aplicam o override. Ele possui as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Conjunto de condições do 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 seu 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 para ser usada na avaliação das condições de 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 seu 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 if evaltype is set to "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 na qual executar a verificação. 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 objeto de filtro de substituição da regra LLD estiver definido como "custom expression" |
| operator | integer | Operador da condição. Valores possíveis: 8 - (default) corresponde à expressão regular; 9 - não corresponde à expressão regular; 12 - existe; 13 - não existe. |
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 - Item prototype; 1 - Trigger prototype; 2 - Graph prototype; 3 - Host prototype; 4 - Discovery prototype. Comportamento da propriedade: - required |
| operator | integer | Operador da condição de substituição. Valores possíveis: 0 - (padrão) igual a; 1 - diferente de; 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 item, trigger, graph ou host prototype, dependendo do objeto selecionado. |
| opstatus | object | Objeto de status da operação de substituição para objetos item, trigger e host prototype. |
| 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 o objeto item prototype. |
| ophistory | object | Objeto de histórico da operação de substituição para o objeto item prototype. |
| optrends | object | Objeto de tendências da operação de substituição para o objeto item prototype. |
| opseverity | object | Objeto de severidade da operação de substituição para o objeto trigger prototype. |
| optag | object/array | Objeto de tag da operação de substituição para objetos trigger e host prototype. |
| optemplate | object/array | Objeto de template da operação de substituição para o objeto host prototype. |
| opinventory | object | Objeto de inventário da operação de substituição para o objeto host prototype. |
Status da operação de substituição da regra de LLD
Status da operação de substituição da regra de LLD que é 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. Comportamento da propriedade: - 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 possui 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 da operação de override da regra LLD
O período da operação de override 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 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 combinação de intervalos flexíveis e de agendamento. Aceita macros de usuário ou macros LLD (o suporte a macros LLD foi restaurado no Zabbix 7.4.11). 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}Comportamento da propriedade: - required |
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.4.11). Property behavior: - required |
Tendências da operação de override da regra LLD
Valor de tendências da operação de override da regra LLD que é definido para o item descoberto. Ele tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| trends | string | Substitui as tendências do item prototype, 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 (o suporte a macro LLD foi restaurado no Zabbix 7.4.11). 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 prototype 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 override da regra LLD
Valor do modo de inventário da operação de override 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: - required |