#1 Server-proxy data-uitwisselingsprotocol
Server - uitwisseling van proxy gegevens is gebaseerd op JSON-indeling.
Verzoek- en antwoordberichten moeten beginnen met header and data lengte.
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:
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
}
]
}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
}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
}]
}