Zum Inhalt springen

Die Sonde

Die Sonde ist für alles, was abgeholt statt geschickt werden muss. Sie ist Teil desselben Programms: nota serve startet sie im selben Prozess, wenn eine probe.json daneben liegt, und nota probe lässt sie allein auf einem zweiten Rechner laufen.

Eine JSON-Datei konfiguriert sie. nota init schreibt eine erste; templates/probe.json.example im Quelltext zeigt alles.

{
"name": "probe-b",
"core": { "url": "https://nota.example.org", "token": "${NOTA_TOKEN}" },
"host": { "thing": "web-1" },
"checks": [],
"lists": []
}

Der Schlüssel ist einer der Rolle ingest am Core. ${ENV_VAR} wird ersetzt, er muss also nicht in der Datei stehen.

"host": { "thing": "web-1" }

meldet, wie voll die Platten sind, wie viel Speicher frei ist, und die Last, mit den Namen, die die mitgelieferten Regeln erwarten — und verspricht, sich wieder zu melden, sodass ein Rechner auffällt, der verstummt. Die Regeln, die nota init anlegt, warnen bei einer zu 80 % vollen Platte und werden bei 92 % kritisch.

Das ist der kleine Weg, einen Server zu beobachten. Die Vector-Vorlagen im Ordner agent/ des Quelltexts können dasselbe und mehr, für alle, die Vector ohnehin betreiben.

http, tcp und tls. Der Ablauf eines Zertifikats wird zu einer Fälligkeit; es steht also unter „Wird fällig“, bevor es ein Problem wird.

"checks": [
{ "thing": "shop", "check": "http", "type": "http", "url": "https://shop.example.org/health", "interval_s": 60 },
{ "thing": "shop", "check": "tls", "type": "tls", "address": "shop.example.org:443", "interval_s": 3600, "warn_days": 21, "crit_days": 7 },
{ "thing": "db", "check": "port", "type": "tcp", "address": "db.example.org:5432" }
]

Eine http-Prüfung akzeptiert die Statuscodes 200–399, wenn du nichts anderes sagst, und kann mit contains einen Text in der Antwort verlangen.

"hetzner": [
{ "name": "production", "token": "${HCLOUD_TOKEN}", "interval_s": 300 }
]

liest ein Hetzner-Cloud-Projekt und meldet seine Ressourcen — Server, Volumes, IPs — als Dinge mit ihren Listenpreisen. Gib ihr einen Nur-Lese-Schlüssel; die Sonde liest nur.

Hetzner Cloud ist eine Quelle unter mehreren und heute der einzige Cloud-Anbieter mit einem eigenen Sammler. Nota steht in keiner Verbindung zur Hetzner Online GmbH.

Dateien, die ein Mensch führt: Listen, Pläne und todo.txt, Taskwarrior und Beancount.

Eine Sonde auf demselben Rechner wie der Core kann nicht sehen, dass der Rechner unerreichbar ist. Auf einem zweiten kleinen Rechner prüft nota probe von außen und beobachtet den ersten:

Terminal-Fenster
./nota probe probe.json

Ihr watchdog sagt einem Menschen über ntfy oder einen Webhook Bescheid, wenn der Core selbst eine Weile nicht erreichbar war — der eine Fall, den der Core nicht melden kann:

"watchdog": {
"after_s": 180,
"notify": { "type": "ntfy", "url": "https://ntfy.example.org/ops", "token": "${NTFY_TOKEN}" }
}

Melden zwei Sonden dieselbe Prüfung und nur eine sieht einen Ausfall, ist das Ergebnis eine Warnung, kein Alarm.

Terminal-Fenster
./nota probe -check probe.json

prüft die Datei.

Terminal-Fenster
./nota probe -once probe.json

lässt alles einmal laufen und gibt aus, was gemeldet würde.

Sie liest Dateien und fragt Adressen ab. Sie startet keine fremden Programme, ändert nichts, wo sie hinsieht, und durchsucht keine Logs.