#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

Proxy configuratieaanvraag

De proxy config-aanvraag wordt door de server verzonden om proxyconfiguratiedata te verstrekken. Deze aanvraag wordt elke ProxyConfigFrequency (serverconfiguratieparameter) seconden verzonden.

naam waardetype omschrijving
server→proxy:
aanvraag string 'proxy config'
<tabel> object Een of meer objecten met <tabel>-gegevens.
velden array Array van veldnamen.
- string Veldnaam.
gegevens array Array van rijen.
- array Array van kolommen.
- string,nummer Kolomwaarde met het type afhankelijk van het kolomtype in het databaseschema.
proxy→server:
reactie string Informatie over het succes van de aanvraag ('success' of 'failed').
versie string Proxyversie (<major>.<minor>.<build>).

Voorbeeld:

server→proxy:

{
           "request": "proxy config",
           "globalmacro":{
               "fields":[
                   "globalmacroid",
                   "macro",
                   "value"
               ],
               "data":[
                   [
                       2,
                       "{$SNMP_COMMUNITY}",
                       "public"
                   ]
               ]
           },
           "hosts":{
               "fields":[
                   "hostid",
                   "host",
                   "status",
                   "ipmi_authtype",
                   "ipmi_privilege",
                   "ipmi_username",
                   "ipmi_password",
                   "name",
                   "tls_connect",
                   "tls_accept",
                   "tls_issuer",
                   "tls_subject",
                   "tls_psk_identity",
                   "tls_psk"
               ],
               "data":[
                   [
                       10001,
                       "Linux",
                       3,
                       -1,
                       2,
                       "",
                       "",
                       "Linux",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ],
                   [
                       10050,
                       "Zabbix Agent",
                       3,
                       -1,
                       2,
                       "",
                       "",
                       "Zabbix Agent",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ],
                   [
                       10105,
                       "Logger",
                       0,
                       -1,
                       2,
                       "",
                       "",
                       "Logger",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ]
               ]
           },
           "interface":{
               "fields":[
                   "interfaceid",
                   "hostid",
                   "main",
                   "type",
                   "useip",
                   "ip",
                   "dns",
                   "port",
                   "bulk"
               ],
               "data":[
                   [
                       2,
                       10105,
                       1,
                       1,
                       1,
                       "127.0.0.1",
                       "",
                       "10050",
                       1
                   ]
               ]
           },
           ...
       }

proxy→server:

{
         "response": "success",
         "version": "6.0.0"
       }
Proxyverzoek

Het proxygegevens-verzoek wordt gebruikt om hostinterfacebeschikbaarheid, historische gegevens, ontdekkings- en autoregistratiegegevens van de proxy te verkrijgen. Dit verzoek wordt elke ProxyDataFrequentie (serverconfiguratieparameter) seconden verzonden.

naam waardetype omschrijving
server→proxy:
verzoek string 'proxygegevens'
proxy→server:
sessie string Gegevenssessietoken.
interfacebeschikbaarheid reeks (optioneel) Reeks objecten voor interfacebeschikbaarheid.
interface-id nummer Interface-identificatie.
beschikbaar nummer Interface-beschikbaarheid:

0, INTERFACE_BESCHIKBAAR_ONBEKEND - onbekend
1, INTERFACE_BESCHIKBAAR_WAAR - beschikbaar
2, INTERFACE_BESCHIKBAAR_ONWAAR - niet beschikbaar
fout string Interface-foutbericht of lege string.
geschiedenisgegevens reeks (optioneel) Reeks objecten voor geschiedenisgegevens.
item-id nummer Itemidentificatie.
tijd nummer Tijdstempel van itemwaarde (seconden).
ns nummer Tijdstempel van itemwaarde (nanoseconden).
waarde string (optioneel) Itemwaarde.
id nummer Waarde-identificatie (oplopende teller, uniek binnen één gegevenssessie).
tijdstip nummer (optioneel) Tijdstempel van items van het type logboek.
bron string (optioneel) Bronwaarde van item in gebeurtenislogboek.
ernst nummer (optioneel) Ernstwaarde van item in gebeurtenislogboek.
gebeurtenis-id nummer (optioneel) Gebeurtenis-id-waarde van item in gebeurtenislogboek.
status string (optioneel) Itemstatus:
0, ITEM_STATUS_NORMAAL
1, ITEM_STATUS_NIET_ONDERSTEUND
laatstelogboekgrootte nummer (optioneel) Laatste logboekgrootte van items van het type logboek.
mtijd nummer (optioneel) Wijzigingstijd van items van het type logboek.
ontdekkingsgegevens reeks (optioneel) Reeks objecten voor ontdekkingsgegevens.
tijd nummer Tijdstempel van ontdekkingsgegevens.
drule-id nummer Identificatie van ontdekkingsregel.
dcheck-id nummer Identificatie van ontdekkingscontrole of null voor gegevens van ontdekkingsregel.
type nummer Type ontdekkingscontrole:

