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.
Dieser Rechner
Abschnitt betitelt „Dieser Rechner“"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.
Prüfungen von außen
Abschnitt betitelt „Prüfungen von außen“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 Cloud
Abschnitt betitelt „Hetzner Cloud“"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 zweite Sonde, von außen
Abschnitt betitelt „Eine zweite Sonde, von außen“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:
./nota probe probe.jsonIhr 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.
Prüfen, bevor es läuft
Abschnitt betitelt „Prüfen, bevor es läuft“./nota probe -check probe.jsonprüft die Datei.
./nota probe -once probe.jsonlässt alles einmal laufen und gibt aus, was gemeldet würde.
Was die Sonde nicht tut
Abschnitt betitelt „Was die Sonde nicht tut“Sie liest Dateien und fragt Adressen ab. Sie startet keine fremden Programme, ändert nichts, wo sie hinsieht, und durchsucht keine Logs.