Zum Inhalt springen

Selbst melden

Jedes Programm kann eine Quelle sein. Es braucht einen HTTP-Aufruf.

Terminal-Fenster
./nota token add meine-quelle ingest

Der Schlüssel wird einmal angezeigt. Sein Name, meine-quelle, wird als Quelle jeder Meldung festgehalten, die er schickt.

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.

Terminal-Fenster
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.

Du willst sagenMeldung
„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 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.

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}}.

{"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.

Die Ansichten, aus denen das Dashboard zeichnet, sind auch eine HTTP-API, mit einem Schlüssel der Rolle read oder operate: Referenz.