#1 Server-proxy data-uitwisselingsprotocol

Overzicht

Server - uitwisseling van proxy gegevens is gebaseerd op JSON-indeling.

Verzoek- en antwoordberichten moeten beginnen met header and data lengte.

Passieve proxy

Configuratieverzoek

De server stuurt eerst een leeg proxyconfiguratie-verzoek. Dit verzoek wordt elke ProxyConfigFrequentie (serverconfiguratieparameter) seconden verzonden.

De proxy reageert met de huidige proxyversie, sessietoken en configuratieherziening. De server reageert met de configuratiegegevens die moeten worden bijgewerkt.

naam gegevenstype beschrijving
server→proxy:
verzoek string 'proxyconfiguratie'
proxy→server:
versie string Proxyversie (<major>.<minor>.<build>).
sessie string Sessietoken voor proxyconfiguratie.
configuratie_herziening nummer Configuratieherziening van proxy.
server→proxy:
volledige_synchronisatie nummer 1 - als volledige configuratiegegevens worden verzonden; afwezig - anders (optioneel).
gegevens reeks Object van tabelgegevens. Afwezig als de configuratie niet is gewijzigd (optioneel).
<tabel> object Een of meer objecten met <tabel>-gegevens (optioneel, afhankelijk van wijzigingen).
velden reeks Reeks veldnamen.
- string Veldnaam.
gegevens reeks Reeks rijen.
- reeks Reeks kolommen.
- string,nummer Kolomwaarde met type afhankelijk van kolomtype in databaseschema.
macro.geheimen object Geheime macro-informatie, afwezig als er geen wijzigingen zijn in kluis-macro's (optioneel).
configuratie_herziening nummer Configuratiecache-herziening - verzonden met configuratiegegevens (optioneel).
verwijder_hostids reeks Reeks verwijderde host-ids (optioneel).
- nummer Hostidentificatie.
verwijder_macro_hostids reeks Reeks host-ids met alle macro's verwijderd (optioneel).
- nummer Hostidentificatie.
proxy→server:
reactie string Informatie over het succes van het verzoek ('gelukt' of 'mislukt').
versie string Proxyversie (<major>.<minor>.<build>).

Voorbeeld:

server→proxy:

server→proxy:

{
         "verzoek": "proxyconfiguratie"
       } 

proxy→server:

{
         "versie": "6.4.0",
         "sessie": "0033124949800811e5686dbfd9bcea98",
         "configuratie_herziening": 0
       }

server→proxy:

