> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beobachtbarkeits-Dashboard

> Überwachen Sie das Attestierungsvolumen, den Dienstzustand über 10 Backend-Dienste, Latenz-Perzentile und die Plannutzung über die Konsole.

Das Observability-Dashboard bietet Ihnen eine Echtzeitansicht Ihrer Truthlocks-Umgebung direkt in der Konsole. Nutzen Sie es, um Attestationsaktivitäten zu verfolgen, den Dienstzustand zu überwachen, Latenztrends zu erkennen und die Plannutzung zu überprüfen – alles, ohne den Browser zu verlassen.

Das Dashboard ist in zwei Ansichten verfügbar: ein **Plattform-Observability**-Dashboard für Plattformadministratoren und ein **Tenant-Observability**-Dashboard für Tenant-Benutzer.

> [!NOTE]
>
> Das Mandanten-Observability-Dashboard ist in den Tarifen **Business** und **Enterprise** verfügbar. Wenn Sie einen Free- oder Starter-Tarif haben, wird Ihnen beim Navigieren zum Dashboard eine Upgrade-Aufforderung angezeigt. Das Plattform-Observability-Dashboard ist allen Plattformadministratoren zugänglich. Details zu den Tarifen finden Sie unter [billing](https://docs.truthlocks.com/de/billing/overview.md).

## Plattform-Beobachtbarkeit

Navigieren Sie in der Seitenleiste der Plattformkonsole zu **Observability**. Das Dashboard präsentiert SLO-Leistung, Dienstzustand, Fehlerverteilung und Cloud-Infrastruktur-Links auf einer einzigen Seite mit interaktiven Diagrammen.

### KPI-Zeile

Vier Karten mit farbigen linken Rahmenakzenten zeigen Metriken der obersten Ebene an:

| Karte | Akzentfarbe | Was sie zeigt |
| :- | :- | :- |
| **Gateway** | Cyan | Aktueller Gateway-Status (z. B. „betriebsbereit“) |
| **Dienste** | Grün | Funktionierende Dienste von insgesamt (z. B. „9/10“) |
| **SLO-Status** | Lila | Gesamter SLO-Status-Badge – grün, gelb oder rot |
| **Jüngste Fehler** | Rot | Anzahl der jüngsten gruppierten Fehler |

### SLO-Leistung

Wenn SLO-Daten verfügbar sind, zeigt das Dashboard drei Visualisierungen an:

#### Verfügbarkeitsanzeige

Eine radiale Balkenanzeige, die den aktuellen Verfügbarkeitsprozentsatz anzeigt. Die Anzeige ist farbcodiert:

| Farbe | Verfügbarkeit |
| :- | :- |
| Grün | 99,9 % oder höher |
| Amber | 99.0% – 99.9% |
| Rot | Unter 99,0 % |

Das verbrauchte Fehlerbudget wird unter der Anzeige angezeigt.

#### SLO-Scorecards

Zwei Scorecards zeigen:

* **Verfügbarkeit** – der aktuelle Prozentsatz gegenüber dem 99,9%-Ziel.
* **p99 Latenz** – die schlechteste Antwortzeit im Vergleich zum Ziel von 200 ms.

Jede Scorecard ist farbcodiert – grün, wenn innerhalb des Ziels, gelb, wenn sich dem Schwellenwert genähert wird, und rot, wenn das Ziel überschritten wird.

#### SLO-Trenddiagramme

Zwei Sieben-Tage-Liniendiagramme zeigen den historischen Trend für Verfügbarkeit und p99-Latenz. Eine gestrichelte bernsteinfarbene Referenzlinie markiert das SLO-Ziel in jedem Diagramm. Verwenden Sie diese, um zu erkennen, ob Ihre SLOs sich dem Ziel nähern oder davon entfernen.

### Dienstzustand

Der Abschnitt Dienste umfasst drei Ansichten:

* **Service-Gesundheits-Donut** – ein kompaktes radiales Diagramm, das das Verhältnis von gesunden, beeinträchtigten und unbekannten Diensten anzeigt.
* **Service-Latenzdiagramm** – ein horizontales Balkendiagramm, das die Antwortzeit jedes Dienstes in Millisekunden anzeigt. Die Balken sind nach Latenz farbcodiert (grün unter 50 ms, cyan unter 200 ms, bernsteinfarben unter 500 ms, rot darüber). Eine gestrichelte Referenzlinie bei 200 ms markiert den SLA-Schwellenwert.
* **Detaillierte Servicekarten** – erweiterbare Karten für jeden Backend-Dienst, die Status, Ziel-URL, Antwortzeit mit einem proportionalen Fortschrittsbalken und Links zu Protokollen und Traces anzeigen.

Das Plattform-Dashboard überwacht die folgenden Dienste:

| Dienst | Beschreibung |
| :- | :- |
| API Gateway | Haupt-API-Endpunkt für alle eingehenden Anfragen |
| Trust Registry | Identität, Aussteller, Schlüssel und Governance |
| Attestierungsdienst | Erstellung und Lebenszyklus von Anmeldeinformationen |
| Signaturdienst | Kryptografisches Schlüsselmanagement und Signieren |
| Transparenzprotokoll | Manipulationssicherer, nur anhängender Merkle-Baum |
| Verifizierungsdienst | Überprüfung und Validierung von Anmeldeinformationen |
| Audit-Dienst | Manipulationssichere Audit-Spur mit Hash-Verkettung |
| Abrechnungsservice | Nutzungsabrechnung und Abonnementverwaltung |
| Maschinenidentität | Agentenregistrierung, Sitzungen und Vertrauensbewertung |
| AI CMO | KI-Inhaltsmoderation und -Orchestrierung |

Jeder Dienst zeigt seinen aktuellen Status (**fehlerfrei**, **eingeschränkt** oder **ausgefallen**) an. Ein Dienst wird als **eingeschränkt** markiert, wenn er antwortet, aber länger als 2 Sekunden benötigt, und als **ausgefallen**, wenn er innerhalb des 5-Sekunden-Timeouts nicht antwortet.

### Fehlerverteilung

Ein Balkendiagramm schlüsselt die jüngsten gruppierten Fehler nach Signatur auf, farbcodiert zur schnellen Identifizierung. Unterhalb des Diagramms zeigt jede Fehlergruppe ihre Anzahl, Quelle und Beispiel-Trace-IDs. Links zu CloudWatch Logs Insights und X-Ray Service Map werden, falls verfügbar, bereitgestellt.

### CloudWatch-Starter

Schnellstart-Schaltflächen für Ihre Cloud-Überwachungstools – Dashboard, Metriken, Log Insights, X-Ray und Alarme. Diese öffnen sich direkt in Ihrer AWS-Konsole.

### Trace-Suche

Geben Sie eine Trace-ID ein, um einen direkten Link zu AWS X-Ray (oder Ihrem OTLP-Backend) für diese spezifische Anfrage zu erhalten. Drücken Sie die Eingabetaste oder klicken Sie auf **Nachschlagen**, um den Trace aufzulösen.

### Automatische Aktualisierung

Das Dashboard fragt alle 30 Sekunden alle Datenquellen ab. Schalten Sie die automatische Aktualisierung in der Kopfzeile ein oder aus. Ein Countdown zeigt an, wann die nächste Aktualisierung erfolgt. Klicken Sie jederzeit auf **Aktualisieren**, um die neuesten Daten sofort abzurufen.

## Mandanten-Beobachtbarkeit

Navigieren Sie in der Seitenleiste der Mandantenkonsole zu **Observability**. Das Mandanten-Dashboard ist in vier Registerkarten mit interaktiven Diagrammen organisiert.

### Dashboard-Registerkarten

| Registerkarte | Was sie anzeigt |
| :- | :- |
| **Übersicht** | Top-Level-Statistiken, Leistungsanzeigen, Diagramme zum Lebenszyklus von Bestätigungen und ein Latenztrenddiagramm |
| **Dienste** | Dienstspezifische Integrität, SLA-Konformitätsbalken, Verfügbarkeitsprozentsätze, Latenzdetails und ein Latenztrend für mehrere Dienste |
| **Nutzung & Quoten** | Verbrauch von Mints, Verifizierungen, Speicher und anderen gemessenen Ressourcen mit einem horizontalen Balkendiagramm |
| **Sicherheit** | Kryptografische Integrität, Mandantenisolation und Audit-Trail-Statuskarten mit detaillierten Kontrolltabellen |

### Übersicht

Die Registerkarte „Übersicht“ zeigt vier primäre Statistik-Karten an:

* **Gesamtzahl der Attestierungen** – aktive, widerrufene und ersetzte Zählungen.
* **Aktive Aussteller** – wie viele Ihrer Aussteller derzeit vertrauenswürdig sind.
* **Audit-Ereignisse** – Gesamtzahl der aufgezeichneten Ereignisse mit Hash-Chain-Integrität.
* **Systemzustand** – wie viele Backend-Dienste von der insgesamt überwachten Anzahl fehlerfrei sind.

Unterhalb der Statuskarten zeigen drei Leistungsanzeigen:

* **Durchschnittliche Latenz** über alle Dienste hinweg.
* **P95-Latenz** – die schlechteste Antwortzeit für den langsamsten Dienst.
* **Durchgeführte Gesundheitsprüfungen** seit dem Öffnen der Seite.

#### Attestierungs-Lebenszyklus-Diagramm

Ein Donut-Diagramm unterteilt Ihre gesamten Bestätigungen in die Kategorien **aktiv** (grün), **widerrufen** (rot) und **sonstige** (grau). Ein begleitendes Balkendiagramm zeigt dieselben Daten mit Anzahlen und Prozentsätzen für jede Kategorie.

#### Latenz-Trenddiagramm

Ein Flächendiagramm überlagert die Antwortzeiten aller überwachten Dienste über die letzten Gesundheitsprüfungen. Jeder Dienst ist farbcodiert mit seiner eigenen Farbverlauf-Füllung. Eine Legende unter dem Diagramm identifiziert jeden Dienst. Die SLA-Schwellenwerte sind angegeben: grün unter 200 ms, gelb unter 500 ms, rot bei 1000 ms oder darüber.

### Dienste

Der Tab „Dienste“ zeigt den Zustand jedes überwachten Backend-Dienstes an:

| Dienst | Beschreibung |
| :- | :- |
| API Gateway | Haupt-API-Endpunkt für alle eingehenden Anfragen |
| Trust Registry | Identität, Aussteller, Schlüssel und Governance |
| Attestierungsdienst | Erstellung und Lebenszyklus von Anmeldeinformationen |
| Signaturdienst | Kryptografisches Schlüsselmanagement und Signieren |
| Transparenzprotokoll | Manipulationssicherer, nur anhängender Merkle-Baum |
| Verifizierungsdienst | Überprüfung und Validierung von Anmeldeinformationen |
| Audit-Dienst | Manipulationssichere Audit-Spur mit Hash-Verkettung |
| Abrechnungsservice | Nutzungsabrechnung und Abonnementverwaltung |
| Maschinenidentität | Agentenregistrierung, Sitzungen und Vertrauensbewertung |
| AI CMO | KI-Inhaltsmoderation und -Orchestrierung |

Jeder Dienst zeigt seinen aktuellen Status (**fehlerfrei**, **eingeschränkt** oder **ausgefallen**), die Antwortzeit und den Prozentsatz der Sitzungsbetriebszeit an. Eine SLA-Konformitätsleiste vergleicht die Betriebszeit jedes Dienstes mit dem Ziel von 99,9 %.

> [!NOTE]
>
> Die auf der Registerkarte „Dienste“ angezeigten Verfügbarkeitsprozentsätze sind sitzungsbezogen – sie werden jedes Mal zurückgesetzt, wenn Sie das Dashboard öffnen. Für historische Verfügbarkeitsdaten besuchen Sie die [public status page](https://status.truthlocks.com) oder fragen Sie die [status API](https://docs.truthlocks.com/de/ops/health.md#programmatic-status-api) ab.

### Nutzung und Quoten

Der Nutzungs-Tab zeigt ein horizontales Balkendiagramm an, das den Verbrauch jeder gemessenen Ressource als Prozentsatz ihres Planlimits darstellt. Die Balken sind farbcodiert:

| Farbe | Nutzungsgrad |
| :- | :- |
| Cyan | Normal (unter 80 %) |
| Amber | Hoch (80% oder höher) |
| Rot | Am Limit (100 %) |

Zähler ohne konfiguriertes Kontingent werden separat unterhalb des Diagramms aufgeführt. Fahren Sie mit der Maus über eine beliebige Leiste, um die genaue Anzahl und das Limit anzuzeigen.

> [!TIP]
>
> Wenn ein Verbrauchszähler sein Limit erreicht, sollten Sie Ihren Plan aktualisieren oder den Support für ein benutzerdefiniertes Kontingent kontaktieren. Sobald ein Limit erreicht ist, geben API-Anfragen für diesen Vorgang HTTP 402 zurück. Details finden Sie unter [Ratenbegrenzungen](https://docs.truthlocks.com/de/ops/limits.md).

### Sicherheit

Der Sicherheits-Tab bietet Ihnen eine Live-Ansicht der Sicherheitslage Ihrer Umgebung in drei Dimensionen. Oben fassen drei Haltungskarten die Gesamtstärke zusammen:

| Haltungskarte | Was sie misst |
| :- | :- |
| **Kryptografische Integrität** | Ed25519-Signaturen, SHA-256-Audit-Hashing und Merkle-Baum-Transparenz. |
| **Mandantenisolation** | PostgreSQL-Zeilenebenensicherheit, schlüssel pro Mandant und Durchsetzung auf Gateway-Ebene. |
| **Audit-Trail** | Hash-verkettete Ereignisanzahl mit Integritätsprüfungsstatus. Zeigt „Achtung“ an, bis Ihr erstes Audit-Ereignis aufgezeichnet wird. |

Unterhalb der Haltungskarten sind einzelne Sicherheitskontrollen in drei Kategorien gruppiert:

#### Kryptografische Kontrollen

| Kontrolle | Algorithmus | Beschreibung |
| :- | :- | :- |
| Attestierungssignierung | Ed25519 (EdDSA) | Jede Attestierung wird kryptografisch mit einem Ed25519-Schlüssel signiert. |
| Audit-Hash-Kette | SHA-256 | Audit-Ereignisse werden mit SHA-256-Hashes verkettet, sodass Manipulationen erkennbar sind. |
| Auth / JWKS | ES256 (ECDSA P-256) | JWT-Token und JWKS-Schlüssel verwenden ES256 zur Authentifizierung. |
| Transparenzprotokoll | Merkle-Baum / SHA-256 | Ein manipulationssicherer Merkle-Baum bietet öffentliche Prüfbarkeit. |

#### Zugriffskontrollen

| Kontrolle | Mechanismus | Beschreibung |
| :- | :- | :- |
| Zeilenebene-Sicherheit | PostgreSQL RLS | Alle Datenbanktabellen erzwingen die Mandantenisolation auf Zeilenebene. |
| RBAC | Rollenbasierte Zugriffskontrolle | Granulare Berechtigungen, die auf Ihre definierten Rollen zugeschnitten sind. |
| API Gateway | nginx + Ratenbegrenzung | Pro-IP- und Pro-Mandanten-Ratenbegrenzungen werden am Gateway erzwungen. |
| Dienstauthentifizierung | Interne Dienstschlüssel | Die Kommunikation von Dienst zu Dienst wird mit gemeinsamen Schlüsseln authentifiziert. |

#### Datenschutz-Kontrollen

| Kontrolle | Mechanismus | Beschreibung |
| :- | :- | :- |
| Mandantenisolation | Multi-Tenant RLS | Vollständige Datentrennung zwischen Mandanten auf Datenbankebene. |
| Audit-Unveränderlichkeit | Nur anhängen + Hash-Kette | Ereignisse können nach der Erstellung nicht gelöscht oder geändert werden. Zeigt „Achtung“ an, bis Ihr erstes Ereignis aufgezeichnet wird. |
| Schlüsselrotation | Schlüssel-Lebenszyklus pro Aussteller | Schlüssel können rotiert und ersetzt werden, ohne historische Bescheinigungen zu verlieren. |

Jede Kontrolle zeigt ein **Durchgesetzt**-Abzeichen, wenn sie aktiv ist, oder ein **Achtung**-Abzeichen, wenn sie eine Aktion erfordert (z. B. wenn noch keine Audit-Ereignisse aufgezeichnet wurden).

## Mandanten-Dashboard-Diagramme

Das Haupt-Tenant-Dashboard (Seite **Home** in der Konsolen-Seitenleiste) enthält drei Attestations-Einblicksdiagramme, wenn Sie mindestens eine Attestation haben:

| Diagramm | Typ | Was es zeigt |
| :- | :- | :- |
| **Bestätigungsstatus** | Donut (Kreisdiagramm) | Aufschlüsselung der aktiven, widerrufenen und anderen Bestätigungen mit einer farbcodierten Legende |
| **Ausstellerabdeckung** | Balkendiagramm | Aktive Aussteller im Vergleich zu allen konfigurierten Ausstellern |
| **Plattformzustand** | Radialanzeige | Prozentsatz der derzeit aktiven Bestätigungen, dargestellt als Halbkreis-Anzeige |

Diese Diagramme bieten eine schnelle visuelle Zusammenfassung des Zustands Ihres Bestätigungsportfolios, ohne zum vollständigen Observability-Dashboard navigieren zu müssen.

## Programmatische Überwachung

Für maschinenlesbare Gesundheitsdaten außerhalb der Konsole verwenden Sie die [Status-API](https://docs.truthlocks.com/de/ops/health.md#programmatic-status-api) oder den [Abrechnungsnutzungs-Endpunkt](https://docs.truthlocks.com/de/api-reference/billing/usage.md). Diese Endpunkte ermöglichen es Ihnen, Truthlocks-Metriken in Ihre eigenen Dashboards oder Alarmierungspipelines zu integrieren.

## Nächste Schritte

> [card] [Zustand und Bereitschaft](https://docs.truthlocks.com/ops/health.md)
>
> Health-Endpunkte, Statusseite und Überwachungsintegrationen.

> [card] [Billing-Nutzung](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> Verfolgen Sie Prägungen, Verifizierungen und Speicherung über die API.

> [card] [Ratenbegrenzungen](https://docs.truthlocks.com/ops/limits.md)
>
> Planen Sie Kontingente und wie mit 429- und 402-Antworten umzugehen ist.

> [card] [Audit-Protokolle](https://docs.truthlocks.com/security/audit.md)
>
> Fragen Sie Ihren Audit-Trail ab und exportieren Sie ihn.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.