Verfügbarkeit, Status und Meldungen

XICBOT prüft den Zustand seiner tragenden Teile selbst: Datenbank, Zwischenspeicher, Ablage, Warteschlange, wiederkehrende Läufe, Hintergrunddienst, Mailweg, die Anbindung für das Erzeugen der Antworten und das Datenbankschema. Das Ergebnis gibt es auf zwei Wegen – knapp und ohne Anmeldung über die öffentliche Statusauskunft, ausführlich im Betriebsbereich. Diese Seite beschreibt beide, dazu das öffentliche Änderungsprotokoll, die Kopfzeilen und Fehlerantworten der Schnittstelle und woran Sie erkennen, dass Ihr Konto zur Betreuung übernommen wurde. *Betreiber* meint hier den Betreiber der Plattform, nicht Sie als Betreiber Ihrer Website.

Öffentliche Statusauskunft

Die Statusauskunft ist ohne Anmeldung erreichbar, weil man einen Ausfall gerade dann nachsehen will, wenn die Anmeldung vielleicht nicht geht. Sie antwortet reduziert: Sie erfahren, ob ein Teil trägt, und sonst nichts. Fehlertexte, Tabellennamen, Rechnernamen und Zahlen aus der Warteschlange bleiben im Betriebsbereich.

curl -s -w '\nHTTP %{http_code}\n' https://app.xicbot.de/api/v1/public/status

{
  "state": "degraded",
  "measured": true,
  "parts": [
    { "name": "database", "state": "operational" },
    { "name": "cache", "state": "operational" },
    { "name": "storage", "state": "operational" },
    { "name": "queue", "state": "operational" },
    { "name": "schedule", "state": "operational" },
    { "name": "daemon", "state": "operational" },
    { "name": "mail", "state": "degraded" },
    { "name": "gateway", "state": "operational" },
    { "name": "schema", "state": "operational" }
  ],
  "time": "2026-09-28T08:15:02+00:00"
}
HTTP 503

Das Beispiel zeigt einen gestörten Mailweg: Alle Teile wurden gemessen, einer ist nicht in Ordnung, deshalb lautet der Gesamtzustand degraded und der Statuscode 503.

Felder der Antwort

Zustände und Statuscode

Die neun Teile

Herzschläge des Hintergrunddienstes zählen zum Teil daemon, nicht zu schedule. Hat der Hintergrunddienst noch keinen Herzschlag geschrieben, ist das ein Befund und keine fehlende Messung: Der Teil steht dann auf degraded, nicht auf unknown. Mit der Prüfung von schema fällt eine nicht gelaufene Migration auf, bevor ein Besucher in sie hineinläuft.

Zwischenspeicher und Ausfall der Probe

Das Messergebnis wird 20 Sekunden zwischengespeichert; Abrufe in kürzerem Abstand erhalten dasselbe Ergebnis. time ist der Zeitpunkt der Antwort, nicht der Messung. Der Zwischenspeicher liegt selbst auf der Datenbank – fällt sie aus, wird ohne ihn gemessen, statt die Antwort ganz zu verlieren. Scheitert die Probe als Ganzes, antwortet die Auskunft mit unknown, measured: false und einem einzigen Teil namens total.

Eigene Überwachung anbinden

1. 1

   Schritt 1

   Adresse abfragen

   GET https://app.xicbot.de/api/v1/public/status ohne Anmeldung und ohne Schlüssel aufrufen.

2. 2

   Schritt 2

   Statuscode auswerten

   200 heißt in Betrieb. 503 heißt gestört oder nicht gemessen.

3. 3

   Schritt 3

   Bei 503 die Teile lesen

   Teile mit degraded sind gestört, Teile mit unknown wurden nicht gemessen.

4. 4

   Schritt 4

   Abstand wählen

   Mehr als ein Abruf je 20 Sekunden bringt kein neues Messergebnis. Den Zähler von 30 Abrufen je Minute teilen sich Statusauskunft, Änderungsprotokoll, Abruf einer Demo und Erklärung zur Barrierefreiheit; ist er erschöpft, antwortet die Schnittstelle mit 429.

