1 Protocolo de intercambio de datos servidor-proxy

Descripción general

Servidor - el intercambio de datos proxy se basa en el formato JSON.

Los mensajes de solicitud y respuesta deben comenzar con encabezado y longitud de datos.

Proxy pasivo

Solicitud de configuración

El servidor primero enviará una solicitud de "configuración de proxy" vacía. Esta solicitud se envía cada ProxyConfigFrequency (parámetro de configuración del servidor) segundos.

El proxy responde con la versión actual del proxy, el token de sesión y la revisión de la configuración. El servidor responde con los datos de configuración que deben actualizarse.

nombre					tipo de valor	descripción
servidor→proxy:
solicitud					cadena	'configuración de proxy'

proxy→servidor:
version					cadena	Versión de proxy (<principal>.<menor>.<compilación>).
session					cadena	Token de sesión de configuración de proxy.
config_revision					número	Revisión de la configuración del proxy.

servidor→proxy:
full_sync					número	1 - si se envían los datos de configuración completos; ausente - en caso contrario (opcional).
data					matriz	Objeto de datos de la tabla. Ausente si no se ha cambiado la configuración (opcional).
	<tabla>				objeto	Uno o más objetos con datos <table> (opcional, dependiendo de los cambios).
		fields			matriz	Matriz de nombres de campos.
			-		cadena	Nombre del campo.
		data			matriz	Conjunto de filas.
			-		array	Conjunto de columnas.
				-	string,number	Valor de columna con tipo según el tipo de columna en el esquema de la base de datos.

macro.secrets					objeto	Información de macro secreta, ausente si no hay cambios en las macros de la bóveda (opcional).
config_revision					número	Revisión de la caché de configuración: enviada con datos de configuración (opcional).
del_hostids					matriz	Matriz de hostids eliminados (opcional).
	-				número	Identificador de equipo.
del_macro_hostids					matriz	Matriz de hostids con todas las macros eliminadas (opcional).
	-				número	Identificador de equipo.

proxy→servidor:
response					cadena	Solicite información de éxito ("éxito" o "fallido").
version					cadena	Versión de proxy (<principal>.<menor>.<compilación>).

Ejemplo:

servidor→proxy:

{
         "request":"proxy config"
       }

proxy→servidor:

{
         "version": "7.0.0",
         "session": "0033124949800811e5686dbfd9bcea98",
         "config_revision": 0
       }

servidor→proxy:


       {
           "full_sync": 1,
           "data": {
               "hosts": {
                   "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"],
                   "data": [
                       [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""]
                   ]
               },
               "interface": {
                   "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"],
                   "data": [
                       [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1]
                   ]
               },
               "interface_snmp": {
                   "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"],
                   "data": []
               },
               "host_inventory": {
                   "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"],
                   "data": [
                       [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""]
                   ]
               },
               "items": {
                   "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"],
                   "data": [
                       [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0],
                       [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0]
                   ]
               },
               "item_rtdata": {
                   "fields": ["itemid", "lastlogsize", "mtime"],
                   "data": [
                       [44161, 0, 0],
                       [44162, 0, 0]
                   ]
               },
               "item_preproc": {
                   "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"],
                   "data": []
               },
               "item_parameter": {
                   "fields": ["item_parameterid", "itemid", "name", "value"],
                   "data": []
               },
               "globalmacro": {
                   "fields": ["globalmacroid", "macro", "value", "type"],
                   "data": [
                       [2, "{$SNMP_COMMUNITY}", "public", 0]
                   ]
               },
               "hosts_templates": {
                   "fields": ["hosttemplateid", "hostid", "templateid", "link_type"],
                   "data": []
               },
               "hostmacro": {
                   "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"],
                   "data": [
                       [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0]
                   ]
               },
               "drules": {
                   "fields": ["druleid", "name", "iprange", "delay"],
                   "data": [
                       [2, "Local network", "127.0.0.1", "10s"]
                   ]
               },
               "dchecks": {
                   "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"],
                   "data": [
                       [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0]
                   ]
               },
               "regexps": {
                   "fields": ["regexpid", "name"],
                   "data": [
                       [1, "File systems for discovery"],
                       [2, "Network interfaces for discovery"],
                       [3, "Storage devices for SNMP discovery"],
                       [4, "Windows service names for discovery"],
                       [5, "Windows service startup states for discovery"]
                   ]
               },
               "expressions": {
                   "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"],
                   "data": [
                       [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0],
                       [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1],
                       [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1],
                       [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1],
                       [7, 2, "^Software Loopback Interface", 4, ",", 1],
                       [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1],
                       [9, 2, "^NULL[0-9.]*$", 4, ",", 1],
                       [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1],
                       [11, 2, "^[Ss]ystem$", 4, ",", 1],
                       [12, 2, "^Nu[0-9.]*$", 4, ",", 1]
                   ]
               },
               "config": {
                   "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"],
                   "data": [
                       [1, 1, 0, "90d", 1]
                   ]
               },
               "httptest": {
                   "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"],
                   "data": []
               },
               "httptestitem": {
                   "fields": ["httptestitemid", "httptestid", "itemid", "type"],
                   "data": []
               },
               "httptest_field": {
                   "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"],
                   "data": []
               },
               "httpstep": {
                   "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"],
                   "data": []
               },
               "httpstepitem": {
                   "fields": ["httpstepitemid", "httpstepid", "itemid", "type"],
                   "data": []
               },
               "httpstep_field": {
                   "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"],
                   "data": []
               },
               "config_autoreg_tls": {
                   "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"],
                   "data": [
                       [1, "", ""]
                   ]
               }
           },
           "macro.secrets": {
               "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": {
                   "Content": "738"
               }
           },
           "config_revision": 2
       }

