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.1.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.1-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dnstrace-0.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 be6110620ae6fef6e788ef04506244e5fc3d10fbd2779246444c6df85986da34
MD5 9ab766382abbde33e9c9519462b514dd
BLAKE2b-256 be328ac84ff8760dca1c2e2274bde368ebd4f2b8c1a64c39354190d3b79c064d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: dnstrace-0.2.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b16161e6e7d698923dec1019a6b8b749382c6ba99c39033e13cbabcf809519ed
MD5 87a4f5b975356a17340ec9d53946821f
BLAKE2b-256 003afa488c82cd08452d38c9f65bda3eebfd97914dc8276bae97a6543c60f5b7

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