Änderungsprotokoll

Das Änderungsprotokoll liegt als Datei neben dem Code und nicht in der Datenbank: Ein Eintrag beschreibt die Fassung, mit der er ausgeliefert wurde, und ändert sich danach nicht mehr. Wie die Statusauskunft ist es ohne Anmeldung abrufbar.

kind ist einer der Werte feature, fix, security oder note; ein anderer Wert wird als note ausgegeben. points enthält die Einzelpunkte eines Eintrags als Liste von Texten, leere Punkte fallen weg. Ein Eintrag ohne Fassung, Datum oder Titel wird übergangen.

„Nicht gemessen“ ist kein Ergebnis

„Der Wert ist 0“ und „der Wert wurde nicht ermittelt“ sehen in einer Zahlenspalte gleich aus und bedeuten das Gegenteil. XICBOT hält beides deshalb auseinander: Ein Teil, dessen Messung scheitert, trägt measured: false, value: null und einen Grund in reason mit höchstens 300 Zeichen. Er zählt nicht als in Ordnung, und die Gesamtaussage wird unknown.

Im Betriebsbereich steht ein solcher Teil als Nicht gemessen, darunter der Grund. Lässt sich die Zustandsantwort gar nicht lesen, zeigt die Seite statt der Teile den Hinweis Dieser Wert konnte nicht ermittelt werden und ist deshalb kein Ergebnis.

Kopfzeilen und Fehlerantworten

Jede Antwort, die die Schnittstelle selbst erzeugt, trägt den Kopf X-Konfigurationsstand, Fehlerantworten eingeschlossen. Sein Wert ist ein Hash über die wirksame Konfiguration, kein Inhalt. Zwei Antworten mit gleichem Wert kommen aus demselben Stand; ändert sich der Wert, antwortet ein anderer Stand. So sehen Sie mit einem Aufruf, ob eine Umstellung schon wirkt.

Über HTTPS ausgelieferte Antworten tragen Strict-Transport-Security: max-age=31536000; includeSubDomains: Der Browser ruft die Adresse samt Unterdomains ein Jahr lang nur verschlüsselt auf. preload ist bewusst nicht gesetzt. Die Seiten der Anwendung und die Antworten unter /api/ tragen zusätzlich diese Kopfzeilen:

Betriebsbereich des Betreibers

Der Bereich Betrieb liegt unter https://app.xicbot.de/betrieb und erscheint in der Navigation unter Betreiber. Er steht nur Konten mit dem Betreibermerkmal offen. Das ist ein eigenes Merkmal am Nutzer und keine Rolle: Auch Inhaber und Administratoren eines Mandanten erhalten keinen Zugang, weil sie sonst etwas über andere Mandanten erführen. Unter Betreiber steht außerdem die Blog-Vorschau: Sie zeigt geplante Beiträge des XICBOT-Auftritts vor ihrem Erscheinen und folgt denselben Zugangsregeln. Als Kunde sehen Sie beide Bereiche nicht. Der Betriebsbereich ist hier beschrieben, damit Sie wissen, was der Betreiber über Ihr Konto sieht und was er darin tun kann. Ihre Kontingente sehen Sie unter Pakete und Kontingente. Den aktuellen Zustand der Plattform nennt die öffentliche Statusauskunft weiter oben; die Statusseite fragt diese Auskunft beim Öffnen im Browser ab und zeigt den Zustand mit Messzeit; kommt keine Antwort, steht dort „nicht gemessen“. Darunter erklärt sie, was überwacht wird.

Zustand