-1 gegevens van 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 - Beschikbaarheidscontrole van 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-servicecontrole
15, SVC_TELNET - Beschikbaarheidscontrole van Telnet
ip string Host IP-adres.
dns string Host DNS-naam.
poort nummer (optioneel) Servicenummer voor poort.
sleutel_ string (optioneel) Item sleutel 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_UP - Service actief
1, DOBJECT_STATUS_DOWN - Service inactief
autoregistratie reeks (optioneel) Reeks objecten voor autoregistratiegegevens.
tijd nummer Tijdstempel van autoregistratiegegevens.
host string Hostnaam.
ip string (optioneel) Host IP-adres.
dns string (optioneel) Opgeloste DNS-naam van IP-adres.
poort string (optioneel) Hostpoort.
host_metadata string (optioneel) Hostmetadata verzonden door de agent (op basis van HostMetadata of HostMetadataItem-agentconfiguratieparameter).
taken reeks (optioneel) Reeks taken.
type nummer Taaktype:

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

0, ZBX_TM_REMOTE_COMMAND_COMPLETED - externe opdracht succesvol voltooid
1, ZBX_TM_REMOTE_COMMAND_FAILED - externe opdracht mislukt
fout string (optioneel) Foutbericht.
ouder_taakid nummer Ouder taak-ID.
meer nummer (optioneel) 1 - er zijn meer geschiedenisgegevens om te verzenden.
tijd nummer (optioneel) Tijdstempel gegevensoverdracht (seconden).
ns nummer (optioneel) Tijdstempel gegevensoverdracht (nanoseconden).
versie string Proxyversie (<hoofd>.<sub>.<bouwen>).
server→proxy:
reactie string Informatie over het succes van het verzoek ('geslaagd' of 'mislukt').
taken reeks (optioneel) Reeks taken.
type nummer Taaktype:

1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - externe opdracht
tijd nummer Tijdstip waarop taak is gemaakt.
ttl nummer Tijd in seconden waarna 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 - algemeen script gebruiken (momenteel functioneel gelijk aan aangepast script)
commando string Externe opdracht om uit te voeren.
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) Openbare sleutel voor SSH-opdrachten.
privésleutel string (optioneel) Privésleutel voor SSH-opdrachten.
ouder_taakid nummer Ouder taak-ID.
hostid nummer Doelhost-ID.

Voorbeeld:

server→proxy:

{
         "request": "proxygegevens"
       }

proxy→server:

{
           "sessie": "12345678901234567890123456789012"
           "interfacebeschikbaarheid": [
               {
                   "interface-id": 1,
                   "beschikbaar": 1,
                   "fout": ""
               },
               {
                   "interface-id": 2,
                   "beschikbaar": 2,
                   "fout": "Kan waarde van agent niet 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": ""
               }
           ],
           "geschiedenisgegevens":[
               {
                   "item-id":"12345",
                   "tijd":1478609647,
                   "ns":332510044,
                   "waarde":"52956612",
                   "id": 1
               },
               {
                   "item-id":"12346",
                   "tijd":1478609647,
                   "ns":330690279,
                   "status":1,
                   "waarde":"Kan geen informatie vinden voor deze netwerkinterface in /proc/net/dev.",
                   "id": 2
               }
           ],
           "ontdekkingsgegevens":[
               {
                   "tijd":1478608764,
                   "drule":2,
                   "dcheck":3,
                   "type":12,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               },
               {
                   "tijd":1478608764,
                   "drule":2,
                   "dcheck":null,
                   "type":-1,
                   "ip":"10.3.0.10",
                   "dns":"vdebian",
                   "status":1
               }
           ],
           "autoregistratie":[
               {
                   "tijd":1478608371,
                   "host":"Logger1",
                   "ip":"10.3.0.1",
                   "dns":"localhost",
                   "poort":"10050"
               },
               {
                   "tijd":1478608381,
                   "host":"Logger2",
                   "ip":"10.3.0.2",
                   "dns":"localhost",
                   "poort":"10050"
               }
           ],
           "taken":[
               {
                   "type": 0,
                   "status": 0,
                   "ouder_taakid": 10
               },
               {
                   "type": 0,
                   "status": 1,
                   "fout": "Geen toestemming om taak uit te voeren.",
                   "ouder_taakid": 20
               }
           ],    
           "versie":"5.4.0"
       }

