14d3ef98 · netcheck · LabCodeHub

Küpper / netcheck öffentlich

fix: readme and netcheck.sh

R Rüdiger Küpper <rpr@9it.de> committete am 02.09.2026 13:25

14d3ef982bbbf8659b46c0d36769b65f74a4ad4b

Eltern: 9ea45c1f

geändert README.md

+2 −2 Datei ansehen



---

## Konfiguration

Alle Werte stehen in `netcheck.conf` neben dem Script (Vorlage:
`netcheck.conf.example`). Die wichtigsten:

| Variable | Default | Bedeutung |
|---|---|---|
| `TARGETS` | `kreuzfahrten.de` | Ziele, durch Leerzeichen getrennt, ohne `https://` |
| `TARGETS` | `tytik.cloud` | Ziele, durch Leerzeichen getrennt, ohne `https://` |
| `FAMILIES` | `4 6` | zu prüfende Protokollfamilien |
| `OUTDIR` | `./data` | Ablage für CSV, Rohlogs und Logfile |
| `INTERVAL` | `300` | Abstand im `daemon`-Modus in Sekunden |
| `MTR_CYCLES` | `10` | Pings pro Hop im Normalfall |
| `MTR_ANOMALY_CYCLES` | `30` | Pings pro Hop bei der Nachmessung |
| `LOSS_WARN` | `5` | Paketverlust zum Ziel in %, ab dem ein Lauf auffällig ist |
| `RTT_WARN` | `150` | mittlere Latenz zum Ziel in ms |
| `TOTAL_WARN` | `3000` | curl-Gesamtzeit in ms |
| `SNAPSHOT_ON_ANOMALY` | `0` | bei Auffälligkeit zusätzlich den lokalen Netzzustand mitschreiben |
| `RAW_RETENTION_DAYS` | `30` | Rohlogs älter als N Tage löschen, `0` = nie |

### Schnelle Handgriffe

```bash
# Alle Ausfälle chronologisch
awk -F, '$7==0 {print $1, $4, "IPv"$5, $23}' data/csv/*.csv

# Nur IPv6-Probleme
awk -F, '$5==6 && $22==1 {print $1, $23}' data/csv/*.csv

# Latenzverlauf eines Ziels für ein Diagramm
awk -F, '$4=="kreuzfahrten.de" && $5==4 && $15==1 {print $1","$17}' data/csv/*.csv
awk -F, '$4=="tytik.cloud" && $5==4 && $15==1 {print $1","$17}' data/csv/*.csv
```

---

## Wartung

Rohlogs werden nach `RAW_RETENTION_DAYS` automatisch gelöscht, CSV-Dateien
bleiben liegen — sie sind klein (rund 200 Byte pro Messung, bei zwei Zielen im
Dual-Stack und 5-Minuten-Takt etwa 6 MB im Monat) und bilden die eigentliche
Beweislage gegenüber dem Provider.

geändert netcheck.sh

+1 −1 Datei ansehen


export PATH
export LC_ALL=C

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

# ---------------------------------------------------------------------------
# Konfiguration (per netcheck.conf neben dem Script oder per Environment)
# ---------------------------------------------------------------------------

# Zu pruefende Ziele, durch Leerzeichen getrennt. Hostnamen ohne Schema.
TARGETS="${TARGETS:-kreuzfahrten.de}"
TARGETS="${TARGETS:-tytik.cloud}"

# Protokollfamilien: "4 6", "4" oder "6"
FAMILIES="${FAMILIES:-4 6}"

# Ablageort fuer CSV, Rohlogs und Logfile
OUTDIR="${OUTDIR:-$SCRIPT_DIR/data}"

# Wartezeit zwischen den Laeufen im daemon-Modus (Sekunden)
INTERVAL="${INTERVAL:-300}"


		@@ -200,21 +200,21 @@ systemctl list-timers netcheck.timer
