Objeto proxy

Os seguintes objetos estão diretamente relacionados à API de proxy.

Proxy

O objeto proxy tem as seguintes propriedades.

Property Type Description
proxyid ID ID do proxy.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
name string Nome do proxy.

Comportamento da propriedade:
- obrigatório para operações de criação
proxy_groupid ID ID do grupo de proxies.

0 - o proxy não está atribuído a nenhum grupo de proxies.
local_address string Endereço para agents ativos. Endereço IP ou nome DNS ao qual se conectar.

Comportamento da propriedade:
- obrigatório se proxy_groupid não for 0
local_port string Número da porta local do proxy à qual se conectar.

Macros de usuário são compatíveis.

Padrão: 10051.

Comportamento da propriedade:
- compatível se proxy_groupid não for 0
operating_mode integer Tipo de proxy.

Valores possíveis:
0 - proxy ativo;
1 - proxy passivo.

Comportamento da propriedade:
- obrigatório para operações de criação
description text Descrição do proxy.
lastaccess timestamp Momento em que o proxy se conectou pela última vez ao server.

Comportamento da propriedade:
- somente leitura
address string Endereço IP ou nome DNS ao qual se conectar.

Macros de usuário são compatíveis.

Comportamento da propriedade:
- obrigatório se o modo de operação do proxy Zabbix for passivo
port string Número da porta à qual se conectar.

Macros de usuário são compatíveis.

Padrão: 10051.

Comportamento da propriedade:
- compatível se o modo de operação do proxy Zabbix for passivo
allowed_addresses string Endereços IP ou nomes DNS do proxy Zabbix ativo, delimitados por vírgulas.
tls_connect integer Conexões com o proxy.

Valores possíveis:
1 - (padrão) Sem criptografia;
2 - PSK;
4 - certificado.
tls_accept integer Conexões do proxy.

Valores possíveis da máscara de bits:
1 - (padrão) Sem criptografia;
2 - PSK;
4 - certificado.

Este é um campo de máscara de bits; qualquer soma dos valores possíveis da máscara de bits é aceita (por exemplo, 6 para PSK e certificado).
tls_issuer string Emissor do certificado.
tls_subject string Assunto do certificado.
tls_psk_identity string Identidade da PSK; deve ser associada a apenas uma PSK (entre autoregistration, hosts e proxies).

Não inclua informações confidenciais na identidade da PSK, pois ela é enviada sem criptografia pela rede para informar ao receptor qual PSK deve ser usada.

Comportamento da propriedade:
- somente gravação
- obrigatório se tls_connect estiver definido como "PSK" ou se tls_accept contiver o bit "PSK"
tls_psk string Chave pré-compartilhada (PSK); deve ter pelo menos 32 dígitos hexadecimais.

Comportamento da propriedade:
- somente gravação
- obrigatório se tls_connect estiver definido como "PSK" ou se tls_accept contiver o bit "PSK"
custom_timeouts integer Define se os tempos limite globais dos itens devem ser substituídos no nível do proxy.

Valores possíveis:
0 - (padrão) usar configurações globais;
1 - substituir tempos limite.
timeout_zabbix_agent string Não gastar mais do que timeout_* segundos no processamento.
Aceita um número de segundos (por exemplo, 1, 60, 300) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m). Também aceita macros de usuário.
Usado somente se custom_timeouts estiver definido como "substituir tempos limite"; caso contrário, o valor será ignorado.

O intervalo de valores possíveis é: 1-600s.

Comportamento da propriedade:
- obrigatório se custom_timeouts estiver definido como "substituir tempos limite"
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
timeout_telemetry_query
version integer Versão do proxy.

Número de versão do Zabbix com três partes, em que dois dígitos decimais são usados para cada parte, por exemplo, 60401 para a versão 6.4.1, 70002 para a versão 7.0.2 etc.
0 - Versão desconhecida do proxy.

Comportamento da propriedade:
- somente leitura
compatibility integer Versão do proxy em comparação com a versão do server Zabbix.

Valores possíveis:
0 - Indefinida;
1 - Versão atual (o proxy e o server têm a mesma versão principal);
2 - Versão desatualizada (a versão do proxy é anterior à versão do server, mas tem suporte parcial);
3 - Versão sem suporte (a versão do proxy é anterior à versão da versão LTS anterior do server ou a versão principal do server é anterior à versão principal do proxy).

Comportamento da propriedade:
- somente leitura
state integer Estado do proxy.

Valores possíveis:
0 - Desconhecido;
1 - Offline;
2 - Online.

Comportamento da propriedade:
- somente leitura

Monitoramento de desempenho de aplicações (APM)

O objeto APM tem as seguintes propriedades.

Property Type Description
data_collection_status integer Indica se a coleta de dados de telemetria está habilitada no proxy.

Valores possíveis:
0 - (padrão) Desabilitada;
1 - Habilitada.
max_messages_per_second integer Número máximo de mensagens por segundo que o proxy aceita.

O intervalo de valores possíveis é: 0 (ilimitado) – 2147483647.

Padrão: 0.

Comportamento da propriedade:
- supported se data_collection_status estiver definido como "Enabled"
additional_resource_attributes array Matriz de atributos de recurso a serem adicionados aos dados de telemetria recebidos.

Comportamento da propriedade:
- supported se data_collection_status estiver definido como "Enabled"

Atributos do recurso

O objeto de atributos do recurso tem as seguintes propriedades.

Property Type Description
key string Nome do atributo do recurso.
Deve ser exclusivo para o signal_type especificado.

Comportamento da propriedade:
- obrigatório
value string Valor do atributo do recurso.
Pode estar vazio.
signal_type integer Tipo de dados de telemetria ao qual o atributo se aplica.

Valores possíveis:
0 - Traces;
1 - Métricas;
2 - Logs.

Comportamento da propriedade:
- obrigatório