Unter Zustand stehen die neun Teile mit In Betrieb, Gestört oder Nicht gemessen; Neu messen löst eine frische Messung aus. Anders als die öffentliche Auskunft liefert die Schnittstelle des Bereichs zu jedem Teil Messwerte. Die Seite nennt bei einem gestörten Teil die Ursache, etwa fehlende Tabellen, unbediente Bahnen oder gestörte Läufe, bei einem nicht gemessenen Teil den Grund. Sie wertet die Antwort auch bei 503 aus. Scheitert das Laden der Seite, steht oben die Fehlermeldung, und statt der Abschnitte erscheint nur der Knopf Erneut laden, der das Laden wiederholt.

Bei schedule fasst failed beide Befunde zusammen; overdue und last_run_failed sagen, welcher es ist. Ein fehlender und ein scheiternder Lauf verlangen verschiedene Handgriffe.

Wiederkehrende Läufe

Jeder wiederkehrende Lauf schreibt einen Herzschlag. Die Tabelle Wiederkehrende Läufe zeigt je Lauf Letzter Lauf, Letzter Erfolg, Frist und den Zustand Überfällig, Letzter Lauf fehlgeschlagen oder In Betrieb. Welche Läufe es gibt, welche Frist jeder hat und welche Meldungen ein Fehlschlag oder ein ausbleibender Lauf erzeugt, beschreibt Herzschlag und Meldungen.

Meldungen

Störungen landen als Meldung unter Meldungen. Jede Meldung trägt einen Schlüssel aus Quelle und Anlass. Tritt dieselbe Störung erneut auf, entsteht keine neue Zeile: Der Zähler count steigt, der Zeitpunkt der letzten Sichtung wird fortgeschrieben, und eine bereits gesehene Meldung gilt wieder als ungesehen. Titel sind auf 200 Zeichen, Texte auf 4000 Zeichen gekürzt.

Innerhalb derselben Schwere stehen die zuletzt gesehenen Meldungen oben. Ein unbekannter Schwerewert wird als warning gespeichert. Die Quelle erscheint mit ihrer Bezeichnung: Katalog, Übergabe, Wissen, Mailweg, Aufräumen, Warteschlange, Kontingent, Zeitplan, Datenbankschema, Datenschutz oder Webhook.

Die Liste zeigt offene Meldungen; ist keine offen, steht dort Keine offenen Meldungen. Mit Als gesehen ablegen legt der Betreiber eine Meldung ab. Das wird im Aktionsprotokoll als message.seen festgehalten.

Warteschlange

Die Warteschlange zeigt Aufträge mit Art, Stand und Versuche. Bei einem gescheiterten Auftrag setzt Noch einmal versuchen ihn auf wartend zurück, der Versuchszähler beginnt wieder bei 0; die Aktion steht als job.retry im Aktionsprotokoll.

• Wurden die Nutzdaten eines Auftrags nach dem Scheitern auf Verweise gekürzt, lässt er sich nicht wiederholen: Die Schnittstelle antwortet mit 409 payload_reduced, die Seite mit Nicht wiederholbar: Die Nutzdaten wurden nach dem Scheitern gekürzt. Der Vorgang muss dann neu ausgelöst werden.
• Ist ein Auftrag nicht mehr gescheitert, weil ihn inzwischen jemand zurückgestellt hat oder er schon läuft, antwortet die Schnittstelle mit 409 not_failed. Die Seite lädt die Liste dann neu und zeigt Dieser Auftrag lässt sich nicht wiederholen: Er ist nicht mehr gescheitert, sondern wurde inzwischen schon zurückgestellt oder läuft gerade.
• Aufträge, die länger als 7 Tage warten oder laufen, werden ohne Ausführung beendet; dazu entsteht eine Warnung der Quelle Warteschlange.
• Gescheiterte Aufträge bleiben bis zur Aufräumung nach 14 Tagen sichtbar.

Wie Aufträge aus Ihrer Sicht entstehen und laufen, steht unter Hintergrundaufträge und Zeitpläne.

Zustellprotokoll