server→proxy:

{
         "reactie": "geslaagd",
         "taken":[
             {
                "type": 1,
                "tijd": 1478608371,
                "ttl": 600,
                "commandotype": 2,
                "commando": "restart_service1.sh",
                "uitvoeren_op": 2,
                "poort": 80,
                "authtype": 0,
                "gebruikersnaam": "userA",
                "wachtwoord": "wachtwoord1",
                "publiekesleutel": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
                "privésleutel": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
                "ouder_taakid": 10,
                "hostid": 10070
             },
             {
                "type": 1,
                "tijd": 1478608381,
                "ttl": 600,
                "commandotype": 1,
                "commando": "restart_service2.sh",
                "uitvoeren_op": 0,
                "authtype": 0,
                "gebruikersnaam": "",
                "wachtwoord": "",
                "publiekesleutel": "",
                "privésleutel": "",
                "ouder_taakid": 20,
                "hostid": 10084
             }
         ]
       }

Actieve proxy

Proxy hartslagverzoek

Het proxy hartslag-verzoek wordt door de proxy verzonden om te melden dat de proxy actief is. Dit verzoek wordt elke HartslagFrequentie (proxy configuratieparameter) seconden verzonden.

naam waardetype omschrijving
proxy→server:
verzoek string 'proxy hartslag'
host string Proxy naam.
versie string Proxyversie (<hoofd>.<sub>.<bouwen>).
server→proxy:
reactie string Informatie over het succes van het verzoek ('geslaagd' of 'mislukt').

proxy→server:

{
          "verzoek": "proxy hartslag",
          "host": "Proxy #12",
          "versie": "5.4.0"
       }

server→proxy:

{
         "reactie": "geslaagd"
       }
Proxy configuratieverzoek

Het proxy configuratie-verzoek wordt door de proxy verzonden om proxyconfiguratiedata op te halen. Dit verzoek wordt elke ConfiguratieFrequentie (proxy configuratieparameter) seconden verzonden.

naam waardetype omschrijving
proxy→server:
verzoek string 'proxy configuratie'
host string Proxy naam.
versie string Proxyversie (<hoofd>.<sub>.<bouwen>).
server→proxy:
verzoek string 'proxy configuratie'
<tabel> object Een of meer objecten met gegevens van <tabel>.
velden reeks Reeks met veldnamen.
- string Veldnaam.
data reeks Reeks met rijen.
- reeks Reeks met kolommen.
- string,nummer Kolomwaarde met type afhankelijk van het kolomtype in databaseschema.
proxy→server:
reactie string Informatie over het succes van het verzoek ('geslaagd' of 'mislukt').

Voorbeeld:

proxy→server:

{
         "verzoek": "proxy configuratie",
         "host": "Proxy #12",
         "versie":"5.4.0"
       }

server→proxy:

{
           "globalmacro":{
               "velden":[
                   "globalmacroid",
                   "macro",
                   "waarde"
               ],
               "data":[
                   [
                       2,
                       "{$SNMP_COMMUNITY}",
                       "public"
                   ]
               ]
           },
           "hosts":{
               "velden":[
                   "hostid",
                   "host",
                   "status",
                   "ipmi_authtype",
                   "ipmi_privilege",
                   "ipmi_gebruikersnaam",
                   "ipmi_wachtwoord",
                   "naam",
                   "tls_connect",
                   "tls_accept",
                   "tls_uitgever",
                   "tls_subject",
                   "tls_psk_identity",
                   "tls_psk"
               ],
               "data":[
                   [
                       10001,
                       "Linux",
                       3,
                       -1,
                       2,
                       "",
                       "",
                       "Linux",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ],
                   [
                       10050,
                       "Zabbix Agent",
                       3,
                       -1,
                       2,
                       "",
                       "",
                       "Zabbix Agent",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ],
                   [
                       10105,
                       "Logger",
                       0,
                       -1,
                       2,
                       "",
                       "",
                       "Logger",
                       1,
                       1,
                       "",
                       "",
                       "",
                       ""
                   ]
               ]
           },
           "interface":{
               "velden":[
                   "interface-id",
                   "hostid",
                   "hoofd",
                   "type",
                   "useip",
                   "ip",
                   "dns",
                   "poort",
                   "bulk"
               ],
               "data":[
                   [
                       2,
                       10105,
                       1,
                       1,
                       1,
                       "127.0.0.1",
                       "",
                       "10050",
                       1
                   ]
               ]
           },
           ...
       }

proxy→server:

