Skip to content

Ingestor, aggregator and analyzer for your DNS traffic

License

Notifications You must be signed in to change notification settings

flowintel/go-dnscollector

This branch is 378 commits behind dmachard/DNS-collector:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

37b1e5a · May 16, 2023
Apr 13, 2023
May 5, 2023
May 12, 2023
May 16, 2023
May 16, 2023
May 14, 2023
May 16, 2023
May 12, 2023
Feb 22, 2023
Mar 13, 2023
May 16, 2023
Dec 16, 2022
Jul 28, 2021
Nov 1, 2022
Feb 8, 2023
May 15, 2023
Jul 3, 2021
May 11, 2023
May 14, 2023
May 16, 2023
May 5, 2023
May 14, 2023
May 14, 2023

Repository files navigation

DNS-collector

Go Report Card Go Tests Github Actions Github Actions PDNS

NOTE: The code before version 1.x is considered beta quality and is subject to breaking changes.

DNS-collector acts as a passive high speed ingestor, aggregator and analyzer for your DNS traffic, written in Golang. The DNS traffic can be collected and aggregated from simultaneously sources like DNStap streams, network interface or log files and relays it to multiple other listeners with some transformations on it (traffic filtering, user privacy, ...) and DNS protocol conversions (to plain text, json, and more... ).

Additionally, DNS-collector also support

Overview:

overview

Collectors:

  • Listen for logging traffic with streaming network protocols
  • Live capture on a network interface
  • Read text or binary files as input

Loggers:

Transformers:

Get Started

Download the latest release binary and start the DNS-collector with the provided configuration file. The default configuration listens on tcp/6000 for a DNSTap stream and DNS logs are printed on standard output.

./go-dnscollector -config config.yml

If you prefer run it from docker, follow this guide.

Configuration

The configuration of DNS-collector is done through a file named config.yml. When the DNS-collector starts, it will look for the config.yml from the current working directory.

See the full configuration guide for more details.

Examples:

You will find below some examples of configuration to manage your DNS logs.

Contributing

See the development guide for more information on how to build it yourself.

How to userguides:

About

Ingestor, aggregator and analyzer for your DNS traffic

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 94.9%
  • Python 4.1%
  • C 0.6%
  • Makefile 0.2%
  • Dockerfile 0.1%
  • Shell 0.1%