Skip to content

Latest commit

 

History

History
57 lines (36 loc) · 1.69 KB

README.md

File metadata and controls

57 lines (36 loc) · 1.69 KB

Zonemaster collector

This is the collection and analysis tool for the Zonemaster DNS delegation test tool. The collect.pl program runs Zonemaster::Engine in batch for storage in a file system or a MongoDB database.

There is a tool available written in Go for displaying the results: https://github.com/pawal/tldmonitor-ui-go

Usage

This is a parrallelized collector for performing tests using Zonemaster and to collect the results from the tests on either disk or a MongoDB.

Simple usage:

$ ./collect-pl -f input.txt --mongo --db zonemaster --collection results

The default number of threads is 10, so it will run fast. To run more threads, make sure you have enough memory.

You can also store Zonemaster results on disk instead of using MongoDB:

$ ./collect-pl -f input.txt -d output --threads 20

All command line options:

-n domain       specify name
-f file.txt     read list of names from file
-d outdir       create this directory and store result in if reading domains from file
--mongo         store results in MongoDB
--db            which MongoDB database
--collection    which MongoDB collection
--threads       number of threads
--level         Zonemaster severity level (default, DEBUG)
--debug         debug mode

Analyzing results

See the How to Mongo document on how to do same fancy analyzing stuff with MongoDB.

If you want to do the similar type of analysis on the output directory with files, I recommend the jq CLI tool: http://stedolan.github.io/jq/

Depencencies

Other Perl modules:

  • Term::ANSIColor (for "fancy" output)
  • JSON Perl