> 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úmero1,\6 0, 1, 2, 3
2 Corte direito lista de caracteres2
3 Corte esquerdo lista de caracteres2
4 Cortar lista de caracteres2
5 Expressão regular padrão3 saída2 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 caminho4 0, 1, 2, 3
12 JSONPath caminho4 0, 1, 2, 3
13 No intervalo min1,\ 6 max1,\ 6 0, 1, 2, 3
14 Corresponde à expressão regular padrão3 0, 1, 2, 3
15 Não corresponde à expressão regular padrão3 0, 1, 2, 3
16 Verifique se há erro em JSON path4 0, 1, 2, 3
17 Verificar erros em XML path4 0, 1, 2, 3
18 Verifique se há erro usando expressão regular pattern3 output2 0, 1, 2, 3
19 Descartar inalterado
20 Descartar inalterado com pulsação segundos5,\ 6
21 JavaScript script2
22 Padrão do Prometheus padrão6,\ 7 valor, rótulo, função saída8,\ 9 0, 1, 2, 3
23 Prometheus para JSON pattern6,\7 0, 1, 2, 3
24 CSV para JSON caractere2 caractere2 0,1 0, 1, 2, 3
25 Substituir sequência de pesquisa2 substituição2
26 Verificação não suportada 1, 2, 3
27 XML para JSON 0, 1, 2, 3

1 número inteiro ou de ponto flutuante
2 seqüência de caracteres
3 expressão regular
4 JSONPath ou XML XPath
5 inteiro positivo (com suporte de sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)
6 macro do usuário, macro LLD
7 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.
8 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.
9 Uma das funções de agregação: sum, min, max, avg, count se function for selecionado como o segundo parâmetro.