docs: Integrationsanleitungen auf Stand 2.0 bringen, Status "stopped" ergänzen
Watchdog-Anleitung vollständig überarbeitet - Alle drei Codebeispiele trugen das geseedete Demo-Token fest im Quelltext. Es ist an die Source "srv-db-01" gebunden — wer es übernommen hätte, wäre für jeden anderen Dienst abgewiesen worden. Jetzt Umgebungsvariable und eine Anleitung, wie man ein eigenes Token erzeugt. - Der Ratschlag "sende beim Beenden einen Ping mit Status stopped" beschrieb etwas, das die API nicht konnte. Statt die Anleitung an die Lücke anzupassen, ist die Lücke geschlossen: status akzeptiert jetzt "stopped" und "maintenance". Der Evaluator lässt solche Monitore in Ruhe, statt wenige Minuten nach jedem sauberen Shutdown einen Fehlalarm zu erzeugen. - Neu dokumentiert: checks (Gesundheitszustand per Push, ohne offene Ports), metrics samt Verlauf und Abweichungsvergleich, Alarmunterdrückung über die Hierarchie, die Schwellen des Evaluators (2x warning, 4x down) und der erforderliche Cron-Job. Lizenz-Anleitung - Neuer Abschnitt zum Antwortformat. Die Lizenz-Endpunkte antworten bewusst ohne den status/error-Umschlag der übrigen API; das Feld status auf oberster Ebene trägt den Lizenzzustand. Genau diese Besonderheit hatte ich beim Umbau übersehen, weshalb sie jetzt ausdrücklich festgehalten ist — samt Tabelle aller Zustände. - Ergänzt: Deaktivierung braucht den shared_key, mit Beispiel für den .NET- Client und curl. Verhalten bei Ratenbegrenzung. UpdateService-Anleitung - Prüf-Endpunkte dokumentiert (check, latest, releases) samt Antwortformat. - Tabelle zum Versionsvergleich mit den Fällen, die vorher falsch liefen. - Auto-Resolve beim Veröffentlichen beschrieben. Agent-Prompt-Vorlage - Fehler-Schnittstelle ergänzt, inklusive Hinweis auf "ignored": true, damit ein Agent bekannte Fehler nicht untersucht. Alle in der Dokumentation genannten API-Pfade und Scopes wurden maschinell gegen Routing und TokenManager abgeglichen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
65e60899f9
commit
5f9b0c5596
@@ -54,6 +54,34 @@ dem nächsten Agenten das Parsen des Stacktrace.
|
||||
Schweregrade: `idea` (Gedanke für später), `wishlist` (Backlog),
|
||||
`low`, `medium`, `high`, `critical`.
|
||||
|
||||
### Laufzeitfehler automatisch melden
|
||||
Für den globalen Exception-Handler einer Anwendung gibt es einen schlankeren
|
||||
Eingang — Titel und Dringlichkeit leitet der Server ab:
|
||||
|
||||
`POST /api/errors/v1/report`
|
||||
|
||||
```json
|
||||
{
|
||||
"project_slug": "myapp",
|
||||
"exception": "PDOException",
|
||||
"message": "Exakte Fehlermeldung",
|
||||
"stack_trace": "...",
|
||||
"level": "error",
|
||||
"build": "v1.4.2",
|
||||
"environment": "production",
|
||||
"file": "src/Core/Service.php",
|
||||
"line": 42
|
||||
}
|
||||
```
|
||||
|
||||
`level`: `fatal` (Prozess beendet), `error` (Vorgang fehlgeschlagen, Programm
|
||||
läuft weiter), `warning`.
|
||||
|
||||
Gleiche Fehler werden zu einer Gruppe zusammengefasst und hochgezählt;
|
||||
veränderliche Anteile wie Schlüsselwerte, Adressen und Zeitstempel werden dabei
|
||||
ausgeblendet. Kommt `"ignored": true` zurück, ist der Fehler als bekannt und
|
||||
harmlos eingestuft — dann nicht weiter untersuchen, sondern nur zählen lassen.
|
||||
|
||||
### Arbeit übernehmen
|
||||
Bevor du an einem Item arbeitest, übernimm es — sonst arbeiten zwei Agenten
|
||||
parallel am selben Problem:
|
||||
|
||||
Reference in New Issue
Block a user