Das Zustellprotokoll umfasst die Nachrichten aller Mandanten. Eine Zeile entsteht, sobald eine Nachricht ausgelöst wird, auch wenn kein Zustellweg eingerichtet ist und sie deshalb nicht hinausgeht. Empfängeradressen sind auf den ersten Buchstaben und die Domain gekürzt, etwa m***@example.com: Für die Frage, ob eine Gegenstelle Nachrichten abweist, genügt die Domain. Ebenso gekürzt stehen Adressen im Grund eines Fehlschlags, in der Meldung zu einer nicht zugestellten E-Mail und im Fehler eines gescheiterten Versandauftrags; die Absage einer Gegenstelle nennt die Adresse oft selbst.

Neben Empfänger zeigt die Liste Mandant, Zugestellt am, Versuche und Anlass. Einen Fehlergrund trägt nur eine gescheiterte Zeile, etwa ungültige Empfängeradresse oder unbekannte Vorlage. Die Schnittstelle filtert nach status, template und tenant und liefert seitenweise 25 Zeilen, mit per_page bis zu 100; die Antwort nennt total, page, pages und per_page.

Mandanten und Grenzen

Unter Mandanten sieht der Betreiber je Mandant Status, Paket, Nutzer, Assistenten (aktiv/gesamt), Gespräche und Verbrauch im Monat, die zuletzt angelegten zuerst und 25 je Seite. Über der Liste steht der gezeigte Bereich mit der Gesamtzahl der Treffer; bei mehr als einer Seite blättern darunter Zurück und Weiter. Das Feld Suche nach Name, Kennung oder Rechnungs-E-Mail sucht wörtlich in diesen drei Angaben, der Filter Status steht zunächst auf alle außer gelöschten, der Filter Paket grenzt auf ein Paket ein. Konto übernehmen steht nur bei aktiven Mandanten, bei den übrigen nennt die Zeile den Status. Der Name führt zur Seite des Mandanten. Sie nennt unter Stammdaten Status, Paket, Kennung, Anlage, Rechnungs-E-Mail, USt-IdNr., die Annahme der Auftragsverarbeitung, die gespeicherten Werte für Datenregion und Modellweg und die Aufbewahrungsfristen je Objektart so, wie sie wirken: Ohne eigene Zahl folgen Test- und Schnittstellengespräche der Frist für alle Gespräche. Bei einem gelöschten Mandanten steht dort statt der Fristen, dass nur noch eine Hülle mit ihrem Protokoll bleibt, die der Wartungslauf nach Ablauf ihrer Frist entfernt. Unter Kontingent stehen der Verbrauch im Monat gegen das Budget, die geltenden Grenzen und die Abweichungen vom Paket. Darunter folgen Grenzen, Nutzer und Assistenten (aktiv/gesamt). Zu den Assistenten stehen dort nur Betriebsangaben wie Einbindung und zuletzt gesehen; die Systemanweisung bleibt beim Kunden.

Eine Null schaltet den Deckel je Besucher und den Deckel je Gespräch ab. Grenzen speichern auf der Seite des Mandanten übernimmt die Werte. Die Antwort von GET /api/v1/admin/tenants und die Einzelansicht GET /api/v1/admin/tenants/{id} führen alle fünf Grenzen mit ihrem aktuellen Wert. Bei der Nachrichtenlänge nennen beide und die Antwort auf PUT /api/v1/admin/tenants/{id} den wirksamen Wert: Ein gespeicherter Wert über 4000 wirkt und erscheint dort als 4000, ohne gespeicherten Wert steht dort ebenfalls 4000. Über die Schnittstelle lassen sich zusätzlich das Paket (plan), status (active, paused, suspended) und monthly_token_budget (0 bis 1000000000) setzen. Einen gelöschten Mandanten ändert sie nicht mehr: PUT /api/v1/admin/tenants/{id} antwortet dann mit 409 tenant_deleted, und seine Seite zeigt keine Grenzfelder. Jede Änderung steht mit altem und neuem Wert als tenant.update im Aktionsprotokoll; bei der Nachrichtenlänge hält der Eintrag den gespeicherten Wert fest. Was die Pakete umfassen, steht unter Pakete und Kontingente, die Preise unter Preise.

