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レコードの詳細については、以下を参照してください。

Documentation

17 net.dns.getの戻り値

概要

詳細

参照