proxy→servidor:

{
         "response": "success",
         "version": "7.0.0"
       }

Solicitud de datos

La solicitud de "datos de proxy" se utiliza para obtener la disponibilidad de la interfaz del equipo, los datos históricos, de descubrimiento y de autoregistro desde el proxy. Esta petición se envía cada ProxyDataFrequency segundos (parámetro de configuración del servidor).

nombre		tipo de valor	descripción
servidor→proxy:
request		cadena	'datos de proxy'
proxy→servidor:
session		cadena	Token de sesión de datos.
interface availability		matriz	(opcional) Matriz de objetos de datos de disponibilidad de interfaz.
	interfaceid	número	Identificador de interfaz.
	available	número	Disponibilidad de interfaz: 0, INTERFACE_AVAILABLE_UNKNOWN - desconocido 1, INTERFACE_AVAILABLE _TRUE - disponible 2, INTERFACE_AVAILABLE_FALSE - no disponible
	error	cadena	Mensaje de error de interfaz o cadena vacía.
history data		matriz	(opcional) Matriz de objetos de datos históricos.
	itemid	número	Identificador de la métrica.
	clock	número	Marca de tiempo del valor de la métrica (segundos).
	ns	número	Marca de tiempo del valor de la métrica (nanosegundos).
	value	cadena	(opcional) Valor de la métrica.
	id	número	Identificador de valor (contador ascendente, único dentro de una sesión de datos).
	timestamp	número	(opcional) Marca de tiempo de las métricas de tipo de registro.
	source	cadena	(opcional) Valor de origen de la métrica de registro de eventos.
	severity	número	(opcional) Valor de gravedad de la métrica del registro de eventos.
	eventid	número	(opcional) Valor de eventid de la métrica de registro de eventos.
	state	cadena	(opcional) Estado de la métrica: 0, ITEM_STATE_NORMAL 1, ITEM_STATE _NOTSUPPORTED
	lastlogsize	number	(opcional) Último tamaño de registro de las métricas del tipo de registro.
	mtime	number	(opcional) Hora de modificación de las métricas del tipo de registro.
