Objeto proxy

Los siguientes objetos están directamente relacionados con la API proxy.

Proxy

El objeto proxy tiene las siguientes propiedades.

Property Type Description
proxyid ID ID del proxy.

Comportamiento de la propiedad:
- solo lectura
- obligatoria para las operaciones de actualización
name string Nombre del proxy.

Comportamiento de la propiedad:
- obligatoria para las operaciones de creación
proxy_groupid ID ID del grupo de proxies.

0 - el proxy no está asignado a ningún grupo de proxies.
local_address string Dirección para los agentes activos. Dirección IP o nombre DNS al que conectarse.

Comportamiento de la propiedad:
- obligatoria si proxy_groupid no es 0
local_port string Número de puerto local del proxy al que conectarse.

Se admiten macros de usuario.

Predeterminado: 10051.

Comportamiento de la propiedad:
- admitida si proxy_groupid no es 0
operating_mode integer Tipo de proxy.

Valores posibles:
0 - proxy activo;
1 - proxy pasivo.

Comportamiento de la propiedad:
- obligatoria para las operaciones de creación
description text Descripción del proxy.
lastaccess timestamp Momento en que el proxy se conectó por última vez al server.

Comportamiento de la propiedad:
- solo lectura
address string Dirección IP o nombre DNS al que conectarse.

Se admiten macros de usuario.

Comportamiento de la propiedad:
- obligatoria si el modo de funcionamiento del proxy de Zabbix es pasivo
port string Número de puerto al que conectarse.

Se admiten macros de usuario.

Predeterminado: 10051.

Comportamiento de la propiedad:
- admitida si el modo de funcionamiento del proxy de Zabbix es pasivo
allowed_addresses string Direcciones IP o nombres DNS delimitados por comas del proxy activo de Zabbix.
tls_connect integer Conexiones al proxy.

Valores posibles:
1 - (predeterminado) sin cifrado;
2 - PSK;
4 - certificado.
tls_accept integer Conexiones desde el proxy.

Valores posibles de mapa de bits:
1 - (predeterminado) sin cifrado;
2 - PSK;
4 - certificado.

Este es un campo de máscara de bits; se acepta cualquier suma de los valores posibles del mapa de bits (por ejemplo, 6 para PSK y certificado).
tls_issuer string Emisor del certificado.
tls_subject string Asunto del certificado.
tls_psk_identity string Identidad PSK; debe estar asociada únicamente a una PSK (entre autoregistro, hosts y proxies).

No incluya información confidencial en la identidad PSK, ya que se envía sin cifrar a través de la red para informar al receptor de qué PSK debe utilizar.

Comportamiento de la propiedad:
- solo escritura
- obligatoria si tls_connect está establecido en "PSK" o si tls_accept contiene el bit "PSK"
tls_psk string Clave precompartida (PSK); debe tener al menos 32 dígitos hexadecimales.

Comportamiento de la propiedad:
- solo escritura
- obligatoria si tls_connect está establecido en "PSK" o si tls_accept contiene el bit "PSK"
custom_timeouts integer Indica si se deben sobrescribir los tiempos de espera globales de los item en el nivel del proxy.

Valores posibles:
0 - (predeterminado) utilizar la configuración global;
1 - sobrescribir los tiempos de espera.
timeout_zabbix_agent string No dedicar más de timeout_* segundos al procesamiento.
Acepta un número de segundos (por ejemplo, 1, 60, 300) o un valor con un sufijo de tiempo (por ejemplo, 30s, 1m). También acepta macros de usuario.
Se utiliza únicamente si custom_timeouts está establecido en "override timeouts"; de lo contrario, el valor se ignora.

Rango de valores posibles: 1-600s.

Comportamiento de la propiedad:
- obligatoria si custom_timeouts está establecido en "override timeouts"
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 Versión del proxy.

Número de versión de Zabbix de tres partes, donde se utilizan dos dígitos decimales para cada parte; por ejemplo, 60401 para la versión 6.4.1, 70002 para la versión 7.0.2, etc.
0 - Versión del proxy desconocida.

Comportamiento de la propiedad:
- solo lectura
compatibility integer Versión del proxy en comparación con la versión del server de Zabbix.

Valores posibles:
0 - No definida;
1 - Versión actual (el proxy y el server tienen la misma versión principal);
2 - Versión obsoleta (la versión del proxy es anterior a la del server, pero es parcialmente compatible);
3 - Versión no compatible (la versión del proxy es anterior a la versión de la versión LTS anterior del server o la versión principal del server es anterior a la versión principal del proxy).

Comportamiento de la propiedad:
- solo lectura
state integer Estado del proxy.

Valores posibles:
0 - Desconocido;
1 - Fuera de línea;
2 - En línea.

Comportamiento de la propiedad:
- solo lectura

Supervisión del rendimiento de las aplicaciones (APM)

El objeto APM tiene las siguientes propiedades.

Property Type Description
data_collection_status integer Indica si la recopilación de datos de telemetría está habilitada en el proxy.

Valores posibles:
0 - (predeterminado) Deshabilitada;
1 - Habilitada.
max_messages_per_second integer Número máximo de mensajes por segundo que acepta el proxy.

Rango de valores posibles: 0 (ilimitado) – 2147483647.

Valor predeterminado: 0.

Comportamiento de la propiedad:
- supported si data_collection_status está establecido en "Habilitada"
additional_resource_attributes array Matriz de atributos de recursos que se añadirán a los datos de telemetría entrantes.
Si los datos entrantes ya contienen un atributo de recurso con el mismo nombre, se conserva el atributo entrante en lugar del especificado aquí.

Comportamiento de la propiedad:
- supported si data_collection_status está establecido en "Habilitada"

Atributos del recurso

El objeto de atributos del recurso tiene las siguientes propiedades.

Property Type Description
key string Nombre del atributo del recurso.
Debe ser único para el signal_type especificado.

Comportamiento de la propiedad:
- required
value string Valor del atributo del recurso.
Puede estar vacío.
signal_type integer Tipo de datos de telemetría al que se aplica el atributo.

Valores posibles:
0 - Trazas;
1 - Métricas;
2 - Registros.

Comportamiento de la propiedad:
- required