Zweite Stufe zurücksetzen

Auf der Seite des Mandanten ist die Zahl neben Nutzer ein Schalter: Er klappt die Personen des Mandanten mit Name, E-Mail-Adresse, Rolle, Zweite Stufe (Ja oder Nein) und Aktion auf. Zahl und Liste umfassen alle Mitglieder des Mandanten, auch Personen, die gerade in einem anderen Mandanten arbeiten; Rolle nennt ihre Rolle in diesem Mandanten. Hat jemand das einzige Gerät für die zweite Stufe verloren, lässt sie sich hier zurücksetzen. Bei Kundenkonten mit eingerichteter zweiter Stufe steht unter Aktion der Knopf Zweite Stufe zurücksetzen. Er öffnet die Frage Code und Sicherheitsschlüssel dieser Person entfernen und alle ihre Sitzungen beenden? mit dem Feld Grund (steht im Betreiberprotokoll), mindestens 10 und höchstens 500 Zeichen, und den Knöpfen Zurücksetzen und Abbrechen. Betreiberkonten zeigen statt des Knopfs Betreiberkonto; die Schnittstelle lehnt sie mit 403 operator_account ab.

Zurücksetzen entfernt den Code und alle Sicherheitsschlüssel der Person und beendet alle ihre Sitzungen, auch eine laufende Übernahme. Deren Ende steht wie bei Übernahme beenden als impersonation.end im Aktionsprotokoll und im Protokoll des Mandanten, und sessions_ended in der Antwort zählt sie mit. Danach erscheint Die zweite Stufe ist zurückgesetzt. Eine Sicherheitsmeldung an die Kontoadresse ist unterwegs. Ließ sich die Meldung nicht einreihen, erscheint stattdessen Die zweite Stufe ist zurückgesetzt, die Sicherheitsmeldung ließ sich aber nicht einreihen. Bitte benachrichtigen Sie die Person selbst. Das Zurücksetzen steht mit dem Grund als user.second_factor_reset im Aktionsprotokoll und im Protokoll des Mandanten, in dem die Person gerade arbeitet, als Zweite Stufe durch den Betreiber zurückgesetzt. Kommt einer der beiden Einträge nicht zustande, bleibt die zweite Stufe erhalten; die Schnittstelle antwortet mit 500 und not_logged, und die Seite zeigt Nicht gespeichert: Der Eintrag ins Protokoll kam nicht zustande. Bitte versuchen Sie es erneut. Hat die Person inzwischen keine zweite Stufe mehr, zeigt die Zeile Diese Person hat keine zweite Stufe mehr eingerichtet. Wie die zweite Stufe für die Person selbst funktioniert, steht unter Konto und Sicherheit.

Übernahme eines Kontos

Zur Betreuung kann der Betreiber in das Konto eines Mandanten wechseln. Er trägt einen Grund der Übernahme mit höchstens 200 Zeichen ein und wählt Konto übernehmen. Der Knopf steht nur bei aktiven Mandanten. Übernommen wird das ranghöchste Konto, das gerade in diesem Mandanten arbeitet, in der Reihenfolge Inhaber, Administrator, Bearbeiter, Betrachter; ein Mitglied, das gerade in einem anderen Mandanten arbeitet, zählt dabei nicht mit. Arbeitet gerade kein Konto in dem Mandanten, lehnt die Schnittstelle mit 422 tenant_without_user ab. Wie lange eine Übernahme läuft, was aus ihr heraus gesperrt ist und wie sie protokolliert wird, beschreibt Übernahme durch den Betreiber.

So erkennen Sie eine Übernahme

Eine laufende Übernahme erkennen und beenden Sie in der Geräteliste des übernommenen Zugangs unter Angemeldete Geräte an der Zeile Übernahme durch den Betreiber. Die Einzelheiten stehen unter Übernahme durch den Betreiber, die Geräteliste unter Konto und Sicherheit.