discovery data		matriz	(opcional) Matriz de objetos de datos de descubrimiento.
	clock	número	Marca de tiempo de datos de descubrimiento.
	druleid	número	Identificador de regla de descubrimiento.
	dcheckid	number	Identificador de verificación de descubrimiento o nulo para los datos de la regla de descubrimiento.
	type	número	Tipo de verificación de descubrimiento: -1 datos de regla de descubrimiento 0, SVC_SSH - Verificación del servicio SSH 1, SVC_LDAP - Verificación del servicio LDAP 2, SVC_SMTP - Verificación del servicio SMTP 3, SVC_FTP - Verificación del servicio FTP 4, SVC_HTTP - Verificación del servicio HTTP 5, SVC_POP - Verificación del servicio POP 6, * SVC_NNTP* - Verificación del servicio NNTP 7, SVC_IMAP - Verificación del servicio IMAP 8, SVC_TCP - Verificación de disponibilidad del puerto TCP ** 9, SVC_AGENT - Agente Zabbix 10, SVC_SNMPv1 - Agente SNMPv1 11*, SVC_SNMPv2* - Agente SNMPv2 * 12, SVC_ICMPPING* - Ping ICMP 13, SVC_SNMPv3 - Agente SNMPv3 14, SVC_HTTPS - Verificación del servicio HTTPS<br >15*, SVC_TELNET* - Verificación de disponibilidad de Telnet
	ip	cadena	Dirección IP del equipo.
	dns	cadena	Nombre DNS del equipo.
	port	número	(opcional) Número de puerto de servicio.
	key_	string	(opcional) Clave de elemento para verificación de descubrimiento de tipo 9 SVC_AGENT
	value	cadena	(opcional) Valor recibido del servicio, puede estar vacío para la mayoría de los servicios.
	status	número	(opcional) Estado del servicio: 0, DOBJECT_STATUS_UP - Servicio ARRIBA *1 , DOBJECT_STATUS_DOWN* - Servicio ABAJO
auto registration		matriz	(opcional) Matriz de objetos de datos de registro automático.
	clock	número	Marca de tiempo de datos de registro automático.
	host	cadena	Nombre de equipo.
	ip	cadena	(opcional) Dirección IP del equipo.
	dns	cadena	(opcional) Nombre DNS resuelto desde la dirección IP.
	port	cadena	(opcional) Puerto del equipo.
	host_metadata	cadena	(opcional) Metadatos del equipo enviados por el agente (según el parámetro de configuración del agente HostMetadata o HostMetadataItem).
tasks		matriz	(opcional) Matriz de tareas.
	type	número	Tipo de tarea: 0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - resultado del comando remoto
	status	number	Estado de ejecución del comando remoto: 0, ZBX_TM_REMOTE_COMMAND_COMPLETED - el comando remoto se completó correctamente 1, ZBX_TM_REMOTE_COMMAND_FAILED - error del comando remoto
	error	cadena	(opcional) Mensaje de error.
	parent_taskid	number	ID de tarea principal.
more		número	(opcional) 1 - hay más datos del historial para enviar.
clock		número	(opcional) Marca de tiempo de transferencia de datos (segundos).
ns		número	(opcional) Marca de tiempo de transferencia de datos (nanosegundos).
version		cadena	Versión de proxy (<principal>.<menor>.<compilación>).
servidor→proxy:
response		cadena	Solicitud de información de éxito ('éxito' o 'fallido').
tasks		matriz	(opcional) Matriz de tareas.
	type	número	Tipo de tarea: 1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - comando remoto
	clock	número	Hora de creación de la tarea.
	ttl	número	Tiempo en segundos después del cual caduca la tarea.
	commandtype	número	Tipo de comando remoto: 0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - usar script personalizado ** 1, ZBX_SCRIPT_TYPE_IPMI - usar IPMI 2, ZBX_SCRIPT_TYPE_SSH - usar SSH 3, ZBX_SCRIPT _TYPE_TELNET - usar Telnet 4*, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT* - usar script global (actualmente funcionalmente equivalente a un script personalizado)
	command	cadena	Comando remoto para ejecutar.
	execute_on	number	Destino de ejecución para scripts personalizados: 0, ZBX_SCRIPT_EXECUTE_ON_AGENT - ejecutar script en el agente< br>1, ZBX_SCRIPT_EXECUTE_ON_SERVER - ejecutar script en el servidor 2, ZBX_SCRIPT_EXECUTE_ON_PROXY - ejecutar script en proxy
	port	número	(opcional) Puerto para comandos Telnet y SSH.
	authtype	number	(opcional) Tipo de autenticación para comandos SSH.
	username	cadena	(opcional) Nombre de usuario para comandos Telnet y SSH.
	password	cadena	(opcional) Contraseña para comandos Telnet y SSH.
	publickey	cadena	(opcional) Clave pública para comandos SSH.
	privatekey	string	(opcional) Clave privada para comandos SSH.
	parent_taskid	number	ID de tarea principal.
	hostid	número	ID del equipo de destino.

Ejemplo:

servidor→proxy:

{
         "request": "proxy data"
       }

proxy→servidor:

