Documentation
Table of Contents
17 Return values for net.dns.get
Overview
This section provides return value details for the net.dns.get Zabbix agent 2 item.
Details
The output of this item is an object containing DNS record information based on the parameters provided in the item key.
For example, the net.dns.get[,example.com] item may return the following JSON of a refused query:
{
"flags": [
"RA"
],
"query_time": "0.00",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "SOA"
}
],
"response_code": "REFUSED",
"zbx_error_code": 0
}By specifying the IP address of the DNS server, the net.dns.get[192.0.2.0,example.com] item may return the following JSON:
{
"answer_section": [
{
"class": "IN",
"name": "example.com.",
"rdata": {
"expire": 1209600,
"mbox": "noc.dns.example.org.",
"minttl": 3600,
"ns": "ns.example.org.",
"refresh": 7200,
"retry": 3600,
"serial": 2022091378
},
"rdlength": 44,
"ttl": 1205,
"type": "SOA"
}
],
"flags": [
"RA"
],
"query_time": "0.02",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "SOA"
}
],
"response_code": "NOERROR",
"zbx_error_code": 0
}If there is a connection problem, the net.dns.get[192.0.2.0,example.com] item may an error:
{
"zbx_error_code": -1,
"zbx_error_msg": "Communication error: read udp 192.0.2.0:12345->192.0.2.0:53: i/o timeout"
}The following types of error codes are possible:
| Scenario | "zbx_error_code" | "zbx_error_msg" |
|---|---|---|
| No errors and the DNS response was received and parsed. | 0 | |
| DNS is down. | -1 | "Communication error" |
| Error occurs during JSON parsing | -2 | "Received unexpected response" |
With additional parameters, the net.dns.get[192.0.2.0,example.com,ANY,5,5,tcp,"cdflag,rdflag,dnssec,nsid,edns0,aaflag,adflag"] item may return the following JSON:
{
"additional_section": [
{
"extended_rcode": 32768,
"name": ".",
"rdata": {
"options": [
{
"code": 0,
"nsid": "67 70 64 6e 73 2d 6c 70 70"
}
]
},
"rdlength": 13,
"type": "OPT",
"udp_payload": 512
}
],
"answer_section": [
{
"class": "IN",
"name": "example.com.",
"rdata": {
"a": "192.0.2.0"
},
"rdlength": 4,
"ttl": 19308,
"type": "A"
},
{
"class": "IN",
"name": "example.com.",
"rdata": {
"algorithm": 13,
"expiration": 1704715951,
"inception": 1702910624,
"key_tag": 21021,
"labels": 2,
"orig_ttl": 86400,
"signature": "HVBOBcJJQy0S08J3f8kviPj8UkEUj7wmyiMyQqPSWgQIY9SCEJ5plq6KuxJmtAek1txZWXDo+6tpIC6DIVBnuw==",
"signer_name": "example.com.",
"type_covered": "A"
},
"rdlength": 95,
"ttl": 19308,
"type": "RRSIG"
}
],
"flags": [
"RD",
"RA",
"AD",
"CD"
],
"query_time": "0.05",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "ANY"
}
],
"response_code": "NOERROR",
"zbx_error_code": 0
}See also
For more information about DNS records, see: