# Issues

Wiederkehrende Systemanomalien verfolgen (Fehler bei Verzeichnissync, Provisionierung, Metadaten), gruppiert und bis zur Behebung bearbeitet.

Ein **Issue** ist eine wiederkehrende *System*-Anomalie, die die Plattform selbst erkannt hat: ein Betriebsfehler, der im Hintergrund auftritt und sich tendenziell wiederholt. Wo das [Audit-Log](https://dts-identity.com/de/docs/monitoring/audit-logs.md) einzelne Ereignisse aufzeichnet, rollen Issues viele Vorkommnisse desselben zugrundeliegenden Problems zu einem einzigen Eintrag zusammen, den Sie bis zur Behebung verfolgen können, sodass ein Verzeichnis, das jede Stunde nicht synchronisiert wird, als **ein** Issue mit steigender Vorkommnis-Zählung erscheint statt als Dutzende verstreuter Log-Zeilen.

Sie finden es unter **Audit-Trail → Probleme** in der Admin Console.

Betrachten Sie Issues als Ihre **Triage-Warteschlange für Dinge, die die Plattform von selbst bemerkt hat**: Fehler bei Synchronisation, Provisionierung, Metadaten und Kapazität sowie ähnliche wiederkehrende Muster tauchen hier automatisch auf, bereits gruppiert, sodass Sie das *Problem* bearbeiten statt einzelnen Log-Zeilen nachzujagen. Es ergänzt das [Audit-Log](https://dts-identity.com/de/docs/monitoring/audit-logs.md): das Audit-Log ist das, was Sie *durchsuchen*, wenn Sie eine konkrete Frage haben ("Was ist mit Benutzer X passiert?"); Issues ist das, was Sie *überprüfen*, um Probleme zu erfassen, die im Hintergrund still wiederkehren.

## Was zu einem Issue wird

Issues werden für Hintergrundvorgänge ausgelöst, die fehlschlagen, typischerweise:

- **Verzeichnissynchronisation**: ein fehlgeschlagener Sync-Lauf, ein Upstream-Benutzer-Sync-Fehler, ein Passwort-Sync-Fehler oder ein Sync-Problem pro Benutzer (etwa eine doppelte E-Mail, die bereits von einem anderen Benutzer verwendet wird).
- **Provisionierung (SCIM)**: Fehler beim Erstellen, Aktualisieren, Deaktivieren oder Löschen von Benutzern oder Gruppen in einer verbundenen nachgelagerten Anwendung oder eine Verbindung, die nicht erreicht werden konnte.
- **SAML-Metadaten**: eine Metadaten-URL, die nicht aktualisiert werden konnte, oder ein Request, der nicht geparst werden konnte.
- **Kapazität**: eine Geräteregistrierung, die abgelehnt wurde, weil das Gerätekontingent erreicht war.

Jedes Issue trägt einen **Schweregrad** *Warning* oder *Error* und ist mit dem zugehörigen Objekt (Anwendung, Verzeichnis, Gerät oder Benutzer) verknüpft, sofern eines zutrifft.

## Wie die Gruppierung funktioniert

Wiederholte Vorkommnisse derselben Grundursache werden zu einem einzigen Issue zusammengefasst. Jedes Issue verfolgt:

- eine **Vorkommnis-Zählung**: wie oft das zugrundeliegende Ereignis gesehen wurde;
- einen **Zuerst-gesehen**- und **Zuletzt-gesehen**-Zeitstempel;
- ein Histogramm der Vorkommnisse über die Zeit, das Sie über die **letzten 24 Stunden, 30 Tage oder 90 Tage** betrachten können, sodass Sie einen einmaligen Ausschlag von einem anhaltenden Problem in der von Ihnen benötigten Granularität unterscheiden können.

## Issue-Zustände

Ein Issue durchläuft diese Zustände:

| Zustand | Bedeutung |
|---|---|
| **Unresolved** | Offen und aufmerksamkeitsbedürftig: der Standard für ein neu ausgelöstes Issue. |
| **Resolved** | Sie haben die zugrundeliegende Ursache behoben und als erledigt markiert. |
| **Regressed** | Ein zuvor behobenes Issue, das erneut aufzutreten begonnen hat. |
| **Archived** | Beiseitegelegt und nicht mehr in den aktiven Listen angezeigt. |

Die Ansicht öffnet auf der Registerkarte **Unresolved** und bietet außerdem die Registerkarten **Resolved**, **Regressed** und **Archived**, sodass Sie zwischen offener Arbeit, erledigten Dingen, zurückgekehrten Problemen und beiseitegelegten Elementen wechseln können.

[Image: Die Issue-Liste mit wiederkehrenden Provisionierungsfehlern und ihrer Häufigkeit]

## Ein Issue bearbeiten

1. Öffnen Sie **Audit-Trail → Probleme**. Die Registerkarte **Unresolved** listet offene Issues, zuletzt gesehene zuerst.
2. Wählen Sie ein Issue, um seine Detailansicht zu öffnen. Sie sehen seinen Typ, Schweregrad, das zugehörige Objekt, die Vorkommnis-Zählung, Zuerst-/Zuletzt-gesehen-Zeiten, ein Histogramm pro Issue und den vollständigen Ereigniskontext.
3. Untersuchen Sie die Grundursache anhand des Kontexts, zum Beispiel indem Sie die Verzeichnis-Anmeldedaten oder das nachgelagerte Provisionierungs-Mapping korrigieren.
4. **Ändern Sie den Zustand**: markieren Sie das Issue als *Resolved*, sobald Sie es behoben haben. Tritt dasselbe Problem später erneut auf, kehrt es als *Regressed* zurück, damit es nicht verloren geht. Ein behobenes oder archiviertes Issue kann von seiner Detailseite aus **wieder geöffnet** (zurück auf *Unresolved* gesetzt) werden.
5. **Archivieren** Sie ein Issue, das Sie aus den aktiven Listen haben, aber im Datensatz behalten möchten: verwenden Sie **Actions → Archive** auf der Detailseite. Ein archiviertes Issue ist aus den Registerkarten Unresolved/Resolved ausgeblendet und lebt auf der Registerkarte **Archived**; das Issue und seine Historie bleiben erhalten, und Sie können es weiterhin wieder öffnen. Das Archivieren ist die umkehrbare Aktion "Ich habe das gesichtet, beiseitegelegt".
6. **Löschen** Sie ein Issue nur, wenn Sie es wirklich nicht im Datensatz benötigen. Das Löschen entfernt das Issue dauerhaft: anders als beim Archivieren gibt es kein Rückgängig und keine erhaltene Historie.

## Verwandtes

- [Audit-Logs](https://dts-identity.com/de/docs/monitoring/audit-logs.md): der Datensatz pro Ereignis, aus dem Issues abgeleitet werden.
- [Plans & add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md): was Ihre Stufe umfasst.