{
           "session": "12345678901234567890123456789012"
           "interface availability": [
               {
                   "interfaceid": 1,
                   "available": 1,
                   "error": ""
           },
               {
                   "interfaceid": 2,
                   "available": 2,
                   "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"
           },
               {
                   "interfaceid": 3,
                   "available": 1,
                   "error": ""
           },
               {
                   "interfaceid": 4,
                   "available": 1,
                   "error": ""
           }
           ],
           "history data":[
               {
                   "itemid":"12345",
                   "clock":1478609647,
                   "ns":332510044,
                   "value":"52956612",
                   "id": 1
               },
               {
                   "itemid":"12346",
                   "clock":1478609647,
                   "ns":330690279,
                   "state":1,
                   "value":"Cannot find information for this network interface in /proc/net/dev.",
                   "id": 2
               }
           ],
           "discovery data":[
               {
                   "clock":1478608764,
                   "drule":2,
                   "dcheck":3,
                   "type":12,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               },
               {
                   "clock":1478608764,
                   "drule":2,
                   "dcheck":null,
                   "type":-1,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               }
           ],
           "auto registration":[
               {
                   "clock":1478608371,
                   "host":"Logger1",
                   "ip":"10.3.0.1",
                   "dns":"localhost",
                   "port":"10050"
               },
               {
                   "clock":1478608381,
                   "host":"Logger2",
                   "ip":"10.3.0.2",
                   "dns":"localhost",
                   "port":"10050"
               }
           ],
           "tasks":[
               {
                   "type": 0,
                   "status": 0,
                   "parent_taskid": 10
               },
               {
                   "type": 0,
                   "status": 1,
                   "error": "No permissions to execute task.",
                   "parent_taskid": 20
               }
           ],
           "version":"6.4.0"
       }

servidor→proxy:

{
         "response": "success",
         "tasks":[
             {
                "type": 1,
                "clock": 1478608371,
                "ttl": 600,
                "commandtype": 2,
                "command": "restart_service1.sh",
                "execute_on": 2,
                "port": 80,
                "authtype": 0,
                "username": "userA",
                "password": "password1",
                "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
                "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
                "parent_taskid": 10,
                "hostid": 10070
             },
             {
                "type": 1,
                "clock": 1478608381,
                "ttl": 600,
                "commandtype": 1,
                "command": "restart_service2.sh",
                "execute_on": 0,
                "authtype": 0,
                "username": "",
                "password": "",
                "publickey": "",
                "privatekey": "",
                "parent_taskid": 20,
                "hostid": 10084
             }
         ]
       }

Proxy activo

Solicitud de configuración

La solicitud proxy config es enviada por el proxy activo para obtener los datos de configuración del proxy. Esta solicitud se envía cada ProxyConfigFrequency segundos (parámetro de configuración del proxy).

nombre					tipo de valor	descripción
proxy→servidor:
request					cadena	'proxy config'
host					cadena	Nombre del proxy.
version					cadena	Versión de proxy (<principal>.<menor>.<compilación>).
session					cadena	Token de sesión de configuración de proxy.
config_revision					número	Revisión de la configuración del proxy.

servidor→proxy:
fullsync					número	1 - si se envían los datos de configuración completos, ausente en caso contrario (opcional).
data					matriz	Objeto de datos de la tabla. Ausente si no se ha cambiado la configuración (opcional).
	<table>				objeto	Uno o más objetos con datos <table> (opcional, dependiendo de los cambios).
		fields			matriz	Matriz de nombres de campos.
			-		string	Nombre del campo.
		data			matriz	Conjunto de filas.
			-		array	Conjunto de columnas.
				-	string,number	Valor de columna con tipo según el tipo de columna en el esquema de la base de datos.

macro.secrets					objeto	Información de macro secreta, ausente si no hay cambios en las macros de almacén (opcional).
config_revision					número	Revisión de la caché de configuración: enviada con datos de configuración (opcional).
del_hostids					matriz	Matriz de hostids eliminados (opcional).
	-				number	Identificador de equipo.
del_macro_hostids					matriz	Matriz de hostids con todas las macros eliminadas (opcional).
	-				number	Identificador de equipo.

Ejemplo:

proxy→servidor:

{
         "request": "proxy config",
         "host": "Zabbix proxy",
         "version":"6.4.0",
         "session": "fd59a09ff4e9d1fb447de1f04599bcf6",
         "config_revision": 0
       }

servidor→proxy:

