/
Run & Test Configuration
Document toolboxDocument toolbox

Run & Test Configuration

Owned by Shirly Tsang
May 23, 2024
3 min read

Let’s run our new configuration. 

First, we need to run dnstap-receiver with the config file created in the dnstap-receiver Configuration section of this document. Run this command on the Ubuntu VM during the entire time you wish to collect dnstap messages from NIOS.

  1. Open a terminal.

  2. Run dnstap-receiver using the config file as a parameter: 

dnstap_receiver -c /etc/dnstap-receiver/dnstap.conf

The console will tell you if there are syntax errors with your config file.

 

Let’s run a few test queries now. We will use the dig command to do so. 

  1. Open a new terminal or terminal tab without halting the terminal where dnstap-receiver is running.

  2. Run a couple dig commands using the IP address of the NIOS Grid Member running dnstap. Try querying infoblox.com. Note: For this demo, the IP used in the dig is the LAN Interface IP of the IB-FLEX box running DNS Cache Acceleration. 

dig @192.168.10.53 infoblox.com

When queries are received by dnstap-receiver, they will appear in the dnstap-receiver stdout. 

  1. Open Kibana and observe the queries are ingested into Kibana. For more information on Kibana, indices and creating visualizations, see the Kibana Data Discovery and Kibana Data Visualization sections of this document. 

 

We can also test with a Windows machine to see the ingesting in action instead of sending dig requests. 

  1. Access a Windows machine on the same network as your Grid. Note: For this demo, we will use the same Windows machine used to access the Kibana UI. 

  2. Open your Internet and Network settings.

  1. Click Change adapter options. 

  1. Right-click on your desired connection and click Properties.

  1. Click on Internet Protocol Version 4 (TCP/IPv4) and click Properties. 

  1. Set the Preferred DNS server to the LAN IP address of the NIOS Grid Member running dnstap. Click OK when done. Note: For this demo, the IP used is the LAN Interface IP of the IB-FLEX box running DNS Cache Acceleration.

  1. Open Chrome. Go to http://example.com. 

  1. In Kibana, observe the query has been ingested.

The query also appears in the dnstap-receiver stdout. 

Related content