17 net.dns.getの戻り値

概要

このセクションでは、Zabbix エージェント 2 アイテムの net.dns.get の戻り値の詳細について説明します。

詳細

このアイテムの出力は、アイテムキーで指定されたパラメータに基づいた DNS レコード情報を含むオブジェクトです。

例えば、net.dns.get[,example.com] 項目は、拒否されたクエリの次の JSON を返す場合があります。:

{
    "flags": [
    "RA"
    ],
    "query_time": "0.019030",
    "question_section": [
    {
    "qclass": "IN",
    "qname": "example.com.",
    "qtype": "SOA"
    }
    ],
    "response_code": "REFUSED",
    "zbx_error_code": 0
}

DNS サーバーの IP アドレスを指定すると、net.dns.get[192.0.2.0,example.com] 項目は次の 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
}

接続に問題がある場合は、 net.dns.get[192.0.2.0,example.com] 項目でエラーが発生する可能性があります:

{
    "zbx_error_code": -1,
    "zbx_error_msg": "Communication error: read udp 192.0.2.0:12345->192.0.2.0:53: i/o timeout"
}

以下の種類のエラーコードが考えられます:

シナリオ "zbx_error_code" "zbx_error_msg"
エラーはなく、DNS 応答を受信して解析しました。 0
DNS がダウンしています。 -1 "通信エラー"
JSON 解析中にエラーが発生しました -2 "予期しない応答を受信しました"

追加パラメータを指定すると、net.dns.get[192.0.2.0,example.com,ANY,5,5,tcp,"cdflag,rdflag,dnssec,nsid,edns0,aaflag,adflag"] 項目は次の 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
}

参照

DNSレコードの詳細については、以下を参照してください。