{
           "full_sync": 1,
           "data": {
               "hosts": {
                   "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"],
                   "data": [
                       [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""]
                   ]
               },
               "interface": {
                   "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"],
                   "data": [
                       [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1]
                   ]
               },
               "interface_snmp": {
                   "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"],
                   "data": []
               },
               "host_inventory": {
                   "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"],
                   "data": [
                       [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""]
                   ]
               },
               "items": {
                   "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"],
                   "data": [
                       [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0],
                       [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0]
                   ]
               },
               "item_rtdata": {
                   "fields": ["itemid", "lastlogsize", "mtime"],
                   "data": [
                       [44161, 0, 0],
                       [44162, 0, 0]
                   ]
               },
               "item_preproc": {
                   "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"],
                   "data": []
               },
               "item_parameter": {
                   "fields": ["item_parameterid", "itemid", "name", "value"],
                   "data": []
               },
               "globalmacro": {
                   "fields": ["globalmacroid", "macro", "value", "type"],
                   "data": [
                       [2, "{$SNMP_COMMUNITY}", "public", 0]
                   ]
               },
               "hosts_templates": {
                   "fields": ["hosttemplateid", "hostid", "templateid", "link_type"],
                   "data": []
               },
               "hostmacro": {
                   "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"],
                   "data": [
                       [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0]
                   ]
               },
               "drules": {
                   "fields": ["druleid", "name", "iprange", "delay"],
                   "data": [
                       [2, "Local network", "127.0.0.1", "10s"]
                   ]
               },
               "dchecks": {
                   "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"],
                   "data": [
                       [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0]
                   ]
               },
               "regexps": {
                   "fields": ["regexpid", "name"],
                   "data": [
                       [1, "File systems for discovery"],
                       [2, "Network interfaces for discovery"],
                       [3, "Storage devices for SNMP discovery"],
                       [4, "Windows service names for discovery"],
                       [5, "Windows service startup states for discovery"]
                   ]
               },
               "expressions": {
                   "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"],
                   "data": [
                       [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0],
                       [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1],
                       [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1],
                       [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1],
                       [7, 2, "^Software Loopback Interface", 4, ",", 1],
                       [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1],
                       [9, 2, "^NULL[0-9.]*$", 4, ",", 1],
                       [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1],
                       [11, 2, "^[Ss]ystem$", 4, ",", 1],
                       [12, 2, "^Nu[0-9.]*$", 4, ",", 1]
                   ]
               },
               "config": {
                   "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"],
                   "data": [
                       [1, 1, 0, "90d", 1]
                   ]
               },
               "httptest": {
                   "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"],
                   "data": []
               },
               "httptestitem": {
                   "fields": ["httptestitemid", "httptestid", "itemid", "type"],
                   "data": []
               },
               "httptest_field": {
                   "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"],
                   "data": []
               },
               "httpstep": {
                   "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"],
                   "data": []
               },
               "httpstepitem": {
                   "fields": ["httpstepitemid", "httpstepid", "itemid", "type"],
                   "data": []
               },
               "httpstep_field": {
                   "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"],
                   "data": []
               },
               "config_autoreg_tls": {
                   "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"],
                   "data": [
                       [1, "", ""]
                   ]
               }
           },
           "macro.secrets": {
               "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": {
                   "Content": "738"
               }
           },
           "config_revision": 2
       }

Solicitud de datos

La solicitud de "datos de proxy" se envía por el proxy para proporcionar datos de disponibilidad, historial, descubrimiento y registro automático de la interfaz del equipo. Esta solicitud se envía cada segundos de DataSenderFrequency (parámetro de configuración de proxy). Tenga en cuenta que el proxy activo seguirá sondeando el servidor Zabbix cada segundo en busca de tareas de comando remotas (con una solicitud de "datos de proxy" vacía).

nombre		tipo de valor	descripción
proxy→servidor:
request		cadena	'datos de proxy'
host		cadena	Nombre de proxy.
session		cadena	Token de sesión de datos.
interface availability		matriz	(opcional) Matriz de objetos de datos de disponibilidad de interfaz.
	interfaceid	número	Identificador de interfaz.
	available	número	Disponibilidad de interfaz: 0, INTERFACE_AVAILABLE_UNKNOWN - desconocido 1, INTERFACE_AVAILABLE _TRUE - disponible 2, INTERFACE_AVAILABLE_FALSE - no disponible
	error	cadena	Mensaje de error de interfaz o cadena vacía.
