> Objeto protótipo de item

Os objetos a seguir estão diretamente relacionados à API itemprototype.

Protótipo de item

O objeto protótipo de item tem as seguintes propriedades.

|Propriedade|Tipo|Descrição| |--------|---------------------------------------- -----------|-----------| |itemid|string|(readonly) ID do protótipo do item.| |atraso
(obrigatório)|string|Intervalo de atualização do protótipo do item. Aceita segundos ou uma unidade de tempo com sufixo (30s,1m,2h,1d).
Opcionalmente, um ou mais intervalos personalizados podem ser especificados como intervalos flexíveis ou agendamento .
Vários intervalos são separados por um ponto e vírgula.
Macros de usuário e macros LLD podem ser usados. Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.
Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).
<br >Opcional para Zabbix trapper, itens dependentes e para Zabbix agent (ativo) com chave mqtt.get.| |hostid
(obrigatório)|string|ID do host ao qual o protótipo do item pertence.

Para operações de atualização, este campo é readonly.| |ruleid
(obrigatório)|string|ID da regra LLD à qual o item pertence.

Para operações de atualização, este campo é readonly.| |interfaceid
(obrigatório)|string|ID da interface do host do protótipo do item. Usado apenas para protótipos de itens de host.

Opcional para agente Zabbix (ativo), Zabbix interno, Zabbix trapper, item dependente, monitor de banco de dados e protótipos de itens calculados.| |chave_
(obrigatório)|string|Chave de protótipo do item.| |nome
(obrigatório)|string|Nome do protótipo do item.| |tipo
(obrigatório)|inteiro|Tipo do protótipo do item.

Valores possíveis:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - verificação simples;
5 - Zabbix interno;
7 - agente Zabbix (ativo);
10 - verificação externa;
11 - monitor de banco de dados;
12 - agente IPMI;
13 - Agente SSH;
14 - Agente TELNET;
15 - calculado;
16 - Agente JMX;
17 - Trap SNMP;
18 - Item dependente;
19 - HTTP agente;
20 - Agente SNMP;
21 - Script.| |url
(obrigatório)|string|string de URL necessária apenas para protótipos de item de agente HTTP. Suporta macros LLD, macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |valor_tipo
(obrigatório)|inteiro|Tipo de informação do protótipo do item.

Valores possíveis:
0 - número flutuante;
1 - caractere;< br>2 - log;
3 - numérico sem sinal;
4 - texto.| |allow_traps|integer|campo de protótipo de item do agente HTTP. Permitir preencher valor como no tipo de item trapper também.

0 - (padrão) Não permitir aceitar dados de entrada.
1 - Permitir aceitar dados de entrada.| |authtype|integer|Usado apenas por protótipos de item de agente SSH ou protótipos de item de agente HTTP.

Método de autenticação de agente SSH valores possíveis:
0 - (padrão) senha;
1 - chave pública .

Método de autenticação do agente HTTP valores possíveis:
0 - (padrão) nenhum
1 - básico
2 - NTLM
3 - Kerberos| |description|string|Descrição do protótipo do item.| |follow_redirects|integer|campo de protótipo de item do agente HTTP. Siga os redirecionamentos de resposta ao agrupar dados.

0 - Não siga os redirecionamentos.
1 - (padrão) Siga os redirecionamentos.| |headers|object|campo protótipo de item do agente HTTP. Objeto com cabeçalhos de solicitação HTTP(S), onde o nome do cabeçalho é usado como chave e o valor do cabeçalho como valor.

Exemplo:
{ "User-Agent": "Zabbix" }| |history|string|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.

Padrão: 90d.| |http_proxy|string|Campo de protótipo de item do agente HTTP. Cadeia de conexão do proxy HTTP(S).| |ipmi_sensor|string|sensor IPMI. Usado apenas por protótipos de itens do IPMI.| |jmx_endpoint|string|String de conexão personalizada do agente JMX.

Valor padrão:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT }/jmxrmi| |logtimefmt|string|Formato da hora nas entradas de log. Usado apenas por protótipos de itens de log.| |master_itemid|integer|ID do item mestre.
Recursão de até 3 itens dependentes e protótipos de item e contagem máxima de itens dependentes e protótipos de item igual a 29999 são permitidos.

Requerido por itens dependentes.| |output_format|integer|campo de protótipo de item do agente HTTP. A resposta deve ser convertida em JSON.

0 - (padrão) Armazenar raw.
1 - Converter em JSON.| |params|string|Parâmetros adicionais dependendo do tipo de protótipo de item:
- script executado para protótipos de itens SSH e Telnet;
- consulta SQL para protótipos de itens de monitor de banco de dados;
- fórmula para protótipos de itens calculados .| |parameters|array|Parâmetros adicionais para protótipos de itens de script. Matriz de objetos com propriedades 'nome' e 'valor', onde o nome deve ser exclusivo.| |senha|string|Senha para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, protótipos de item de agente JMX e HTTP.| |post_type|integer|campo de protótipo de item do agente HTTP. Tipo de corpo de dados de postagem armazenado na propriedade de postagens.

0 - (padrão) Dados brutos.
2 - Dados JSON.
3 - Dados XML.| |posts|string|campo de protótipo de item do agente HTTP. Dados do corpo da solicitação HTTP(S). Usado com post_type.| |privatekey|string|Nome do arquivo de chave privada.| |publickey|string|Nome do arquivo de chave pública.| |query_fields|array|campo de protótipo de item do agente HTTP. Parâmetros de consulta. Matriz de objetos com pares 'chave':'valor', onde valor pode ser uma string vazia.| |request_method|integer|campo de protótipo de item do agente HTTP. Tipo de método de solicitação.

0 - (padrão) GET
1 - POST
2 - PUT
3 - HEAD| |recuperar_modo|inteiro|campo protótipo de item do agente HTTP. Qual parte da resposta deve ser armazenada.

0 - (padrão) Corpo.
1 - Cabeçalhos.
2 - O corpo e os cabeçalhos serão armazenados.

Para request_method HEAD somente 1 é o valor permitido.| |snmp_oid|string|SNMP OID.| |ssl_cert_file|string|campo de protótipo de item do agente HTTP. Caminho do arquivo de chave SSL pública.| |ssl_key_file|string|campo de protótipo de item do agente HTTP. Caminho do arquivo de chave SSL privada.| |ssl_key_password|string|campo de protótipo de item do agente HTTP. Senha para arquivo de chave SSL.| |status|inteiro|Status do protótipo do item.

Valores possíveis:
0 - (padrão) protótipo do item ativado;
1 - protótipo do item desativado;
3 - item não suportado protótipo.| |status_codes|string|campo de protótipo de item do agente HTTP. Intervalos de códigos de status HTTP necessários separados por vírgulas. Também suporta macros de usuário ou macros LLD como parte da lista separada por vírgulas.

Exemplo: 200.200-{$M},{$M},200-400| |templateid|string|(somente leitura) ID do protótipo do item de modelo pai.| |timeout|string|Tempo limite da solicitação de sondagem de dados do item. Usado para protótipos de agente HTTP e item de script. Suporta macros de usuário e macros LLD.

padrão: 3s
valor máximo: 60s| |trapper_hosts|string|Hosts permitidos. Usado por protótipos de item de trapper ou protótipos de item HTTP.| |trends|string|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.

Padrão: 365d.| |unidades|string|Unidades de valor.| |username|string|Username para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, protótipos de item de agente JMX e HTTP.

Requerido por protótipos de item SSH e Telnet.| |uuid|string|Identificador único universal, usado para vincular protótipos de itens importados aos já existentes. Usado apenas para protótipos de itens em modelos. Gerado automaticamente, se não fornecido.

Para operações de atualização, este campo é somente leitura.| |valuemapid|string|ID do mapa de valores associado.| |verify_host|integer|campo de protótipo de item do agente HTTP. Validar o nome do host na URL está no campo Nome Comum ou em um campo Nome Alternativo do Assunto do certificado do host.

0 - (padrão) Não validar.
1 - Validar.
| |verify_peer|integer|campo de protótipo de item do agente HTTP. Validar é o certificado do host autêntico.

0 - (padrão) Não validar.
1 - Validar.| |discover|inteiro|Status de descoberta do protótipo do item.

Valores possíveis:
0 - (padrão) novos itens serão descobertos;
1 - novos itens não serão descobertos e os itens existentes serão ser marcado como perdido.|

Tag de protótipo de item

O objeto de tag de protótipo de item tem as seguintes propriedades.

|Propriedade|Tipo|Descrição| |--------|---------------------------------------- -----------|-----------| |tag
(obrigatório)|string|Nome da tag do protótipo do item.| |valor|string|Valor da tag de protótipo do item.|

Pré-processamento de protótipo de item

O objeto de pré-processamento de protótipo de item tem as seguintes propriedades.

|Propriedade|Tipo|Descrição| |--------|---------------------------------------- -----------|-----------| |tipo
(obrigatório)|inteiro|O tipo de opção de pré-processamento.

