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
--domainflag
Metadata
Release files for dnstrace 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dnstrace-0.2.2.tar.gz | 548.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dnstrace-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 560.9 kB
Release files / dnstrace-0.2.2.tar.gz
| Download URL | dnstrace-0.2.2.tar.gz |
|---|---|
| Size | 548.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50f23f533127657ba9c1e6eae9ff3a5542e12caccbcfef1ecb3af691c5aad6e3
|
|
BLAKE2b-256 checksum How to use checksums |
36a89ad05934982220d7601ab8f59277118ede8ed59e340d38af3c039e89c438
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / dnstrace-0.2.2-py3-none-any.whl
| Download URL | dnstrace-0.2.2-py3-none-any.whl |
|---|---|
| Size | 12.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
81f852c7c856b0e2f1817afec044c2858413202381a959aa0a923491a7babcb9
|
|
BLAKE2b-256 checksum How to use checksums |
9a2511c2ac0f11382253484829a67bb89b1c8d8b53433cedc741a643b7110e76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|