history data		matriz	(opcional) Matriz de objetos de datos históricos.
	itemid	número	Identificador de métrica.
	clock	número	Marca de tiempo del valor de la métrica (segundos).
	ns	número	Marca de tiempo del valor de la métrica (nanosegundos).
	value	cadena	(opcional) Valor del artículo.
	id	número	Identificador de valor (contador ascendente, único dentro de una sesión de datos).
	timestamp	número	(opcional) Marca de tiempo de los elementos de tipo de registro.
	source	cadena	(opcional) Valor de origen del elemento de registro de eventos.
	severity	número	(opcional) Valor de gravedad del elemento del registro de eventos.
	eventid	número	(opcional) Valor de eventid del elemento de registro de eventos.
	state	cadena	(opcional) Estado del artículo: 0, ITEM_STATE_NORMAL 1, ITEM_STATE _NOTSAPPORTADO
	lastlogsize	number	(opcional) Último tamaño de registro de los elementos del tipo de registro.
	mtime	number	(opcional) Hora de modificación de los elementos del tipo de registro.
discovery data		matriz	(opcional) Matriz de objetos de datos de descubrimiento.
	clock	número	Marca de tiempo de datos de descubrimiento.
	druleid	número	Identificador de regla de descubrimiento.
	dcheckid	number	Identificador de verificación de descubrimiento o nulo para los datos de la regla de descubrimiento.
	type	número	Tipo de verificación de descubrimiento: -1 datos de regla de descubrimiento 0, SVC_SSH - Verificación del servicio SSH 1, SVC_LDAP - Verificación del servicio LDAP 2, SVC_SMTP - Verificación del servicio SMTP 3, SVC_FTP - Verificación del servicio FTP 4, SVC_HTTP - Verificación del servicio HTTP 5, SVC_POP - Verificación del servicio POP 6, * SVC_NNTP* - Verificación del servicio NNTP 7, SVC_IMAP - Verificación del servicio IMAP 8, SVC_TCP - Verificación de disponibilidad del puerto TCP ** 9, SVC_AGENT - Agente Zabbix 10, SVC_SNMPv1 - Agente SNMPv1 11*, SVC_SNMPv2* - Agente SNMPv2 * 12, SVC_ICMPPING* - Ping ICMP 13, SVC_SNMPv3 - Agente SNMPv3 14, SVC_HTTPS - Verificación del servicio HTTPS<br >15*, SVC_TELNET* - Verificación de disponibilidad de Telnet
	ip	cadena	Dirección IP del host.
	dns	cadena	Nombre DNS del host.
	port	número	(opcional) Número de puerto de servicio.
	key_	string	(opcional) Clave de elemento para verificación de descubrimiento de tipo 9 SVC_AGENT
	value	cadena	(opcional) Valor recibido del servicio, puede estar vacío para la mayoría de los servicios.
	status	número	(opcional) Estado del servicio: 0, DOBJECT_STATUS_UP - Servicio ARRIBA *1 , DOBJECT_STATUS_DOWN* - Servicio ABAJO
autoregistration		matriz	(opcional) Matriz de objetos de datos de autoregistro.
	clock	número	Marca de tiempo de datos de registro automático.
	host	cadena	Nombre de host.
	ip	cadena	(opcional) Dirección IP del host.
	dns	cadena	(opcional) Nombre DNS resuelto desde la dirección IP.
	port	cadena	(opcional) Puerto de host.
	host_metadata	cadena	(opcional) Metadatos del host enviados por el agente (según el parámetro de configuración del agente HostMetadata o HostMetadataItem).
tasks		matriz	(opcional) Matriz de tareas.
	type	número	Tipo de tarea: 0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - resultado del comando remoto
	status	number	Estado de ejecución del comando remoto: 0, ZBX_TM_REMOTE_COMMAND_COMPLETED - el comando remoto se completó correctamente 1, ZBX_TM_REMOTE_COMMAND_FAILED - error del comando remoto
	error	cadena	(opcional) Mensaje de error.
	parent_taskid	number	ID de tarea principal.
