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

Uploaded Python 3

File details

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

File metadata

  • Download URL: dnstrace-0.2.2.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.2.tar.gz
Algorithm Hash digest
SHA256 50f23f533127657ba9c1e6eae9ff3a5542e12caccbcfef1ecb3af691c5aad6e3
MD5 513ada7c8a26697ea17ee395e4f24de6
BLAKE2b-256 36a89ad05934982220d7601ab8f59277118ede8ed59e340d38af3c039e89c438

See more details on using hashes here.

File details

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

File metadata

  • Download URL: dnstrace-0.2.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 81f852c7c856b0e2f1817afec044c2858413202381a959aa0a923491a7babcb9
MD5 b6da769c9bff4efbef28ce1759966655
BLAKE2b-256 9a2511c2ac0f11382253484829a67bb89b1c8d8b53433cedc741a643b7110e76

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