Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

chore: dns docs amendment #76

Merged
merged 3 commits into from
Mar 19, 2024
Merged

chore: dns docs amendment #76

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6304946
chore: dns docs amendment
nddq Mar 19, 2024
f869a17
Update docs/metrics/plugins/dns.md
nddq Mar 19, 2024
c274aec
Update docs/metrics/plugins/dns.md
nddq Mar 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/metrics/plugins/dns.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# `dns` (Linux)

Counts number of packets/bytes dropped on a Node, along with the direction and reason for drop.
Tracks incoming and outgoing DNS traffic, providing various metrics and details about the DNS queries and responses.

## Metrics

See metrics for [Basic Mode](../basic.md#plugin-dns-linux) or [Advanced Mode](../advanced.md#plugin-dns-linux).

## Architecture

The plugin utilizes eBPF to gather data.
The plugin generates Basic metrics from an eBPF result.
In Advanced mode (see [Metric Modes](../modes.md)), the plugin turns this eBPF result into an enriched `Flow` (adding Pod information based on IP), then sends the `Flow` to an external channel so that a dns module can create extra Pod-Level metrics.
This plugin uses [Inspektor Gadget](https://github.com/inspektor-gadget/inspektor-gadget)'s DNS Tracer to track DNS traffic and generate basic metrics derived from the captured events.

In [Advanced mode](https://retina.sh/docs/metrics/modes), the plugin further processes the capture results into an enriched Flow with additional Pod information. Subsequently, the Flow is transmitted to an external channel. This allows a DNS module to generate additional Pod-Level metrics.

### Code locations

Expand Down
Loading