Esta sección proporciona detalles sobre los valores de retorno para la métrica net.dns.get del agente Zabbix 2.
La salida de esta métrica es un objeto que contiene información de registros DNS basada en los parámetros proporcionados en la clave de la métrica.
Por ejemplo, la métrica net.dns.get[,example.com] puede devolver el siguiente JSON de una consulta rechazada:
{
"flags": [
"RA"
],
"query_time": "0.019030",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "SOA"
}
],
"response_code": "REFUSED",
"zbx_error_code": 0
}Al especificar la dirección IP del servidor DNS, la métrica net.dns.get[192.0.2.0,example.com] puede devolver el siguiente 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.029556",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "SOA"
}
],
"response_code": "NOERROR",
"zbx_error_code": 0
}Si hay un problema de conexión, la métrica net.dns.get[192.0.2.0,example.com] puede devolver un 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"
}Los siguientes tipos de códigos de error son posibles:
| Escenario | "zbx_error_code" | "zbx_error_msg" |
|---|---|---|
| Sin errores y la respuesta DNS fue recibida y analizada. | 0 | |
| El DNS está caído. | -1 | "Communication error" |
| Ocurre un error durante el análisis de JSON | -2 | "Received unexpected response" |
Con parámetros adicionales, la métrica net.dns.get[192.0.2.0,example.com,ANY,5,5,tcp,"cdflag,rdflag,dnssec,nsid,edns0,aaflag,adflag"] puede devolver el siguiente 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.058221",
"question_section": [
{
"qclass": "IN",
"qname": "example.com.",
"qtype": "ANY"
}
],
"response_code": "NOERROR",
"zbx_error_code": 0
}Para obtener más información sobre los registros DNS, consulte: