# netcheck.conf - Konfiguration fuer netcheck.sh

#

# Diese Datei nach "netcheck.conf" kopieren und anpassen. Sie wird vom Script

# eingelesen (sourced) und ueberschreibt die eingebauten Defaults.

# Environment-Variablen beim Aufruf haben Vorrang vor dieser Datei nicht -

# die Datei gewinnt, weil sie zuletzt gelesen wird. Wer einzelne Werte

# temporaer uebersteuern will, kommentiert sie hier aus.

# --- Was gemessen wird ------------------------------------------------------

# Zu pruefende Ziele, durch Leerzeichen getrennt, ohne https://

# Sinnvoll ist eine Mischung: das eigentliche Kundenziel plus ein bis zwei

# stabile Referenzziele. Faellt nur das Kundenziel aus, liegt es am Ziel.

# Fallen alle gleichzeitig aus, liegt es an der Leitung des Kunden.

TARGETS="tytik.cloud www.heise.de one.one.one.one"

# Protokollfamilien

FAMILIES="4 6"

# Pfad, der per HTTPS abgerufen wird

CURL_PATH="/"

# HEAD spart Traffic, GET misst realistischer. Manche WAFs mogen HEAD nicht -

# wenn dauerhaft 405 oder 403 kommt, auf GET wechseln.

CURL_METHOD="HEAD"

# --- Zeitverhalten ----------------------------------------------------------

# Abstand zwischen den Laeufen im daemon-Modus (Sekunden).

# Bei cron/launchd steuert das Intervall dort, nicht hier.

INTERVAL=300

# mtr-Zyklen im Normalfall und bei einer Auffaelligkeit

MTR_CYCLES=10

MTR_ANOMALY_CYCLES=30

CURL_CONNECT_TIMEOUT=10

CURL_MAX_TIME=20

# --- Schwellwerte -----------------------------------------------------------

# Ab diesen Werten gilt ein Lauf als auffaellig, wird im Log vermerkt und

# erzeugt ein Rohlog mit ausfuehrlicher mtr-Nachmessung.

LOSS_WARN=5          # Paketverlust zum Ziel in Prozent

RTT_WARN=150         # mittlere Latenz zum Ziel in ms

TOTAL_WARN=3000      # curl-Gesamtzeit in ms

# --- Ablage -----------------------------------------------------------------

# Standard ist ein Unterverzeichnis "data" neben dem Script.

# Fuer den Dauerbetrieb besser ein fester Pfad:

# OUTDIR="/var/log/netcheck"

# Rohlogs aelter als N Tage werden geloescht. 0 = nie loeschen.

RAW_RETENTION_DAYS=30

# Bei Auffaelligkeit zusaetzlich den lokalen Netzzustand mitschreiben

# (Default-Routen, Router-Advertisements, Interface-Adressen).

# Sehr hilfreich, wenn der Verdacht auf ein Problem am Client oder am

# Kundenrouter besteht - etwa eine verschwundene IPv6-Default-Route.

SNAPSHOT_ON_ANOMALY=1

# --- Feinheiten -------------------------------------------------------------

# mtr-Messmodus. TCP/443 kommt durch die meisten Filter. Alternativen:

#   "-T -P 443"   TCP SYN auf 443 (Default, empfohlen)

#   "-u"          UDP

#   ""            ICMP

MTR_MODE="-T -P 443"

# "-b" zeigt Hostname und IP je Hop. "-n" verzichtet auf Reverse-DNS und

# macht die Messung schneller, kostet aber Lesbarkeit.

MTR_EXTRA="-b"