Valores possíveis:
1 - Multiplicador personalizado;
2 - Corte direito;
3 - Trim esquerdo;
4 - Trim;
5 - Correspondência de expressão regular;
6 - Booleano para decimal;
7 - Octal para decimal;
8 - Hexadecimal para decimal;
9 - Alteração simples;
10 - Alteração por segundo;
11 - XML XPath;
12 - JSONPath;
13 - No intervalo;
14 - Corresponde à expressão regular;
15 - Não corresponde à expressão regular;
16 - Verifique se há erro no JSON;
17 - Verifique se há erro no XML;
18 - Verifique se há erro usando a expressão regular;
19 - Descarte inalterado;<br >20 - Descartar inalterado com pulsação;
21 - JavaScript;
22 - Padrão Prometheus;
23 - Prometheus para JSON;
24 - CSV para JSON;
25 - Substituir;<br >26 - Verificação não suportada;
27 - XML para JSON.| |params
(obrigatório)|string|Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\n).| |error_handler
(obrigatório)|inteiro|Tipo de ação usado em caso de falha na etapa de pré-processamento.

Valores possíveis:
0 - Mensagem de erro é definida pelo servidor Zabbix;< br>1 - Descartar valor;
2 - Definir valor personalizado;
3 - Definir mensagem de erro personalizada.| |error_handler_params
(obrigatório)|string|Parâmetros do manipulador de erros. Usado com error_handler.

Deve estar vazio, se error_handler for 0 ou 1.
Pode estar vazio se, error_handler for 2.
Não pode estar vazio, se error_handler é 3.|

Os seguintes parâmetros e manipuladores de erros 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| |------------------|----|-----------|-----------|- ----------|------------------------| |1|Multiplicador personalizado|número^1,\6|<|<|0, 1, 2, 3| |2|Corte direito|lista de caracteres²|<|<|<| |3|Corte esquerdo|lista de caracteres²|<|<|<| |4|Cortar|lista de caracteres²|<|<|<| |5|Expressão regular|padrão³|saída²|<|0, 1, 2, 3| |6|Booleano para decimal|<|<|<|0, 1, 2, 3| |7|Octal para decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal para decimal|<|<|<|0, 1, 2, 3| |9|Mudança simples|<|<|<|0, 1, 2, 3| |10|Mudança por segundo|<|<|<|0, 1, 2, 3| |11|XML XPath|caminho⁴|<|<|0, 1, 2, 3| |12|JSONPath|caminho⁴|<|<|0, 1, 2, 3| |13|No intervalo|min^1, 6|max^1, 6|<|0, 1, 2, 3| |14|Corresponde à expressão regular|padrão³|<|<|0, 1, 2, 3| |15|Não corresponde à expressão regular|padrão³|<|<|0, 1, 2, 3| |16|Verifique se há erro em JSON|path⁴|<|<|0, 1, 2, 3| |17|Verificar erros em XML|path⁴|<|<|0, 1, 2, 3| |18|Verifique se há erro usando expressão regular|pattern³|output²|<|0, 1, 2, 3| |19|Descartar inalterado|<|<|<|<| |20|Descartar inalterado com pulsação|segundos^5, 6|<|<|<| |21|JavaScript|script²|<|<|<| |22|Padrão do Prometheus|padrão^6, 7|valor, rótulo, função|saída^8, 9|0, 1, 2, 3| |23|Prometheus para JSON|pattern^6,\7|<|<|0, 1, 2, 3| |24|CSV para JSON|caractere²|caractere²|0,1|0, 1, 2, 3| |25|Substituir|sequência de pesquisa²|substituição²|<|<| |26|Verificação não suportada|<|<|<|1, 2, 3| |27|XML para JSON|<|<|<|0, 1, 2, 3|

¹ número inteiro ou de ponto flutuante
² seqüência de caracteres
³ expressão regular
⁴ JSONPath ou XML XPath
⁵ inteiro positivo (com suporte de sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)
⁶ macro do usuário, macro LLD
⁷ Padrão do Prometheus seguindo a sintaxe: <nome da métrica>{<nome do rótulo>="<valor do rótulo>", ...} == <valor>. Cada Componente padrão do Prometheus (métrica, nome do rótulo, valor do rótulo e métrica value) pode ser macro de usuário ou macro LLD.
⁸ Saída do Prometheus seguindo a sintaxe: <label name> (pode ser uma macro de usuário ou uma macro LLD) se label for selecionado como o segundo parâmetro.
⁹ Uma das funções de agregação: sum, min, max, avg, count se function for selecionado como o segundo parâmetro.