Demos auf Anfrage

Eine Demo richtet der Betreiber ein, wenn ein Interessent sie über das Anfrageformular wünscht. Unter Demos trägt er die Adresse der Website ein, freiwillig die E-Mail-Adresse des Interessenten und die Sprache des Assistenten, und wählt Demo anlegen. Daraus entsteht ein eigener Mandant mit einem Assistenten, der nur aus dieser Website antwortet und sich nur auf ihr einbinden lässt; gelesen wird die Website im Hintergrund. Die Liste darunter zeigt je Demo Website, Interessent, Läuft bis, Wissen mit dem Stand der Aufnahme und die Einbauzeile, die der Betreiber dem Interessenten schickt; zugestellt wird nichts von selbst. Eine Demo läuft 72 Stunden, danach antwortet ihr Assistent nicht mehr, und eine Woche später räumt der Wartungslauf sie ab. Jede neu angelegte Demo steht als demo.create im Aktionsprotokoll. Den öffentlichen Weg POST /api/v1/public/demo gibt es weiterhin, die Website bietet ihn nicht an.

Aktionsprotokoll

Das Aktionsprotokoll hält fest, was der Betreiber im Bereich getan hat: Änderungen an Paket, Status, Budget und Grenzen (tenant.update), wiederholte Aufträge (job.retry), abgelegte Meldungen (message.seen), den Beginn von Übernahmen (impersonation.start), ihr Ende (impersonation.end), zurückgesetzte zweite Stufen (user.second_factor_reset) und angelegte Demos (demo.create). Das Ende einer Übernahme steht dort in der Regel, wenn sie über Übernahme beenden endet, durch Abmelden während der Übernahme, durch die Person selbst unter Angemeldete Geräte oder weil alle Sitzungen des Kontos enden: nach einem neuen Passwort über den Link, beim Zurücksetzen der zweiten Stufe, beim Entfernen aus dem Team oder beim Löschen des Kontos, auch dem einer abgelaufenen Demo. Ebenso steht das Ende dort, wenn das übernommene Konto selbst in einen anderen Mandanten wechselt. Eine Übernahme, die nach vier Stunden von selbst abläuft, hinterlässt keinen Eintrag zum Ende; scheitert der Eintrag beim Beenden, endet die Übernahme trotzdem, und der Ausfall steht nur in der Fehlermeldung des Systems. Unter Wer steht die Adresse des Betreuenden; hat die Kundenseite die Übernahme beendet, steht darunter zusätzlich Vom Kunden beendet, endete sie mit dem Löschen einer abgelaufenen Demo, Beendet beim Löschen der abgelaufenen Demo. Hat ein anderes Konto als das des Betreuenden das Ende ausgelöst, etwa die Person selbst, wer sie aus dem Team entfernt hat oder ein zweiter Betreiber beim Zurücksetzen der zweiten Stufe, steht dort außerdem Ausgelöst von mit der Adresse dieses Kontos. Endete die Übernahme mit einem neuen Passwort über den Link, mit dem Wechsel in einen anderen Mandanten oder mit dem Entfernen aus dem Team, nennt eine weitere Zeile den Anlass, etwa Anlass: das Konto wurde aus dem Team entfernt. Die Seite zeigt die jüngsten 50 Einträge; solange keiner vorliegt, steht dort Keine Aktion protokolliert. Die Schnittstelle liefert bis zu 200 Einträge, neueste zuerst.

Weiterführend

• Grundlagen der Schnittstelle – Anmeldung, Formate, Fehler
• Öffentliche Wege der Schnittstelle – alles, was ohne Anmeldung erreichbar ist
• Grenzen der Schnittstelle – Drosseln und die Antwort 429
• Hintergrundaufträge – Warteschlange aus Kundensicht
• Konto und Sicherheit – angemeldete Geräte und zweite Stufe

Häufige Fragen