200	200
201	201	---
202	202
203	203	## Konfiguration
204	204
205	205	Alle Werte stehen in `netcheck.conf` neben dem Script (Vorlage:
206	206	`netcheck.conf.example`). Die wichtigsten:
207	207
208	208	\| Variable \| Default \| Bedeutung \|
209	209	\|---\|---\|---\|
210		- \| `TARGETS` \| `kreuzfahrten.de` \| Ziele, durch Leerzeichen getrennt, ohne `https://` \|
	210	+ \| `TARGETS` \| `tytik.cloud` \| Ziele, durch Leerzeichen getrennt, ohne `https://` \|
211	211	\| `FAMILIES` \| `4 6` \| zu prüfende Protokollfamilien \|
212	212	\| `OUTDIR` \| `./data` \| Ablage für CSV, Rohlogs und Logfile \|
213	213	\| `INTERVAL` \| `300` \| Abstand im `daemon`-Modus in Sekunden \|
214	214	\| `MTR_CYCLES` \| `10` \| Pings pro Hop im Normalfall \|
215	215	\| `MTR_ANOMALY_CYCLES` \| `30` \| Pings pro Hop bei der Nachmessung \|
216	216	\| `LOSS_WARN` \| `5` \| Paketverlust zum Ziel in %, ab dem ein Lauf auffällig ist \|
217	217	\| `RTT_WARN` \| `150` \| mittlere Latenz zum Ziel in ms \|
218	218	\| `TOTAL_WARN` \| `3000` \| curl-Gesamtzeit in ms \|
219	219	\| `SNAPSHOT_ON_ANOMALY` \| `0` \| bei Auffälligkeit zusätzlich den lokalen Netzzustand mitschreiben \|
220	220	\| `RAW_RETENTION_DAYS` \| `30` \| Rohlogs älter als N Tage löschen, `0` = nie \|
		@@ -276,21 +276,21 @@ mtr-Ausgabe, Kurzlauf und Nachmessung.
276	276	### Schnelle Handgriffe
277	277
278	278	```bash
279	279	# Alle Ausfälle chronologisch
280	280	awk -F, '$7==0 {print $1, $4, "IPv"$5, $23}' data/csv/*.csv
281	281
282	282	# Nur IPv6-Probleme
283	283	awk -F, '$5==6 && $22==1 {print $1, $23}' data/csv/*.csv
284	284
285	285	# Latenzverlauf eines Ziels für ein Diagramm
286		- awk -F, '$4=="kreuzfahrten.de" && $5==4 && $15==1 {print $1","$17}' data/csv/*.csv
	286	+ awk -F, '$4=="tytik.cloud" && $5==4 && $15==1 {print $1","$17}' data/csv/*.csv
287	287	```
288	288
289	289	---
290	290
291	291	## Wartung
292	292
293	293	Rohlogs werden nach `RAW_RETENTION_DAYS` automatisch gelöscht, CSV-Dateien
294	294	bleiben liegen — sie sind klein (rund 200 Byte pro Messung, bei zwei Zielen im
295	295	Dual-Stack und 5-Minuten-Takt etwa 6 MB im Monat) und bilden die eigentliche
296	296	Beweislage gegenüber dem Provider.

		@@ -30,21 +30,21 @@ PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$PATH"
30	30	export PATH
31	31	export LC_ALL=C
32	32
33	33	SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
34	34
35	35	# ---------------------------------------------------------------------------
36	36	# Konfiguration (per netcheck.conf neben dem Script oder per Environment)
37	37	# ---------------------------------------------------------------------------
38	38
39	39	# Zu pruefende Ziele, durch Leerzeichen getrennt. Hostnamen ohne Schema.
40		- TARGETS="${TARGETS:-kreuzfahrten.de}"
	40	+ TARGETS="${TARGETS:-tytik.cloud}"
41	41
42	42	# Protokollfamilien: "4 6", "4" oder "6"
43	43	FAMILIES="${FAMILIES:-4 6}"
44	44
45	45	# Ablageort fuer CSV, Rohlogs und Logfile
46	46	OUTDIR="${OUTDIR:-$SCRIPT_DIR/data}"
47	47
48	48	# Wartezeit zwischen den Laeufen im daemon-Modus (Sekunden)
49	49	INTERVAL="${INTERVAL:-300}"
50	50