{
         "reactie": "geslaagd"
       }


       ##### Proxy gegevensaanvraag

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

       |naam|<|gegevenstype|beschrijving|
       |-|----------|----------|----------------------------------------|
       |proxy→server:|<|<|<|
       |**verzoek**|<|*tekenreeks*|'proxy gegevens'|
       |**host**|<|*tekenreeks*|Proxy naam.|
       |**sessie**|<|*tekenreeks*|Gegevenssessietoken.|
       |**interface beschikbaarheid**|<|*reeks*|*(optioneel)* Array van gegevensobjecten voor interfacebeschikbaarheid.|
       | |**interfaceid**|*nummer*|Interface-identificatie.|
       |^|**beschikbaar**|*nummer*|Interfacebeschikbaarheid:

**0**, *INTERFACE\_BESCHIKBAARHEID\_ONBEKEND* - onbekend
**1**, *INTERFACE\_BESCHIKBAARHEID\_WAAR* - beschikbaar
**2**, *INTERFACE\_BESCHIKBAARHEID\_ONWAAR* - niet beschikbaar| |^|**fout**|*tekenreeks*|Interfacefoutmelding of lege tekenreeks.| |**geschiedenisgegevens**|<|*reeks*|*(optioneel)* Array van objecten voor geschiedenisgegevens.| | |**itemid**|*nummer*|Item-identificatie.| |^|**klok**|*nummer*|Tijdstempel van itemwaarde (seconden).| |^|**ns**|*nummer*|Tijdstempel van itemwaarde (nanoseconden).| |^|**waarde**|*tekenreeks*|*(optioneel)* Itemwaarde.| |^|**id**|*nummer*|Waarde-identificatie (oplopende teller, uniek binnen één gegevenssessie).| |^|**tijdstempel**|*nummer*|*(optioneel)* Tijdstempel van items van het logboektype.| |^|**bron**|*tekenreeks*|*(optioneel)* Bronwaarde van item in gebeurtenislogboek.| |^|**ernst**|*nummer*|*(optioneel)* Ernstwaarde van item in gebeurtenislogboek.| |^|**gebeurtenisid**|*nummer*|*(optioneel)* Gebeurtenis-id-waarde van item in gebeurtenislogboek.| |^|**status**|*tekenreeks*|*(optioneel)* Itemstatus:
**0**, *ITEM\_STATUS\_NORMAAL*
**1**, *ITEM\_STATUS\_NIET\_ONDERSTEUND*| |^|**laatsteloggrootte**|*nummer*|*(optioneel)* Laatste logboekgrootte van items van het logboektype.| |^|**mtime**|*nummer*|*(optioneel)* Wijzigingstijd van items van het logboektype.| |**ontdekkingsgegevens**|<|*reeks*|*(optioneel)* Array van objecten voor ontdekkingsgegevens.| | |**klok**|*nummer*|Tijdstempel van ontdekkingsgegevens.| |^|**druleid**|*nummer*|Identificatie van ontdekkingsregel.| |^|**dcheckid**|*nummer*|Identificatie van ontdekkingscontrole of null voor ontdekkingsregelgegevens.| |^|**type**|*nummer*|Type ontdekkingscontrole:

**-1** ontdekkingsregelgegevens
**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**|*tekenreeks*|Host IP-adres.| |^|**dns**|*tekenreeks*|Host DNS-naam.| |^|**poort**|*nummer*|*(optioneel)* Servicenummer.| |^|**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| |**zelfregistratie**|<|*reeks*|*(optioneel)* Array van objecten voor zelfregistratiegegevens.| | |**klok**|*nummer*|Tijdstempel van zelfregistratiegegevens.| |^|**host**|*tekenreeks*|Hostnaam.| |^|**ip**|* tekenreeks*|*(optioneel)* Host IP-adres.| |^|**dns**|*tekenreeks*|*(optioneel)* Uit IP-adres opgeloste DNS-naam.| |^|**poort**|*tekenreeks*|*(optioneel)* Hostpoort.| |^|**host\_metadata**|*tekenreeks*|*(optioneel)* Hostmetadata verzonden door de agent (gebaseerd op HostMetadata of HostMetadataItem agent configuratieparameter).| |**taken**|<|*reeks*|*(optioneel)* Array 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\_VOLTOOID* - externe opdracht succesvol voltooid
**1**, *ZBX\_TM\_REMOTE\_COMMAND\_MISLUKT* - externe opdracht mislukt| |^|**fout**|*tekenreeks*|*(optioneel)* Foutmelding.| |^|**ouder\_taakid**|*nummer*|Ouder taak-ID.| |**meer**|<|*nummer*|*(optioneel)* 1 - er zijn meer geschiedenisgegevens te verzenden.| |**klok**|<|*nummer*|*(optioneel)* Tijdstempel gegevensoverdracht (seconden).| |**ns**|<|*nummer*|*(optioneel)* Tijdstempel gegevensoverdracht (nanoseconden).| |**versie**|<|*tekenreeks*|Proxyversie (<hoofd>.<sub>.<bouw>).| |server→proxy:|<|<|<| |**reactie**|<|*tekenreeks*|Informatie over het succes van het verzoek ('succes' of 'mislukt').| |**upload**|<|*tekenreeks*|Uploadbeheer voor historische gegevens (geschiedenis, zelfregistratie, hostbeschikbaarheid, netwerkontdekking).