{
           "volledige_synchronisatie": 1,
           "gegevens": {
               "hosts": {
                   "velden": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_gebruikersnaam", "ipmi_wachtwoord", "naam", "tls_connectie", "tls_accepteren", "tls_uitgever", "tls_onderwerp", "tls_psk_id", "tls_psk"],
                   "gegevens": [
                       [10084, "Zabbix-server", 0, -1, 2, "", "", "Zabbix-server", 1, 1, "", "", "", ""]
                   ]
               },
               "interface": {
                   "velden": ["interfaceid", "hostid", "hoofd", "type", "gebruik_ip", "ip", "dns", "poort", "beschikbaar"],
                   "gegevens": [
                       [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1]
                   ]
               },
               "interface_snmp": {
                   "velden": ["interfaceid", "versie", "bulk", "gemeenschap", "beveiligingsnaam", "beveiligingsniveau", "auth_wachtwoord", "priv_wachtwoord", "auth_protocol", "priv_protocol", "contextnaam"],
                   "gegevens": []
               },
               "host_inventaris": {
                   "velden": ["hostid", "type", "volledig_type", "naam", "alias",
       
        "os", "volledig_os", "korte_os", "serienummer_a", "serienummer_b", "tag", "asset_tag", "macadres_a", "macadres_b", "hardware", "volledige_hardware", "software", "volledige_software", "app_software_a", "app_software_b", "app_software_c", "app_software_d", "app_software_e", "contact", "locatie", "locatie_lat", "locatie_lon", "notities", "chassis", "model", "hw_architectuur", "leverancier", "contractnummer", "installateur_naam", "implementatiestatus", "url_a", "url_b", "url_c", "host_netwerken", "host_netmasker", "host_router", "oob_ip", "oob_netmasker", "oob_router", "datum_hw_aankoop", "datum_hw_installatie", "datum_hw_verval", "datum_hw_buiten_gebruik", "site_adres_a", "site_adres_b", "site_adres_c", "site_stad", "site_staat", "site_land", "site_postcode", "site_rack", "site_notities", "poc_1_naam", "poc_1_e-mail", "poc_1_telefoon_a", "poc_1_telefoon_b", "poc_1_mobiel", "poc_1_scherm", "poc_1_notities", "poc_2_naam", "poc_2_e-mail", "poc_2_telefoon_a", "poc_2_telefoon_b", "poc_2_mobiel", "poc_2_scherm", "poc_2_notities"],
                   "gegevens": [
                       [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56,95387", "24,22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""]
                   ]
               },
               "items": {
                   "velden": ["itemid", "type", "snmp_oid", "hostid", "sleutel_", "vertraging", "geschiedenis", "status", "waardetype", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "gebruikersnaam", "wachtwoord", "publieke_sleutel", "privésleutel", "vlaggen", "interfaceid", "inventaris_koppeling", "jmx_eindpunt", "master_itemid", "time-out", "url", "query_velden", "berichten", "status_codes", "volg_verwijzingen", "berichttype", "http_proxy", "headers", "ophalen_modus", "verzoeksmethode", "uitvoerformaat", "ssl_certificaat_bestand", "ssl_sleutel_bestand", "ssl_sleutel_wachtwoord", "controleer_peer", "controleer_host", "sta_traps_toe"],
                   "gegevens": [
                       [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_rtgegevens": {
                   "velden": ["itemid", "laatste_log_grootte", "tijd"],
                   "gegevens": [
                       [44161, 0, 0],
                       [44162, 0, 0]
                   ]
               },
               "item_preproc": {
                   "velden": ["item_preprocid", "itemid", "stap", "type", "parameters", "foutverwerker", "foutverwerker_parameters"],
                   "gegevens": []
               },
               "item_parameter": {
                   "velden": ["item_parameterid", "itemid", "naam", "waarde"],
                   "gegevens": []
               },
               "globalemacro": {
                   "velden": ["globalmacroid", "macro", "waarde", "type"],
                   "gegevens": [
                       [2, "{$SNMP_GEMEENSCHAP}", "openbaar", 0]
                   ]
               },
               "hosts_sjablonen": {
                   "velden": ["hostsjabloonid", "hostid", "sjabloonid", "koppelingstype"],
                   "gegevens": []
               },
               "hostmacro": {
                   "velden": ["hostmacroid", "hostid", "macro", "waarde", "type", "automatisch"],
                   "gegevens": [
                       [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=wachtwoordkluis;Object=zabbix:Inhoud", 2, 0]
                   ]
               },
               "drules": {
                   "velden": ["druleid", "naam", "ip-bereik", "vertraging"],
                   "gegevens": [
                       [2, "Lokaal netwerk", "127.0.0.1", "10s"]
                   ]
               },
               "dcontroles": {
                   "velden": ["dcheckid", "druleid", "type", "sleutel_", "snmp_gemeenschap", "poorten", "snmpv3_beveiligingsnaam", "snmpv3_beveiligingsniveau", "snmpv3_auth_wachtwoord", "snmpv3_priv_wachtwoord", "uniek", "snmpv3_auth_protocol", "snmpv3_priv_protocol", "snmpv3_contextnaam", "host_bron", "naam_bron"],
                   "gegevens": [
                       [2, 2, 9, "systeem.uname", "", "10052", "", 0
       
       , "", "", 0, 0, 0, "", 1, 0]
                   ]
               },
               "regexps": {
                   "velden": ["regexpid", "naam"],
                   "gegevens": [
                       [1, "Bestandssystemen voor ontdekking"],
                       [2, "Netwerkinterfaces voor ontdekking"],
                       [3, "Opslagapparaten voor SNMP-ontdekking"],
                       [4, "Windows servicenamen voor ontdekking"],
                       [5, "Windows servicestatussen bij opstarten voor ontdekking"]
                   ]
               },
               "expressies": {
                   "velden": ["expressieid", "regexpid", "expressie", "expressietype", "exp_scheidingsteken", "hoofdlettergevoelig"],
                   "gegevens": [
                       [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0],
                       [3, 3, "^(Fysiek geheugen|Virtueel geheugen|Geheugenbuffers|Gecachet geheugen|Wisselruimte)$", 4, ",", 1],
                       [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1],
                       [6, 5, "^(automatisch|automatisch vertraagd)$", 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]
                   ]
               },
               "configuratie": {
                   "velden": ["configuratieid", "snmptrap_logging", "hk_geschiedenis_globaal", "hk_geschiedenis", "autoreg_tls_accepteren"],
                   "gegevens": [
                       [1, 1, 0, "90d", 1]
                   ]
               },
               "httptest": {
                   "velden": ["httptestid", "naam", "vertraging", "agent", "authenticatie", "http_gebruiker", "http_wachtwoord", "hostid", "http_proxy", "herpogingen", "ssl_certificaat_bestand", "ssl_sleutel_bestand", "ssl_sleutel_wachtwoord", "controleer_peer", "controleer_host"],
                   "gegevens": []
               },
               "httptestitem": {
                   "velden": ["httptestitemid", "httptestid", "itemid", "type"],
                   "gegevens": []
               },
               "httptest_veld": {
                   "velden": ["httptest_veldid", "httptestid", "type", "naam", "waarde"],
                   "gegevens": []
               },
               "httpstap": {
                   "velden": ["httpstapid", "httptestid", "naam", "nee", "url", "time-out", "berichten", "vereist", "status_codes", "volg_verwijzingen", "ophalen_modus", "berichttype"],
                   "gegevens": []
               },
               "httpstapitem": {
                   "velden": ["httpstapitemid", "httpstapid", "itemid", "type"],
                   "gegevens": []
               },
               "httpstap_veld": {
                   "velden": ["httpstap_veldid", "httpstapid", "type", "naam", "waarde"],
                   "gegevens": []
               },
               "configuratie_autoreg_tls": {
                   "velden": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"],
                   "gegevens": [
                       [1, "", ""]
                   ]
               }
           },
           "macro.geheimen": {
               "AppID=zabbix_server&Query=Safe=wachtwoordkluis;Object=zabbix": {
                   "Inhoud": "738"
               }
           },
           "configuratie_herziening": 2
       }

proxy→server:

{
         "reactie": "gelukt",
         "versie": "6.4.0"
       }
Gegevensaanvraag

Het proxygegevens-verzoek wordt gebruikt om gegevens over de beschikbaarheid van hostinterfaces, historische gegevens, ontdekkingsgegevens en automatische registratiegegevens van een proxy op te vragen. Dit verzoek wordt elke ProxyDataFrequency seconden (serverconfiguratieparameter) verzonden.

naam waardetype omschrijving
server→proxy:
verzoek string 'proxygegevens'
proxy→server:
sessie string Gegevenssessietoken.
interfacebeschikbaarheid array (optioneel) Array van gegevensobjecten over de beschikbaarheid van hostinterfaces.
interface-id nummer Identificatie van de interface.
beschikbaar nummer Beschikbaarheid van de interface:

0, INTERFACE_BESCHIKBAAR_ONBEKEND - onbekend
1, INTERFACE_BESCHIKBAAR_WAAR - beschikbaar
2, INTERFACE_BESCHIKBAAR_ONWAAR - niet beschikbaar
fout string Foutbericht van de interface of lege string.
historische gegevens array (optioneel) Array van objecten met historische gegevens.
item-id nummer Identificatie van het item.
tijdstempel nummer Tijdstempel van de itemwaarde (seconden).
ns nummer Tijdstempel van de itemwaarde (nanoseconden).
waarde string (optioneel) Itemwaarde.
id nummer Identificatie van de waarde (oplopende teller, uniek binnen één gegevenssessie).
tijdstempel nummer (optioneel) Tijdstempel van logboekitems.
bron string (optioneel) Bronwaarde van logboekitems.
ernst nummer (optioneel) Ernstwaarde van logboekitems.
gebeurtenis-id nummer (optioneel) Gebeurtenis-ID-waarde van logboekitems.
status string (optioneel) Itemstatus:
0, ITEM_STATUS_NORMAAL
1, ITEM_STATUS_NIETONDERSTEUND
laatste-logboekgrootte nummer (optioneel) Laatste logboekgrootte van logtype-items.
wijzigingstijdstip nummer (optioneel) Wijzigingstijdstip van logtype-items.
ontdekkingsgegevens array (optioneel) Array van ontdekkingsgegevensobjecten.
tijdstempel nummer Tijdstempel van ontdekkingsgegevens.
regel-id nummer Identificatie van de ontdekkingsregel.
controle-id nummer Identificatie van de ontdekkingscontrole of null voor ontdekkingsgegevens van een ontdekkingsregel.
type nummer Type ontdekkingscontrole:

-1 ontdekkingsgegevens van een ontdekkingsregel
0, SVC_SSH - SSH-servicecontrole
1, SVC_LDAP - LDAP-servicecontrole
2, SVC_SMTP - SMTP-servicecontrole
3, SVC_FTP - FTP-servicecontrole
4, SVC_HTTP - HTTP-servicecontrole
5, SVC_POP - POP-servicecontrole
6, SVC_NNTP - NNTP-servicecontrole
7, SVC_IMAP - IMAP-servicecontrole
8, SVC_TCP - TCP-poortbeschikbaarheidscontrole
9, SVC_AGENT - Zabbix-agent
10, SVC_SNMPv1 - SNMPv1-agent
11, SVC_SNMPv2 - SNMPv2-agent
12, SVC_ICMPPING - ICMP-ping
13, SVC_SNMPv3 - SNMPv3-agent
14, SVC_HTTPS - HTTPS-servicecontrole
15, SVC_TELNET - Telnet-beschikbaarheidscontrole
ip string IP-adres van de host.
dns string DNS-naam van de host.
poort nummer (optioneel) Poortnummer van de service.
sleutel string (optioneel) Itemtoets voor ontdekkingscontrole van type 9 SVC_AGENT
waarde string (optioneel) Waarde ontvangen van de service, kan leeg zijn voor de meeste services.
status nummer (optioneel) Servicestatus:

0, DOBJECT_STATUS_ACTIEF - Service ACTIEF
1, DOBJECT_STATUS_INACTIEF - Service INACTIEF
automatische registratie array (optioneel) Array van objecten met automatische registratiegegevens.
tijdstempel nummer Tijdstempel van automatische registratiegegevens.
host string Hostnaam.
ip string (optioneel) IP-adres van de host.
dns string (optioneel) Opgeloste DNS-naam vanaf IP-adres.
poort string (optioneel) Hostpoort.
host-metadata string (optioneel) Hostmetadata verzonden door agent (gebaseerd op HostMetadata of HostMetadataItem agentconfiguratieparameter).
taken array (optioneel) Array van taken.
type nummer Taaktype:

0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - resultaat van externe opdrachtverwerking
status nummer Status van externe-opdrachtuitvoering:

0, ZBX_TM_REMOTE_COMMAND_COMPLETED - externe opdracht succesvol voltooid
1, ZBX_TM_REMOTE_COMMAND_FAILED - externe opdracht mislukt
fout string (optioneel) Foutbericht.
ouder-taak-id nummer ID van oudertaak.
meer nummer (optioneel) 1 - er zijn meer historische gegevens om te verzenden.
tijdstempel nummer (optioneel) Tijdstempel voor gegevensoverdracht (seconden).
ns nummer (optioneel) Tijdstempel voor gegevensoverdracht (nanoseconden).
versie string Proxyversie (<major>.<minor>.<build>).
server→proxy:
antwoord string Informatie over het succes van het verzoek ('geslaagd' of 'mislukt').
taken array (optioneel) Array van taken.
type nummer Taaktype:

1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - externe opdracht
tijdstempel nummer Tijd van taakcreatie.
ttl nummer Tijd in seconden na welke de taak verloopt.
commandotype nummer Type externe opdracht:

0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - aangepast script gebruiken
1, ZBX_SCRIPT_TYPE_IPMI - IPMI gebruiken
2, ZBX_SCRIPT_TYPE_SSH - SSH gebruiken
3, ZBX_SCRIPT_TYPE_TELNET - Telnet gebruiken
4, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT - globaal script gebruiken (momenteel functioneel gelijk aan aangepast script)
opdracht string Uit te voeren externe opdracht.
uitvoeren-op nummer Uitvoeringsdoel voor aangepaste scripts:

0, ZBX_SCRIPT_EXECUTE_ON_AGENT - script uitvoeren op agent
1, ZBX_SCRIPT_EXECUTE_ON_SERVER - script uitvoeren op server
2, ZBX_SCRIPT_EXECUTE_ON_PROXY - script uitvoeren op proxy
poort nummer (optioneel) Poort voor Telnet- en SSH-opdrachten.
authtype nummer (optioneel) Authenticatietype voor SSH-opdrachten.
gebruikersnaam string (optioneel) Gebruikersnaam voor Telnet- en SSH-opdrachten.
wachtwoord string (optioneel) Wachtwoord voor Telnet- en SSH-opdrachten.
publiekesleutel string (optioneel) Publieke sleutel voor SSH-opdrachten.
privésleutel string (optioneel) Privésleutel voor SSH-opdrachten.
ouder-taak-id nummer ID van oudertaak.
hostid nummer Doelhost-ID.

Voorbeeld:

server→proxy:

{
         "verzoek": "proxygegevens"
       }

proxy→server:

{
           "sessie": "12345678901234567890123456789012"
           "interfacebeschikbaarheid": [
               {
                   "interface-id": 1,
                   "beschikbaar": 1,
                   "fout": ""
           },
               {
                   "interface-id": 2,
                   "beschikbaar": 2,
                   "fout": "Kan geen waarde van agent ophalen: kan geen verbinding maken met [[127.0.0.1]:10049]: [111] Verbinding geweigerd"
           },
               {
                   "interface-id": 3,
                   "beschikbaar": 1,
                   "fout": ""
           },
               {
                   "interface-id": 4,
                   "beschikbaar": 1,
                   "fout": ""
           }
           ],
           "historische gegevens":[
               {
                   "item-id":"12345",
                   "tijdstempel":1478609647,
                   "ns":332510044,
                   "waarde":"52956612",
                   "id": 1
               },
               {
                   "item-id":"12346",
                   "tijdstempel":1478609647,
                   "ns":330690279,
                   "status":1,
                   "waarde":"Kan geen informatie vinden voor deze netwerkinterface in /proc/net/dev.",
                   "id": 2
               }
           ],
           "ontdekkingsgegevens":[
               {
                   "tijdstempel":1478608764,
                   "regel-id":2,
                   "controle-id":3,
                   "type":12,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               },
               {
                   "tijdstempel":1478608764,
                   "regel-id":2,
                   "controle-id":null,
                   "type":-1,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               }
           ],
           "automatische registratie":[
               {
                   "tijdstempel":1478608371,
                   "host":"Logger1",
                   "ip":"10.3.0.1",
                   "dns":"localhost",
                   "poort":"10050"
               },
               {
                   "tijdstempel":1478608381,
                   "host":"Logger2",
                   "ip":"10.3.0.2",
                   "dns":"localhost",
                   "poort":"10050"
               }
           ],
           "taken":[
               {
                   "type": 0,
                   "status": 0,
                   "ouder-taak-id": 10
               },
               {
                   "type": 0,
                   "status": 1,
                   "fout": "Geen rechten om taak uit te voeren.",
                   "ouder-taak-id": 20
               }
           ],
           "versie":"6.4.0"
       }

server→proxy:

{
         "antwoord": "geslaagd",
         "taken":[
             {
                "type": 1,
                "tijdstempel": 1478608371,
                "ttl": 600,
                "commandotype": 2,
                "commando": "herstart_service1.sh",
                "uitvoeren-op": 2,
                "poort": 80,
                "authtype": 0,
                "gebruikersnaam": "gebruikerA",
                "wachtwoord": "wachtwoord1",
                "publiekesleutel": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
                "privésleutel": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
                "ouder-taak-id": 10,
                "hostid": 10070
             },
             {
                "type": 1,
                "tijdstempel": 1478608381,
                "ttl": 600,
                "commandotype": 1,
                "commando": "herstart_service2.sh",
                "uitvoeren-op": 0,
                "authtype": 0,
                "gebruikersnaam": "",
                "wachtwoord": "",
                "publiekesleutel": "",
                "privésleutel": "",
                "ouder-taak-id": 20,
                "hostid": 10084
             }
         ]
       }

Actieve proxy

Configuratieverzoek

Het proxyconfig-verzoek wordt door de actieve proxy verzonden om proxyconfiguratiedata op te halen. Dit verzoek wordt elke ProxyConfigFrequency (proxyconfiguratieparameter) seconden verzonden.

naam waarde type omschrijving
proxy→server:
verzoek tekenreeks 'proxyconfig'
host tekenreeks Proxy-naam.
versie tekenreeks Proxyversie (<hoofd>.<secundair>.<build>).
sessie tekenreeks Tokensessie voor proxyconfiguratie.
configuratierevisie getal Proxyconfiguratierevisie.
server→proxy:
fullsync getal 1 - als volledige configuratiedata wordt verzonden, afwezig anders (optioneel).
gegevens reeks Object van tabelgegevens. Afwezig als de configuratie niet is gewijzigd (optioneel).
<tabel> object Een of meer objecten met gegevens van <tabel> (optioneel, afhankelijk van wijzigingen).
velden reeks Reeks veldnamen.
- tekenreeks Veldnaam.
gegevens reeks Reeks rijen.
- reeks Reeks kolommen.
- tekenreeks,getal Kolomwaarde met type afhankelijk van kolomtype in databaseschema.
macro.secrets object Geheime macro-informatie, afwezig als er geen wijzigingen zijn in verborgen macros (optioneel).
configuratierevisie getal Revisie van de configuratiecache - verzonden met configuratiegegevens (optioneel).
verwijderde_hostids reeks Reeks verwijderde host-ID's (optioneel).
- getal Host-identificatie.
verwijderde_macro_hostids reeks Reeks host-ID's waarbij alle macros zijn verwijderd (optioneel).
- getal Host-identificatie.

Voorbeeld:

proxy→server:

{
         "verzoek": "proxyconfig",
         "host": "Zabbix proxy",
         "versie":"6.4.0",
         "sessie": "fd59a09ff4e9d1fb447de1f04599bcf6",
         "configuratierevisie": 0
       }

server→proxy:

{
           "fullsync": 1,
           "gegevens": {
               "hosts": {
                   "velden": ["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"],
                   "gegevens": [
                       [10084, "Zabbix-server", 0, -1, 2, "", "", "Zabbix-server", 1, 1, "", "", "", ""]
                   ]
               },
               "interface": {
                   "velden": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"],
                   "gegevens": [
                       [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1]
                   ]
               },
               "interface_snmp": {
                   "velden": ["interfaceid", "versie", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextnaam"],
                   "gegevens": []
               },
               "host_inventory": {
                   "velden": ["hostid", "type", "type_volledig", "naam", "alias", "os", "os_volledig", "os_kort", "serienummer_a", "serienummer_b", "tag", "asset_tag", "macadres_a", "macadres_b", "hardware", "hardware_volledig", "software", "software_volledig", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contactpersoon", "locatie", "locatie_lat", "locatie_lon", "notities", "chassis", "model", "hw_architectuur", "leverancier", "contractnummer", "installateur_naam", "implementatiestatus", "url_a", "url_b", "url_c", "host_netwerken", "host_netmasker", "host_router", "oob_ip", "oob_netmasker", "oob_router", "datum_hw_aankoop", "datum_hw_installatie
       
       ", "datum_hw_verval", "datum_hw_buitengebruik", "site_adres_a", "site_adres_b", "site_adres_c", "site_stad", "site_provincie", "site_land", "site_postcode", "site_rack", "site_notities", "poc_1_naam", "poc_1_e-mail", "poc_1_telefoon_a", "poc_1_telefoon_b", "poc_1_mobiel", "poc_1_scherm", "poc_1_notities", "poc_2_naam", "poc_2_e-mail", "poc_2_telefoon_a", "poc_2_telefoon_b", "poc_2_mobiel", "poc_2_scherm", "poc_2_notities"],
                   "gegevens": [
                       [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56,95387", "24,22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""]
                   ]
               },
               "items": {
                   "velden": ["itemid", "type", "snmp_oid", "hostid", "sleutel_", "vertraging", "geschiedenis", "status", "waardetype", "trapper_hosts", "logtimefmt", "parameters", "ipmi_sensor", "authtype", "gebruikersnaam", "wachtwoord", "publiekesleutel", "privatesleutel", "vlaggen", "interfaceid", "inventory_koppeling", "jmx_endpoint", "master_itemid", "timeout", "url", "query_velden", "posts", "status_codes", "volg_redirects", "post_type", "http_proxy", "headers", "haalmodus_op", "verzoeksmethode", "uitvoerformaat", "ssl_certificaat_bestand", "ssl_sleutel_bestand", "ssl_sleutel_wachtwoord", "verifieer_peer", "verifieer_host", "sta_traps_toe"],
                   "gegevens": [
                       [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": {
                   "velden": ["itemid", "laatste_logbestandgrootte", "mtime"],
                   "gegevens": [
                       [44161, 0, 0],
                       [44162, 0, 0]
                   ]
               },
               "item_preproc": {
                   "velden": ["item_preprocid", "itemid", "stap", "type", "parameters", "foutafhandelaar", "foutafhandelaar_parameters"],
                   "gegevens": []
               },
               "item_parameter": {
                   "velden": ["item_parameterid", "itemid", "naam", "waarde"],
                   "gegevens": []
               },
               "globalmacro": {
                   "velden": ["globalmacroid", "macro", "waarde", "type"],
                   "gegevens": [
                       [2, "{$SNMP_COMMUNITY}", "public", 0]
                   ]
               },
               "hosts_templates": {
                   "velden": ["hosttemplateid", "hostid", "templateid", "link_type"],
                   "gegevens": []
               },
               "hostmacro": {
                   "velden": ["hostmacroid", "hostid", "macro", "waarde", "type", "automatisch"],
                   "gegevens": [
                       [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0]
                   ]
               },
               "drules": {
                   "velden": ["druleid", "naam", "ipbereik", "vertraging"],
                   "gegevens": [
                       [2, "Lokaal netwerk", "127.0.0.1", "10s"]
                   ]
               },
               "dchecks": {
                   "velden": ["dcheckid", "druleid", "type", "sleutel_", "snmp_community", "poorten", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextnaam", "hostbron", "naam_bron"],
                   "gegevens": [
                       [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0]
                   ]
               },
               "regexps": {
                   "velden": ["regexpid", "naam"],
                   "gegevens": [
                       [1, "Bestandssystemen voor ontdekking"],
                       [2, "Netwerkinterfaces voor ontdekking"],
                       [3, "Opslagapparaten voor SNMP-ontdekking"],
                       [4, "Windows-servicenamen voor ontdekking"],
                       [5, "Windows-service-startstatussen voor ontdekking"]
                   ]
               },
               "expressions": {
                   "velden": ["expressionid", "regexpid", "uitdrukking", "uitdrukking_type", "exp_delimiter", "hoofdlettergevoelig"],
                   "gegevens": [
                       [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat
       
       32|zfs)$", 3, ",", 0],
                       [3, 3, "^(Fysiek geheugen|Virtueel geheugen|Geheugenbuffers|In cache opgeslagen geheugen|Wisselruimte)$", 4, ",", 1],
                       [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1],
                       [6, 5, "^(automatisch|automatisch uitgesteld)$", 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]ysteem$", 4, ",", 1],
                       [12, 2, "^Nu[0-9.]*$", 4, ",", 1]
                   ]
               },
               "config": {
                   "velden": ["configid", "snmptrap_logging", "hk_geschiedenis_globaal", "hk_geschiedenis", "autoreg_tls_accepteren"],
                   "gegevens": [
                       [1, 1, 0, "90d", 1]
                   ]
               },
               "httptest": {
                   "velden": ["httptestid", "naam", "vertraging", "agent", "authenticatie", "http_gebruiker", "http_wachtwoord", "hostid", "http_proxy", "herhalingen", "ssl_certificaat_bestand", "ssl_sleutel_bestand", "ssl_sleutel_wachtwoord", "verifieer_peer", "verifieer_host"],
                   "gegevens": []
               },
               "httptestitem": {
                   "velden": ["httptestitemid", "httptestid", "itemid", "type"],
                   "gegevens": []
               },
               "httptest_veld": {
                   "velden": ["httptest_veldid", "httptestid", "type", "naam", "waarde"],
                   "gegevens": []
               },
               "httpstap": {
                   "velden": ["httpstap_id", "httptestid", "naam", "nee", "url", "timeout", "posts", "vereist", "status_codes", "volg_redirects", "ophalen_modus", "post_type"],
                   "gegevens": []
               },
               "httpstapitem": {
                   "velden": ["httpstapitemid", "httpstap_id", "itemid", "type"],
                   "gegevens": []
               },
               "httpstap_veld": {
                   "velden": ["httpstap_veldid", "httpstap_id", "type", "naam", "waarde"],
                   "gegevens": []
               },
               "config_autoreg_tls": {
                   "velden": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"],
                   "gegevens": [
                       [1, "", ""]
                   ]
               }
           },
           "macro.secrets": {
               "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": {
                   "Content": "738"
               }
           },
           "configuratierevisie": 2
       }
Gegevensverzoek

Het proxygegevens-verzoek wordt door de proxy verzonden om gegevens over beschikbaarheid van hostinterfaces, geschiedenis, ontdekking en automatische registratie te verstrekken. Dit verzoek wordt elke DataSenderFrequency (proxy-configuratieparameter) seconden verzonden. Merk op dat een actieve proxy nog steeds elke seconde de Zabbix-server zal bevragen voor externe opdrachttaken (met een leeg proxygegevens-verzoek).

naam waardetype omschrijving
proxy→server:
verzoek tekenreeks 'proxygegevens'
host tekenreeks Proxynaam.
sessie tekenreeks Gegevenssessietoken.
interfacebeschikbaarheid reeks (optioneel) Reeks van gegevensobjecten voor interfacebeschikbaarheid.
interface-id nummer Interface-identificator.
beschikbaar nummer Interfacebeschikbaarheid:

0, INTERFACE_AVAILABLE_UNKNOWN - onbekend
1, INTERFACE_AVAILABLE_TRUE - beschikbaar
2, INTERFACE_AVAILABLE_FALSE - niet beschikbaar
fout tekenreeks Foutbericht van de interface of lege tekenreeks.
geschiedenisgegevens reeks (optioneel) Reeks van objecten voor geschiedenisgegevens.
item-id nummer Item-identificator.
tijd nummer Tijdstempel van itemwaarde (seconden).
ns nummer Tijdstempel van itemwaarde (nanoseconden).
waarde tekenreeks (optioneel) Itemwaarde.
id nummer Identificator van waarde (oplopende teller, uniek binnen één gegevenssessie).
tijdstempel nummer (optioneel) Tijdstempel van items van het logtype.
bron tekenreeks (optioneel) Waarde van gebeurtenislog-itembron.
ernst nummer (optioneel) Waarde van ernst van gebeurtenislog-item.
gebeurtenis-id nummer (optioneel) Waarde van gebeurtenis-id van gebeurtenislog-item.
toestand tekenreeks (optioneel) Itemtoestand:
0, ITEM_STATE_NORMAL
1, ITEM_STATE_NOTSUPPORTED
laatstelogbestandsgrootte nummer (optioneel) Laatste logbestandsgrootte van items van het logtype.
mtijd nummer (optioneel) Tijdstip van wijziging van items van het logtype.
ontdekkingsgegevens reeks (optioneel) Reeks van objecten voor ontdekkingsgegevens.
tijd nummer Tijdstempel voor ontdekkingsgegevens.
drule-id nummer Identificator van ontdekkingsregel.
dcheck-id nummer Identificator van ontdekkingscontrole of null voor gegevens van ontdekkingsregel.
type nummer Type ontdekkingscontrole:

-1 gegevens van ontdekkingsregel
0, SVC_SSH - SSH-servicestatuscontrole
1, SVC_LDAP - LDAP-servicestatuscontrole
2, SVC_SMTP - SMTP-servicestatuscontrole
3, SVC_FTP - FTP-servicestatuscontrole
4, SVC_HTTP - HTTP-servicestatuscontrole
5, SVC_POP - POP-servicestatuscontrole
6, SVC_NNTP - NNTP-servicestatuscontrole
7, SVC_IMAP - IMAP-servicestatuscontrole
8, SVC_TCP - Controle beschikbaarheid TCP-poort
9, SVC_AGENT - Zabbix-agent
10, SVC_SNMPv1 - SNMPv1-agent
11, SVC_SNMPv2 - SNMPv2-agent
12, SVC_ICMPPING - ICMP-ping
13, SVC_SNMPv3 - SNMPv3-agent
14, SVC_HTTPS - HTTPS-servicestatuscontrole
15, SVC_TELNET - Beschikbaarheidscontrole Telnet
ip tekenreeks Host-IP-adres.
dns tekenreeks DNS-naam van host.
poort nummer (optioneel) Servicenummer van poort.
sleutel tekenreeks (optioneel) Itemcode voor ontdekkingscontrole van type 9 SVC_AGENT
waarde tekenreeks (optioneel) Waarde ontvangen van de service, kan leeg zijn voor de meeste services.
status nummer (optioneel) Servicestatus:

0, DOBJECT_STATUS_UP - Service UP
1, DOBJECT_STATUS_DOWN - Service DOWN
automatische registratie reeks (optioneel) Reeks van objecten voor automatische registratie.
tijd nummer Tijdstempel voor automatische registratiegegevens.
host tekenreeks Hostnaam.
ip tekenreeks (optioneel) IP-adres van host.
dns tekenreeks (optioneel) Opgeloste DNS-naam van IP-adres.
poort tekenreeks (optioneel) Hostpoort.
host-metadata tekenreeks (optioneel) Hostmetadata verzonden door agent (gebaseerd op HostMetadata of HostMetadataItem-agentconfiguratieparameter).
taken reeks (optioneel) Reeks van taken.
type nummer Taaktype:

0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - resultaat van externe opdrachtverwerking
status nummer Uitvoeringsstatus van externe opdracht:

0, ZBX_TM_REMOTE_COMMAND_COMPLETED - externe opdracht met succes uitgevoerd
1, ZBX_TM_REMOTE_COMMAND_FAILED - externe opdracht mislukt
fout tekenreeks (optioneel) Foutmelding.
ouder_taak-id nummer ID van bovenliggende taak.
meer nummer (optioneel) 1 - er zijn meer geschiedenisgegevens om te verzenden
tijd nummer (optioneel) Tijdstempel voor gegevensoverdracht (seconden).
ns nummer (optioneel) Tijdstempel voor gegevensoverdracht (nanoseconden).
versie tekenreeks Proxyversie (<hoofd>.<sub>.<bouw>).
server→proxy:
reactie tekenreeks Informatie over het succes van het verzoek ('success' of 'failed').
upload tekenreeks Uploadcontrole voor historische gegevens (geschiedenis, automatische registratie, hostbeschikbaarheid, netwerkontdekking).

Mogelijke waarden:
ingeschakeld - normale werking
uitgeschakeld - server accepteert geen gegevens (mogelijk vanwege interne cache boven limiet)
taken reeks (optioneel) Reeks van taken.
type nummer Taaktype:

1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - externe opdracht
tijd nummer Tijd van taakcreatie.
ttl nummer Tijd in seconden na afloop van de taak.
commandotype nummer Type externe opdracht:

0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - aangepast script gebruiken
1, ZBX_SCRIPT_TYPE_IPMI - IPMI gebruiken
2, ZBX_SCRIPT_TYPE_SSH - SSH gebruiken
3, ZBX_SCRIPT_TYPE_TELNET - Telnet gebruiken
4, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT - globaal script gebruiken (op dit moment functioneel equivalent met aangepast script)
opdracht tekenreeks Externe opdracht om uit te voeren.
uitvoeren_op nummer Uitvoeringstarget voor aangepaste scripts:

0, ZBX_SCRIPT_EXECUTE_ON_AGENT - script uitvoeren op agent
1, ZBX_SCRIPT_EXECUTE_ON_SERVER - script uitvoeren op server
2, ZBX_SCRIPT_EXECUTE_ON_PROXY - script uitvoeren op proxy
poort nummer (optioneel) Poort voor Telnet- en SSH-opdrachten.
authtype nummer (optioneel) Authenticatietype voor SSH-opdrachten.
gebruikersnaam tekenreeks (optioneel) Gebruikersnaam voor Telnet- en SSH-opdrachten.
wachtwoord tekenreeks (optioneel) Wachtwoord voor Telnet- en SSH-opdrachten.
publiekesleutel tekenreeks (optioneel) Openbare sleutel voor SSH-opdrachten.
privésleutel tekenreeks (optioneel) Privésleutel voor SSH-opdrachten.
ouder_taak-id nummer ID van bovenliggende taak.
host-id nummer Doelhost-ID.

Voorbeeld:

proxy→server:

{
           "verzoek": "proxygegevens",
           "host": "Zabbix-proxy",
           "sessie": "818cdd1b537bdc5e50c09ed4969235b6",
           "interfacebeschikbaarheid": [{
               "interface-id": 1,
               "beschikbaar": 1,
               "fout": ""
           }],
           "geschiedenisgegevens": [{
               "id": 1114,
               "item-id": 44162,
               "tijd": 1665730632,
               "ns": 798953105,
               "waarde": "1"
           }, {
               "id": 1115,
               "item-id": 44161,
               "tijd": 1665730633,
               "ns": 811684663,
               "waarde": "58"
           }],
           "automatische registratie": [{
               "tijd": 1665730633,
               "host": "Zabbix-server",
               "ip": "127.0.0.1",
               "dns": "localhost",
               "poort": "10053",
               "host-metadata": "58",
               "tls-geaccepteerd": 1
           }],
           "ontdekkingsgegevens": [{
               "tijd": 1665732232,
               
       
           "drule": 2,
                   "dcheck": 2,
                   "ip": "127.0.0.1",
                   "dns": "localhost",
                   "poort": 10052,
                   "status": 1
           }, {
               "tijd": 1665732232,
                   "drule": 2,
                   "dcheck": null,
                   "ip": "127.0.0.1",
                   "dns": "localhost",
                   "status": 1
           }],
           "hostgegevens": [{
               "host-id": 10084,
               "actieve-status": 1
           }],
           "taken": [{
               "type": 3,
               "tijd": 1665730985,
               "ttl": 0,
               "status": -1,
               "info": "Externe opdrachten zijn niet ingeschakeld",
               "ouder\_taak-id": 3
           }],
           "versie": "6.4.0",
           "tijd": 1665730643,
           "ns": 65389964
       }

server→proxy:

{
           "upload": "ingeschakeld",
           "reactie": "succes",
           "taken": [{
               "type": 2,
               "tijd": 1665730986,
               "ttl": 600,
               "commandotype": 0,
               "commando": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac",
               "uitvoeren\_op": 2,
               "poort": 0,
               "authtype": 0,
               "gebruikersnaam": "",
               "wachtwoord": "",
               "publiekesleutel": "",
               "privésleutel": "",
               "alert-id": 0,
               "ouder\_taak-id": 4,
               "host-id": 10084
           }]
       }