Zum Hauptinhalt springen
Überwachen Sie die Integrität der Truthlocks-API, prüfen Sie die Bereitschaft für Abhängigkeiten und integrieren Sie sie in Ihren Observability-Stack.

Health-Endpunkte

Liveness-Probe

Prüfen, ob die API läuft. Für Kubernetes Liveness-Probes verwenden:

Bereitschaftsprüfung

Prüfen, ob die API bereit ist, Traffic zu bedienen (alle Abhängigkeiten fehlerfrei):

Kubernetes-Konfiguration

Wenn Sie Anwendungen entwickeln, die von Truthlocks abhängen, konfigurieren Sie Ihre Probes so, dass sie sowohl Ihre App als auch die Truthlocks API überprüfen:

Beispiel Bereitschaftsprüfung (App)

Statusseite

Überprüfen Sie den Echtzeit-Dienstzustand und die Verfügbarkeit unter status.truthlocks.com. Die Statusseite wird alle 60 Sekunden automatisch aktualisiert und erfordert keine Authentifizierung.

Überwachte Dienste

Die Statusseite verfolgt den Zustand jedes Kerndienstes unabhängig: Jeder Dienst meldet einen von vier Status: betriebsbereit, eingeschränkt, Ausfall oder unbekannt. Die Seite zeigt eine dienstspezifische Antwortzeit und ein Banner für den allgemeinen Systemzustand an.

Verfügbarkeitsverlauf

Eine 90-Tage-Uptime-Leiste zeigt die tägliche Verfügbarkeit für jeden Dienst an. Fahren Sie mit der Maus über einen beliebigen Tag, um das Datum und den Uptime-Prozentsatz anzuzeigen. Ein Gesamt-Uptime-Prozentsatz wird neben jedem Dienst angezeigt.

Vorfallhistorie

Besuchen Sie die Seite Vorfallhistorie, um vergangene Vorfälle in einem Zeitachsenformat anzuzeigen. Jeder Eintrag enthält den Schweregrad, die betroffenen Dienste und zeitgestempelte Aktualisierungen von der Untersuchung bis zur Lösung.

Benachrichtigungen abonnieren

Geben Sie Ihre E-Mail-Adresse unten auf der Statusseite ein, um Benachrichtigungen über Vorfälle zu erhalten. Sie werden benachrichtigt, wenn Vorfälle erstellt, aktualisiert oder gelöst werden. Unternehmenskunden können auch Webhook-Callbacks konfigurieren, um Statusänderungsereignisse automatisch zu empfangen.

Programmatische Status-API

Die Status-API für maschinenlesbare Dienstzustandsinformationen abfragen. Verwenden Sie dies, um die Verfügbarkeit von Truthlocks in Ihre eigenen Dashboards, Alarmierungs-Pipelines oder Vorabprüfungen zu integrieren. Keine Authentifizierung erforderlich.
Der Endpunkt gibt den gesamten Systemstatus, einen Zeitstempel und ein Array von Gesundheitsprüfungen pro Dienst zurück:
Antwortfelder: Der Gesamtstatus ist outage, wenn ein Dienst ausgefallen ist, degraded, wenn ein Dienst langsam ist oder Fehler zurückgibt, und operational, wenn alle Dienste fehlerfrei sind. Beispiel: Statusabfrage aus Ihrer App
Beispiel: Vorabprüfung vor dem Prägen Überprüfen Sie, ob die Signatur- und Attestierungsdienste fehlerfrei sind, bevor Sie einen Mint-Vorgang versuchen. Dies vermeidet unnötige Wiederholungsversuche, wenn Sie bereits wissen, dass die erforderlichen Dienste ausgefallen sind.
Die Status-API ist ratenbegrenzt, um Missbrauch zu verhindern. Für die kontinuierliche Überwachung, nicht häufiger als einmal alle 30 Sekunden abfragen.
Das vollständige Antwortschema, die IDs der überwachten Dienste und weitere Beispiele finden Sie in der Status-API-Referenz.

Statusseite

Echtzeit-Dienstzustand und Vorfallhistorie.

Webhook-Benachrichtigungen

Unternehmen können Webhook-Callbacks für Statusänderungen konfigurieren.

Status API-Referenz

Vollständige API-Referenz für den programmatischen Status-Endpunkt.

E-Mail-Benachrichtigungen

Abonnieren Sie die Statusseite für Benachrichtigungen über Vorfälle.

Service-Level-Verpflichtungen

Verfügbarkeitsziele, Supportabdeckung, Reaktionszeiten und Service-Gutschriften gelten nur, wenn dies im anwendbaren Vertrag explizit vereinbart wurde. Öffentliche Gesundheitsprüfungen melden den beobachteten Dienstzustand; sie begründen keine garantierte Betriebszeit in Prozent, End-to-End-Wiederherstellungsfähigkeit oder einen besetzten Supportplan. Bestätigen Sie die aktuelle Bereitstellung und die Wiederherstellungsnachweise, bevor Sie sich auf eine Zusage verlassen.

Überwachungsintegration

Integrieren Sie Truthlocks-Gesundheitsprüfungen in Ihre Observability-Tools:
Prometheus
Datadog
Custom Dashboard Metrics

Gateway-Resilienz

Das API-Gateway umfasst automatische Panikwiederherstellung und Zero-Downtime-Bereitstellungsunterstützung:
  • Panikwiederherstellung – Wenn das Gateway einen unerwarteten internen Fehler feststellt, stellt es sich automatisch wieder her und gibt eine strukturierte Fehlermeldung zurück, anstatt Ihre Verbindung zu trennen. Sie müssen keine Verbindungsabbrüche behandeln, die durch Panik auf Gateway-Ebene verursacht werden.
  • Graceful Shutdown – Während der Bereitstellung leiten der Gateway- und der Signaturdienst laufende Anfragen über ein 15-Sekunden-Fenster ab, anstatt sie sofort zu beenden. Wenn Sie zuvor gelegentlich Anfragenfehler während Wartungsfenstern erlebt haben, sollten diese nicht mehr auftreten.
Diese Schutzmaßnahmen funktionieren automatisch und erfordern keine Änderungen an Ihrer Integration.

Reaktion auf Vorfälle

Wenn Truthlocks Probleme hat:
  1. Statusseite prüfen: status.truthlocks.com
  2. Leistungsschalter aktivieren: Fehlerbehandlung in Ihrer App
  3. Warteschlangenoperationen: Attestierungsprägung später wiederholen
  4. Support kontaktieren: Für Enterprise SLA-Eskalation

Schutzschalter-Muster

Nächste Schritte

Beobachtbarkeits-Dashboard

Überwachen Sie den Dienstzustand, die Latenz und die Nutzung über die Konsole.

Fehlerreferenz

Vollständige Liste der Fehlercodes und deren Behandlung.

Ratenbegrenzungen

Ratenbegrenzung elegant handhaben.