more		número	(opcional) 1 - hay más datos del historial para enviar
clock		número	(opcional) Marca de tiempo de transferencia de datos (segundos).
ns		número	(opcional) Marca de tiempo de transferencia de datos (nanosegundos).
version		cadena	Versión de proxy (<principal>.<menor>.<compilación>).
servidor→proxy:
response		cadena	Solicitud de información de éxito ('éxito' o 'fallido').
upload		string	Control de carga para datos históricos (historial, registro automático, disponibilidad de host, descubrimiento de red). Valores posibles: enabled - funcionamiento normal deshabilitado: el servidor no acepta datos (posiblemente debido a que el caché interno excede el límite)
tasks		matriz	(opcional) Matriz de tareas.
	type	número	Tipo de tarea: 1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - comando remoto
	clock	número	Hora de creación de la tarea.
	ttl	número	Tiempo en segundos después del cual caduca la tarea.
	commandtype	número	Tipo de comando remoto: 0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - usar script personalizado ** 1, ZBX_SCRIPT_TYPE_IPMI - usar IPMI 2, ZBX_SCRIPT_TYPE_SSH - usar SSH 3, ZBX_SCRIPT _TYPE_TELNET - usar Telnet 4*, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT* - usar script global (actualmente funcionalmente equivalente a un script personalizado)
	command	cadena	Comando remoto para ejecutar.
	execute_on	number	Destino de ejecución para scripts personalizados: 0, ZBX_SCRIPT_EXECUTE_ON_AGENT - ejecutar script en el agente< br>1, ZBX_SCRIPT_EXECUTE_ON_SERVER - ejecutar script en el servidor 2, ZBX_SCRIPT_EXECUTE_ON_PROXY - ejecutar script en proxy
	port	número	(opcional) Puerto para comandos Telnet y SSH.
	authtype	number	(opcional) Tipo de autenticación para comandos SSH.
	username	cadena	(opcional) Nombre de usuario para comandos Telnet y SSH.
	password	cadena	(opcional) Contraseña para comandos Telnet y SSH.
	publickey	cadena	(opcional) Clave pública para comandos SSH.
	privatekey	string	(opcional) Clave privada para comandos SSH.
	parent_taskid	number	ID de tarea principal.
	hostid	número	ID del host de destino.

Ejemplo:

proxy→servidor:

{
           "request": "proxy data",
           "host": "Zabbix proxy",
           "session": "818cdd1b537bdc5e50c09ed4969235b6",
           "interface availability": [{
               "interfaceid": 1,
               "available": 1,
               "error": ""
           }],
           "history data": [{
               "id": 1114,
               "itemid": 44162,
               "clock": 1665730632,
               "ns": 798953105,
               "value": "1"
           }, {
               "id": 1115,
               "itemid": 44161,
               "clock": 1665730633,
               "ns": 811684663,
               "value": "58"
           }],
           "auto registration": [{
               "clock": 1665730633,
               "host": "Zabbix server",
               "ip": "127.0.0.1",
               "dns": "localhost",
               "port": "10053",
               "host_metadata": "58",
               "tls_accepted": 1
           }],
           "discovery data": [{
               "clock": 1665732232,
               "drule": 2,
               "dcheck": 2,
               "ip": "127.0.0.1",
               "dns": "localhost",
               "port": 10052,
               "status": 1
           }, {
               "clock": 1665732232,
               "drule": 2,
               "dcheck": null,
               "ip": "127.0.0.1",
               "dns": "localhost",
               "status": 1
           }],
           "host data": [{
               "hostid": 10084,
               "active_status": 1
           }],
           "tasks": [{
               "type": 3,
               "clock": 1665730985,
               "ttl": 0,
               "status": -1,
               "info": "Remote commands are not enabled",
               "parent_taskid": 3
           }],
           "version": "6.4.0",
           "clock": 1665730643,
           "ns": 65389964
       }

servidor→proxy:

{
           "upload": "enabled",
           "response": "success",
           "tasks": [{
               "type": 2,
               "clock": 1665730986,
               "ttl": 600,
               "commandtype": 0,
               "command": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac",
               "execute_on": 2,
               "port": 0,
               "authtype": 0,
               "username": "",
               "password": "",
               "publickey": "",
               "privatekey": "",
               "alertid": 0,
               "parent_taskid": 4,
               "hostid": 10084
           }]
       }

Documentation

1 Protocolo de intercambio de datos servidor-proxy

Descripción general

Proxy pasivo

Solicitud de configuración

Solicitud de datos

Proxy activo

Solicitud de configuración

Solicitud de datos