Documentation
Table of Contents
#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:
proxy→server:
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:
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:
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 }] }