Skip to main content

DnsTrace is a tool that identifies DNS queries made by processes on the host.

Project description

DnsTrace

Monitor DNS queries by host processes using eBPF!

GitHub issues GitHub stars GitHub license Downloads

Demo

Quick Start

Prerequisites

DnsTrace requires BCC (BPF Compiler Collection) to be installed on your system. Follow the BCC installation guide for your Linux distribution.

Installation

Install DnsTrace using pipx:

pipx install dnstrace

Usage

Run DnsTrace with root privileges:

sudo dnstrace

Command Line Options

sudo dnstrace [OPTIONS]

Options:
  -t, --tail     Stream live DNS queries (tail mode)
  -d, --domain   Show DNS query domains
  -h, --help     Show help message

Examples

Basic monitoring:

sudo dnstrace

Stream live queries:

sudo dnstrace --tail

Show domains with live-streaming:

sudo dnstrace --tail --domain

📊 Display Modes

Table Mode (Default)

  • Real-time statistics dashboard
  • Query type distribution charts
  • Process attribution and interface details
  • Responsive column layout

Tail Mode (--tail)

  • Live-streaming of DNS queries
  • Optional domain display with --domain flag

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dnstrace-0.2.0.tar.gz (548.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dnstrace-0.2.0-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file dnstrace-0.2.0.tar.gz.

File metadata

  • Download URL: dnstrace-0.2.0.tar.gz
  • Upload date:
  • Size: 548.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for dnstrace-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2e03cb6c5f1a19274139373e4b19655e00a49e1dfdce090c7230510b6f12e051
MD5 5a72f4fd9ac496b9fa409f22aee60527
BLAKE2b-256 21706d17216ad37d637efea82f22960f8bc3b751940308ba31ee1faed8b8a17e

See more details on using hashes here.

File details

Details for the file dnstrace-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: dnstrace-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for dnstrace-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 857804ff267102672511667223ac04fc2be9519ba82cbfbfaf82338f7b42adac
MD5 66d09107bfd0586e52e85f4a7efdfbcf
BLAKE2b-256 19085ba873d485d6d7cff5186dcf6fe4c1099255fe14d2b60b2af1bc78129795

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page