Skip to content

Commit e056c1c

Browse files
nightkrnightkr
committed
Update documentation a bit
1 parent cf51ae1 commit e056c1c

File tree

2 files changed

+126
-53
lines changed

2 files changed

+126
-53
lines changed

‎README.md‎

Lines changed: 125 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -22,96 +22,168 @@ It currently prints:
2222
- Reverse Lookup for those IP addresses (IP Address => List of hostnames)
2323
- Forward lookup for those hostnames (Hostname => List of IP addresses)
2424

25-
Here is an example of what it looks like on my Laptop:
25+
Here is an example of what it looks like on my virtual machine:
26+
27+
> 2025-02-03T11:37:47.420479Z INFO containerdebug: stackable_operator::utils::logging: Starting
28+
> 2025-02-03T11:37:47.420521Z INFO containerdebug: stackable_operator::utils::logging: This is version 0.1.1 (Git information: 0.1.1-1-gcf51ae1), built for x86_64-unknown-linux-gnu by rustc 1.84.1 (e71f9a9a9 2025-01-27) at Tue, 1 Jan 1980 00:00:00 +0000
29+
> 2025-02-03T11:37:47.420544Z INFO containerdebug:SystemInformation::init: containerdebug::system_information: initializing
30+
> 2025-02-03T11:37:47.426065Z INFO containerdebug:SystemInformation::init: containerdebug::system_information: init finished
31+
> 2025-02-03T11:37:47.426135Z INFO containerdebug:SystemInformation::collect: containerdebug::system_information: Starting data collection
32+
> 2025-02-03T11:37:47.426693Z INFO containerdebug:SystemInformation::collect:Resources::collect: containerdebug::system_information::resources: cpus cpus.physical=8 cpus.cores.physical=8
33+
> 2025-02-03T11:37:47.426727Z INFO containerdebug:SystemInformation::collect:Resources::collect: containerdebug::system_information::resources: memory memory.total=24604889088 memory.free=17235124224 memory.available=22974955520 memory.used=1629933568
34+
> 2025-02-03T11:37:47.426746Z INFO containerdebug:SystemInformation::collect:Resources::collect: containerdebug::system_information::resources: swap swap.total=0 swap.free=0 swap.used=0
35+
> 2025-02-03T11:37:47.426857Z INFO containerdebug:SystemInformation::collect:Resources::collect: containerdebug::system_information::resources: not in a cgroup
36+
> 2025-02-03T11:37:47.426940Z INFO containerdebug:SystemInformation::collect:OperatingSystem::collect: containerdebug::system_information::os: operating system os.name="NixOS" os.kernel.version="6.6.46" os.version="Linux 24.11 NixOS" os.host_name="nixos2" os.cpu_arch="x86_64"
37+
> 2025-02-03T11:37:47.427031Z INFO containerdebug:SystemInformation::collect:User::collect_current: containerdebug::system_information::user: current user user.name="nat" user.uid="Uid(1000)" user.gid="Uid(1000)"
38+
> 2025-02-03T11:37:47.427436Z INFO containerdebug:SystemInformation::collect:Disk::collect_all: containerdebug::system_information::disk: found disk disk.mount_point="/" disk.name="/dev/sda2" disk.space.total=106298343424 disk.space.available=72663478272
39+
> 2025-02-03T11:37:47.427483Z INFO containerdebug:SystemInformation::collect:Disk::collect_all: containerdebug::system_information::disk: found disk disk.mount_point="/nix/store" disk.name="/dev/sda2" disk.space.total=106298343424 disk.space.available=72663478272
40+
> 2025-02-03T11:37:47.427499Z INFO containerdebug:SystemInformation::collect:Disk::collect_all: containerdebug::system_information::disk: found disk disk.mount_point="/boot" disk.name="/dev/sda1" disk.space.total=1071624192 disk.space.available=1022820352
41+
> 2025-02-03T11:37:47.428771Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="lo" network.interface.address=127.0.0.1
42+
> 2025-02-03T11:37:47.428821Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="enp1s0" network.interface.address=192.168.122.138
43+
> 2025-02-03T11:37:47.428836Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="br-82bbc663b8a3" network.interface.address=172.18.0.1
44+
> 2025-02-03T11:37:47.428847Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="docker0" network.interface.address=172.17.0.1
45+
> 2025-02-03T11:37:47.428861Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="lo" network.interface.address=::1
46+
> 2025-02-03T11:37:47.428874Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="enp1s0" network.interface.address=fe80::5054:ff:fe91:5652
47+
> 2025-02-03T11:37:47.428885Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: found network interface network.interface.name="br-82bbc663b8a3" network.interface.address=fc00:f853:ccd:e793::1
48+
> 2025-02-03T11:37:47.428910Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: ip addresses network.addresses.ip={127.0.0.1, 172.17.0.1, 172.18.0.1, 192.168.122.138, ::1, fc00:f853:ccd:e793::1, fe80::5054:ff:fe91:5652}
49+
> 2025-02-03T11:37:47.429002Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=127.0.0.1 hostnames=["localhost."]
50+
> 2025-02-03T11:37:47.437343Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=172.17.0.1 hostnames=["nixos2.", "nixos2.local."]
51+
> 2025-02-03T11:37:47.439911Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=172.18.0.1 hostnames=["nixos2.", "nixos2.local."]
52+
> 2025-02-03T11:37:47.440526Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=192.168.122.138 hostnames=["nixos2.kvm."]
53+
> 2025-02-03T11:37:47.440678Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=::1 hostnames=["localhost."]
54+
> 2025-02-03T11:37:47.441339Z WARN containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: reverse DNS lookup failed ip=fc00:f853:ccd:e793::1 error=no record found for Query { name: Name("1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.3.9.7.e.d.c.c.0.3.5.8.f.0.0.c.f.ip6.arpa."), query_type: PTR, query_class: IN }
55+
> 2025-02-03T11:37:47.442068Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed reverse DNS lookup for IP ip=fe80::5054:ff:fe91:5652 hostnames=["nixos2."]
56+
> 2025-02-03T11:37:47.442149Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: hostnames network.addresses.hostname={"localhost.", "nixos2.", "nixos2.kvm.", "nixos2.local."}
57+
> 2025-02-03T11:37:47.442300Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed forward DNS lookup for hostname hostname="localhost." ips=[127.0.0.1]
58+
> 2025-02-03T11:37:47.442755Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed forward DNS lookup for hostname hostname="nixos2." ips=[127.0.0.2]
59+
> 2025-02-03T11:37:47.443144Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed forward DNS lookup for hostname hostname="nixos2.kvm." ips=[127.0.0.2]
60+
> 2025-02-03T11:37:47.443628Z INFO containerdebug:SystemInformation::collect:SystemNetworkInfo::collect: containerdebug::system_information::network: performed forward DNS lookup for hostname hostname="nixos2.local." ips=[192.168.122.138, 172.18.0.1, 172.17.0.1]
61+
> 2025-02-03T11:37:47.443837Z INFO containerdebug:SystemInformation::collect: containerdebug::system_information: Data collection finished
62+
63+
# Log output
64+
65+
The log-style output above is written to stdout. It can also be output to files by setting the environment variable `CONTAINERDEBUG_LOG_DIRECTORY=/path/to/logs/directory`.
66+
67+
This file output will be output as _JSON-formatted logs_, in order to ease ingestion into a log aggregation system (such as [Vector](https://vector.dev/)). These files
68+
will also automatically be rotated over time.
69+
70+
# Data output
71+
72+
The containerdebug tool can write its collected data into a JSON dump, by setting the `--output=/path/to/dump.json` flag.
73+
74+
This is intended to be queried with tools like [jq](https://jqlang.org/). However, note that the output format is currently not stable, and may change over time.
75+
76+
For example:
2677

2778
```json
2879
{
29-
"cpu_count": 8,
30-
"physical_core_count": 4,
31-
"total_memory": 50161664000,
32-
"free_memory": 2400735232,
33-
"available_memory": 35192512512,
34-
"used_memory": 14969151488,
35-
"total_swap": 53687087104,
36-
"free_swap": 53687087104,
37-
"used_swap": 0,
38-
"total_memory_cgroup": null,
39-
"free_memory_cgroup": null,
40-
"free_swap_cgroup": null,
41-
"system_name": "Arch Linux",
42-
"kernel_version": "6.7.8-arch1-1",
43-
"os_version": "Linux rolling Arch Linux",
44-
"host_name": "lars-laptop",
45-
"cpu_arch": "x86_64",
80+
"resources": {
81+
"cpu_count": 8,
82+
"physical_core_count": 8,
83+
"total_memory": 24604889088,
84+
"free_memory": 17228574720,
85+
"available_memory": 22974619648,
86+
"used_memory": 1630269440,
87+
"total_swap": 0,
88+
"free_swap": 0,
89+
"used_swap": 0,
90+
"total_memory_cgroup": null,
91+
"free_memory_cgroup": null,
92+
"free_swap_cgroup": null
93+
},
94+
"os": {
95+
"name": "NixOS",
96+
"kernel_version": "6.6.46",
97+
"version": "Linux 24.11 NixOS",
98+
"host_name": "nixos2",
99+
"cpu_arch": "x86_64"
100+
},
101+
"current_user": {
102+
"name": "nat",
103+
"uid": "1000",
104+
"gid": "100"
105+
},
46106
"disks": [
47107
{
108+
"name": "/dev/sda2",
48109
"mount_point": "/",
49-
"total_space": 754416877568,
50-
"available_space": 55915364352
51-
},
52-
{
53-
"mount_point": "/home",
54-
"total_space": 754416877568,
55-
"available_space": 55915364352
110+
"total_space": 106298343424,
111+
"available_space": 72267354112
56112
},
57113
{
58-
"mount_point": "/var/swap",
59-
"total_space": 754416877568,
60-
"available_space": 55915364352
114+
"name": "/dev/sda2",
115+
"mount_point": "/nix/store",
116+
"total_space": 106298343424,
117+
"available_space": 72267354112
61118
},
62119
{
120+
"name": "/dev/sda1",
63121
"mount_point": "/boot",
64-
"total_space": 2095079424,
65-
"available_space": 1896505344
122+
"total_space": 1071624192,
123+
"available_space": 1022820352
66124
}
67125
],
68-
"network_information": {
69-
"network_interfaces": {
70-
"wlan0": [
71-
"192.168.1.23",
72-
"fe80::90bf:60ff:fe78:836a"
126+
"network": {
127+
"interfaces": {
128+
"enp1s0": [
129+
"192.168.122.138",
130+
"fe80::5054:ff:fe91:5652"
73131
],
74132
"lo": [
75133
"127.0.0.1",
76134
"::1"
77135
],
78-
"virbr0": [
79-
"192.168.122.1"
136+
"br-82bbc663b8a3": [
137+
"172.18.0.1",
138+
"fc00:f853:ccd:e793::1"
139+
],
140+
"docker0": [
141+
"172.17.0.1"
80142
]
81143
},
82144
"reverse_lookups": {
83-
"192.168.1.23": [
84-
"lars-laptop.localdomain."
85-
],
86-
"192.168.122.1": [
87-
"lars-laptop.",
88-
"lars-laptop.local."
145+
"fe80::5054:ff:fe91:5652": [
146+
"nixos2."
89147
],
90148
"127.0.0.1": [
91149
"localhost."
92150
],
151+
"192.168.122.138": [
152+
"nixos2.kvm."
153+
],
93154
"::1": [
94155
"localhost."
95156
],
96-
"fe80::90bf:60ff:fe78:836a": [
97-
"lars-laptop."
157+
"172.17.0.1": [
158+
"nixos2.",
159+
"nixos2.local."
160+
],
161+
"172.18.0.1": [
162+
"nixos2.",
163+
"nixos2.local."
98164
]
99165
},
100166
"forward_lookups": {
101-
"lars-laptop.": [
102-
"127.0.0.1"
167+
"nixos2.kvm.": [
168+
"127.0.0.2"
103169
],
104-
"lars-laptop.local.": [
105-
"192.168.1.23",
106-
"192.168.122.1"
170+
"nixos2.": [
171+
"127.0.0.2"
107172
],
108-
"localhost.": [
109-
"127.0.0.1"
173+
"nixos2.local.": [
174+
"192.168.122.138",
175+
"172.18.0.1",
176+
"172.17.0.1"
110177
],
111-
"lars-laptop.localdomain.": [
178+
"localhost.": [
112179
"127.0.0.1"
113180
]
114181
}
115182
}
116183
}
117184
```
185+
186+
# Continuous mode
187+
188+
If given the `--loop` flag, containerdebug will stay in the background and run on a fixed interval. By default it will run every 30 minutes, but a custom
189+
interval can also be set (e.g. `--loop=30s`).

‎src/main.rs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ struct Opts {
2323
)]
2424
loop_interval: Option<stackable_operator::time::Duration>,
2525

26+
/// Write collected information to OUTPUT as JSON
2627
#[clap(long, short = 'o')]
2728
output: Option<PathBuf>,
2829

0 commit comments

Comments
 (0)