Mogelijke waarden:
**ingeschakeld** - normale werking
**uitgeschakeld** - server accepteert geen gegevens (mogelijk vanwege interne cache-overlimiet)| |**taken**|<|*reeks*|*(optioneel)* Array van taken.| | |**type**|*nummer*|Taaktype:

**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - externe opdracht verwerken| |^|**klok**|*nummer*|Tijd van taakcreatie.| |^|**ttl**|*nummer*|Tijd in seconden waarna de taak verloopt.| |^|**commandtype**|*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 equivalent aan aangepast script)| |^|**command**|*tekenreeks*|Externe opdracht om uit te voeren.| |^|**uitvoeren\_op**|*nummer*|Uitvoeringsdoel voor aangepaste scripts:

**0**, *ZBX\_SCRIPT\_UITVOEREN\_OP\_AGENT* - script uitvoeren op agent
**1**, *ZBX\_SCRIPT\_UITVOEREN\_OP\_SERVER* - script uitvoeren op server
**2**, *ZBX\_SCRIPT\_UITVOEREN\_OP\_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\_taakid**|*nummer*|Ouder taak-ID.| |^|**hostid**|*nummer*|Doelhost-ID.| proxy→server: ``` {.javascript} { "request": "proxy data", "host": "Proxy #12", "session": "12345678901234567890123456789012", "interface beschikbaarheid": [ { "interface-id": 1, "beschikbaar": 1, "fout": "" }, { "interface-id": 2, "beschikbaar": 2, "fout": "Waarde ophalen van agent is mislukt: 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": "" } ], "geschiedenis gegevens":[ { "itemid":"12345", "klok":1478609647, "ns":332510044, "waarde":"52956612", "id": 1 }, { "itemid":"12346", "klok":1478609647, "ns":330690279, "toestand":1, "waarde":"Kan geen informatie vinden voor deze netwerkinterface in /proc/net/dev.", "id": 2 } ], "ontdekkingsgegevens":[ { "klok":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "klok":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "zelfregistratie":[ { "klok":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "poort":"10050" }, { "klok":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "poort":"10050" } ], "taken":[ { "type": 2, "klok":1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "uitvoeren_op": 2, "poort": 80, "authtype": 0, "gebruikersnaam": "userA", "wachtwoord": "wachtwoord1", "publiekesleutel": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privésleutel": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "ouder_taakid": 10, "hostid": 10070 }, { "type": 2, "klok":1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "uitvoeren_op": 0, "authtype": 0, "gebruikersnaam": "", "wachtwoord": "", "publiekesleutel": "", "privésleutel": "", "ouder_taakid": 20, "hostid": 10084 } ], "taken":[ { "type": 0, "status": 0, "ouder_taakid": 10 }, { "type": 0, "status": 1, "fout": "Geen rechten om taak uit te voeren.", "ouder_taakid": 20 } ], "versie":"5.4.0" }

server→proxy:

{
         "reactie": "succes",
         "upload": "ingeschakeld",
         "taken":[
             {
                "type": 1,
                "klok": 1478608371,
                "ttl": 600,
                "commandtype": 2,
                "command": "restart_service1.sh",
                "uitvoeren_op": 2,
                "poort": 80,
                "authtype": 0,
                "gebruikersnaam": "userA",
                "wachtwoord": "wachtwoord1",
                "publiekesleutel": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
                "privésleutel": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
                "ouder_taakid": 10,
                "hostid": 10070
             },
             {
                "type": 1,
                "klok": 1478608381,
                "ttl": 600,
                "commandtype": 1,
                "command": "restart_service2.sh",
                "uitvoeren_op": 0,
                "authtype": 0,
                "gebruikersnaam": "",
                "wachtwoord": "",
                "publiekesleutel": "",
                "privésleutel": "",
                "ouder_taakid": 20,
                "hostid": 10084
             }
         ]
       }