29.6. DNS diagnostics, statistics and debug

29.6. DNS diagnostics, statistics and debug
	Chapter 29. DNS - Domain Name System

29.6.1. DNS diagnostics

The following commands are used to display the diagnostics of the DNS resource:

d d dns / d de dns: It informs about the state of the resource, the state of the CACHE, the RELAY and the SERVER mode, the number of records currently occupied with pending requests (for CACHE, RELAY and SERVER), the maximum number of simultaneously pending records ever reached (for CACHE, RELAY and SERVER) and the maximum number of simultaneously pending requests (for CACHE, RELAY and SERVER).

[17:49:20] ABILIS_CPX:d d dns

RES:Dns -----------------------------------------------------------------------
       Domain_Name_System                                                      
       STATE:READY     PRI-SERVER:008.008.008.008  SEC-SERVER:008.008.004.004
       ----------------|-- STATE --|--- CUR ---|-- PEAK ---|--- MAX ---|
       CACHE           |READY      |        140|        888|       5000|
       RELAY           |READY      |          0|        500|        500|
       RELAY-BLACKLIST |READY      |         33|          -|       2000|
       SERVER          |READY      |           |           |           |
       -----------------------------------------------------------------

29.6.2. DNS statistics

To display the statistics of the DNS resource the following commands are used:

d s dns / d se dns: Statistics are divided between Resolver and Relay mode and between Primary (PRI-) and Secondary (SEC-) DNS server. For Resolver mode is shown statistics such as the number of queries, resolved hostname, unknown hostname, etc... For Relay mode are shown statistics such as the number of total and succesful clients' requests, the number of clients' requests discarded because the table was full or the source IP was not allowed, etc.

[11:42:10] ABILIS_CPX:d s dns

RES:Dns -----------------------------------------------------------------------
       Domain_Name_System                                                      
       --- Cleared 0 days 17:01:01 ago, on 28/05/2015 at 19:48:22 -------------
       - Resolver -------------------------------------------------------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       PRI-QUERIES|           |         36|SEC-QUERIES|           |         24|
       PRI-RES    |          4|           |SEC-RES    |          0|           |
       PRI-UNK    |          0|           |SEC-UNK    |          0|           |
       PRI-RTY-OVR|          0|           |SEC-RTY_OVR|          0|           |
       PRI-TOUT   |         32|           |SEC-TOUT   |         24|           |
       PRI-ERRORS |          0|           |SEC-ERRORS |          0|           |
       ------------------------------------------------------------------------
       - Relay ----------------------------------------------------------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       REQ-TOTAL  |      58557|           |PRI-REQ-RSP|       2783|       7978|
       REQ-SUCC   |      44655|           |SEC-REQ-RSP|       1065|       5187|
       REQ-BAD    |          3|           |PRI-NOMATCH|       2771|           |
       OVERFLOW   |       9752|           |SEC-NOMATCH|       2771|           |
       DROP-ACCESS|         17|           |RSP-BAD    |         13|           |
       ------------------------------------------------------------------------

29.6.3. DNS debug

Type the following command to view the commands allowed:

[15:03:49] ABILIS_CPX:debug res:dns

RES:Dns -----------------------------------------------------------------------
       Domain_Name_System                                                      
       BufferLength:64512  Date/Time:02/08/2016 15:03:53 TraceTime:99775682

Usage:
   LSN:0                = This help
   LSN:1                = Local statistics
   LSN:2 CMD:<name>     = Query: A (direct name lookup)
   LSN:3 CMD:<ipadd>    = Query: PTR (reverse ip lookup)
   LSN:4 CMD:<name>     = Query: MX (mail exchange)
   LSN:5 CMD:<ipadd>    = Query: MX (mail exchange)
   LSN:9                = Show DNS server's addresses

   LSN:20               = Load the blacklist from the file
   LSN:21               = Save the blacklist into the file
   LSN:22 CMD:<PAGE>    = Show the DNS blacklist table PAGE (1...9)
   LSN:23 CMD:<domain>  = Add the <domain> to the blacklist
   LSN:24 CMD:<domain>  = Remove the <domain> from the blacklist
   LSN:25 CMD:<FQDN>    = Test the FQDN against the blacklist
   LSN:29               = Print blacklist status

   LSN:40 CMD:<PAGE>    = Show the FQDN log table PAGE (1...9)
   LSN:41 CMD:<PAGE>    = Show the FQDN log table PAGE (1...9) with ageing order
   LSN:42 CMD:<PAGE>    = Show the FQDN log hash table PAGE (1...9)
   LSN:43 CMD:<FQDN>    = Add the <FQDN> to the log table
   LSN:47               = Clear FQDN log list
   LSN:48               = Show FQDN log statistics
   LSN:49               = Clear FQDN log statistics

	Note
	To use these commands you need to have administrator or super user rights.

Example: Type the following command to do a reverse IP lookup query.

[15:03:53] ABILIS_CPX:debug res:dns lsn:3 cmd:8.8.8.8

RES:Dns -----------------------------------------------------------------------
       Domain_Name_System                                                      
       BufferLength:64512  Date/Time:02/08/2016 15:05:09 TraceTime:99852319

Host: 8.8.8.8
Name: google-public-dns-a.google.com


29.5. DNS Blacklist (Web filter)		Chapter 30. DDNS - Dynamic DNS