Selbst melden
Jedes Programm kann eine Quelle sein. Es braucht einen HTTP-Aufruf.
Ein Schlüssel
Abschnitt betitelt „Ein Schlüssel“./nota token add meine-quelle ingestDer Schlüssel wird einmal angezeigt. Sein Name, meine-quelle, wird als Quelle jeder Meldung festgehalten, die er schickt.
Die Anfrage
Abschnitt betitelt „Die Anfrage“POST /v1/ingest, Bearer-Schlüssel mit der Rolle ingest, im Rumpf ein JSON-Array oder NDJSON. Höchstens 1 MiB und 1000 Meldungen; ein Stapel gilt ganz oder gar nicht. Unbekannte Felder werden abgelehnt.
curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8080/v1/ingest -d '[ {"type":"thing","thing":"web-1","kind":"server","name":"Web 1","expect_s":180, "price":{"amount":"7.00","currency":"EUR","per":"month"}}, {"type":"edge","thing":"web-1","rel":"part_of","target":"shop"}, {"type":"metric","thing":"web-1","metric":"disk_used_ratio","value":0.97}, {"type":"state","thing":"shop","check":"tls","status":"ok","summary":"certificate","due":"2026-12-05T00:00:00Z"}, {"type":"event","thing":"backup-db","event":"run","outcome":"fail","summary":"pg_dump exit 3","vars":{"exit_code":"3"}}, {"type":"cost","thing":"shop","amount":"12.40","currency":"EUR","from":"2026-11-01T00:00:00Z","to":"2026-12-01T00:00:00Z"}]'Jede Meldung hat einen type, ein thing — eine Id, die du vergibst: Buchstaben, Ziffern und . _ : @ - — und auf Wunsch eine Zeit ts. Ein Ding entsteht mit seiner ersten Erwähnung.
Die Meldungen, nach dem, was du sagen willst
Abschnitt betitelt „Die Meldungen, nach dem, was du sagen willst“| Du willst sagen | Meldung |
|---|---|
| „Das gibt es, es heißt so, es kostet so viel.“ | thing, mit kind, name, price |
| „Ich melde mich dazu mindestens so oft.“ | thing mit expect_s — Schweigen darüber hinaus ist kritisch |
| „Das gehört zu dem.“ / „Das läuft auf dem.“ | edge mit rel part_of, runs_on oder depends_on |
| „Diese Prüfung ist in Ordnung / Warnung / kritisch.“ | state, mit check, status, summary, auf Wunsch due |
| „Das ist offen: Es steht mir zu, oder ich schulde es.“ | state mit amount, currency, side |
| „Das lief, und es ging gut oder schlecht.“ | event mit outcome ok oder fail |
| „Das ist passiert und hat so viel gekostet.“ | event mit amount, oder mit einer quantity, die ein Preis je Ereignis zu Kosten macht |
| „Hier ist eine Zahl.“ | metric — wird mit Schwellen verglichen |
| „In diesem Zeitraum hat es so viel gekostet / gebracht.“ | cost, revenue |
Alle Felder stehen in der Referenz.
Ein Job meldet seine Läufe
Abschnitt betitelt „Ein Job meldet seine Läufe“Ein Ereignis mit einem Ergebnis ist ein Lauf. Ein Fehlschlag macht die Prüfung gleichen Namens kritisch, bis ein Lauf gelingt:
{"type":"event","thing":"backup-db","event":"run","outcome":"ok","summary":"Backup lief"}Eine Regel vom Typ expect bemerkt, wenn kein gelungener Lauf rechtzeitig kommt — ein Backup, das still aufhört. Die mitgelieferten Regeln erwarten von jedem Ding der Art backup mindestens alle 26 Stunden einen Lauf.
Ein KI-Prozess meldet seine Schritte
Abschnitt betitelt „Ein KI-Prozess meldet seine Schritte“Jeder Schritt ist ein Ereignis. Ein Werkzeugaufruf bringt seinen eigenen Preis mit; Tokens tragen eine Menge, die ein Preis je Ereignis zu Kosten macht:
[ {"type":"event","thing":"assistant","event":"input-tokens","quantity":4200000}, {"type":"event","thing":"assistant","event":"output-tokens","quantity":610000}, {"type":"event","thing":"assistant","event":"web-search","amount":"0.35","currency":"USD","summary":"12 searches"}, {"type":"event","thing":"assistant","event":"ticket-resolved","quantity":57}]Das sind die Meldungen aus dem KI-Szenario. Ein Preis je Ereignis auf der Ertragsseite macht aus den 57 gelösten Tickets, was sie gebracht haben.
Ein Schritt, der fehlschlägt, trägt in vars, was er wusste, und eine Brief-Vorlage kann es nennen: {{vars.model}}.
Sagen, was geholfen hat
Abschnitt betitelt „Sagen, was geholfen hat“{"type":"event","thing":"web-1","event":"fix","summary":"Logs rotiert","vars":{"check":"disk"}}Beim nächsten Mal steht der Satz im Brief zu dieser Prüfung.
Zurücklesen
Abschnitt betitelt „Zurücklesen“Die Ansichten, aus denen das Dashboard zeichnet, sind auch eine HTTP-API, mit einem Schlüssel der Rolle read oder operate: Referenz.