News

Die IT-Dokumentation ist vollständig – und seit dem letzten Change bereits veraltet. Ein neuer Service wurde eingerichtet, ein Schwellwert angepasst oder eine Zuständigkeit geändert. Der technische Betrieb arbeitet längst mit dem neuen Stand, während das Dokument noch die alte Realität beschreibt. Wer seine IT-Dokumentation aktuell halten will, darf sie deshalb nicht als nachgelagerte Schreibarbeit behandeln.

In vielen Unternehmen wird die Dokumentation projektweise erstellt. Vor einer Übergabe, einem Audit oder einer Zertifizierung werden Geräte, Dienste, Kontakte und Verfahren zusammengetragen. Zu diesem Zeitpunkt kann die IT-Dokumentation tatsächlich vollständig sein. Doch IT-Landschaften verändern sich kontinuierlich: Systeme werden ersetzt, Prüfungen erweitert, Bereitschaftspläne angepasst und Abläufe nach Incidents verbessert.

Die entscheidende Frage ist daher nicht nur, ob eine Dokumentation vorhanden ist. Entscheidend ist, wie schnell eine Änderung im Betrieb auch im dokumentierten Stand sichtbar wird.

Aus meiner Sicht muss IT-Dokumentation dort entstehen, wo die Veränderung stattfindet. Technische Informationen sollten möglichst aus der laufend gepflegten Monitoring-Konfiguration übernommen werden. Erfahrungswissen, Entscheidungen und Verfahrensanweisungen bleiben Aufgabe der Menschen – müssen aber direkt mit den betroffenen Systemen und Services verbunden sein.

Warum Dokumentation veraltet

Dokumentationslücken entstehen selten aus mangelnder Sorgfalt. Meist ist der Prozess falsch organisiert. Eine technische Änderung wird produktiv umgesetzt, getestet und abgeschlossen. Die Dokumentation steht anschließend als eigener Arbeitsschritt auf einer Liste. Unter Zeitdruck wird sie verschoben oder nur teilweise erledigt.

Hinzu kommt, dass Informationen an mehreren Stellen gepflegt werden. Hostnamen stehen in einer Tabelle, Kontakte in einem Notfallhandbuch, Schwellwerte im Monitoring und Verfahrensanweisungen in einem Teamordner. Ändert sich ein Wert, müssen mehrere Personen daran denken, alle Kopien anzupassen. Je mehr parallele Datenbestände bestehen, desto größer wird die Gefahr widersprüchlicher Versionen.

Auch unklare Verantwortung spielt eine Rolle. Wer aktualisiert die Dokumentation nach einem Change: die Administration, das Projektteam, der Service Owner oder der Service Desk? Ohne einen festgelegten Auslöser und eine eindeutige Zuständigkeit bleibt die Aufgabe zwischen den Rollen liegen.

Das Ergebnis ist Dokumentationsdrift: Der dokumentierte Sollzustand entfernt sich schrittweise vom tatsächlichen Betriebszustand.

Was nach einem Change nicht mehr stimmt

Eine Änderung betrifft häufig mehr Informationen, als auf den ersten Blick sichtbar ist. Wird beispielsweise ein Server ersetzt, ändern sich möglicherweise Hostname, IP-Adresse, Betriebssystem, Dienste, Abhängigkeiten und verantwortliche Personen. Neue Monitoring-Prüfungen kommen hinzu, alte werden entfernt oder Schwellwerte angepasst.

Auch organisatorische Änderungen wirken sich aus. Ein neuer Bereitschaftsplan verändert, wer bei einem Alarm erreichbar sein muss. Eine geänderte Eskalationsstufe beeinflusst Reihenfolge und Zeitfenster der Benachrichtigung. Nach einem Incident kann eine neue Verfahrensanweisung erforderlich sein, damit derselbe Fehler beim nächsten Mal schneller behoben wird.

Eine belastbare IT-Dokumentation umfasst deshalb nicht nur eine Inventarliste. Sie verbindet mindestens vier Informationsarten:

• technische Objekte und ihre Konfiguration;

• überwachte Services, Prüfungen und Schwellwerte;

• Zuständigkeiten, Kontakte und Eskalationswege;

• Anleitungen für Betrieb, Störung und Wiederherstellung.

Diese Inhalte verändern sich mit unterschiedlicher Geschwindigkeit. Genau deshalb ist eine Kombination aus Automatisierung und bewusster redaktioneller Pflege sinnvoll.

Monitoring als aktuelle Datenquelle

Eine Monitoring-Konfiguration enthält viele Informationen, die auch für die IT-Dokumentation benötigt werden. Dazu zählen Geräte, Services, technische Eigenschaften, Prüfparameter, Schwellwerte, Abhängigkeiten und Zuständigkeiten. Im täglichen Betrieb müssen diese Angaben ohnehin aktuell sein, weil sonst falsche Systeme geprüft, Alarme zu spät ausgelöst oder die falschen Personen informiert werden.

Werden dieselben Informationen anschließend manuell in ein separates Dokument übertragen, entsteht eine unnötige zweite Pflegeebene. Die bessere Lösung ist, die operative Konfiguration als aktuelle Datenquelle für die technische Dokumentation zu nutzen.

Bei der WOTAN IT-Dokumentation werden Informationen aus der Monitoring-Konfiguration und deren Änderungen automatisiert in das WOTAN Wiki übertragen. Für Hosts und Services können Dokumentationseinträge mit den vorhandenen Basisinformationen bereitgestellt werden. Änderungen an überwachten Geräten, Diensten, Prüfungen, Kontakten oder Bereitschaftsplänen fließen damit aus jener Umgebung in die Dokumentation, in der sie für den Betrieb gepflegt werden.

Automatisierung beseitigt jedoch nicht jede Dokumentationslücke. Sie kann nur Informationen übernehmen, die im Monitoring vorhanden und korrekt gepflegt sind. Bleibt ein Change auch in der Monitoring-Konfiguration unberücksichtigt, fehlt weiterhin die verlässliche Datenbasis. Die Qualität der automatisierten Dokumentation hängt daher unmittelbar von der Qualität des operativen Konfigurationsprozesses ab.

Was Menschen ergänzen müssen

Nicht jede wichtige Information lässt sich aus technischen Feldern erzeugen. Eine gute Betriebsdokumentation erklärt auch, warum eine Einstellung gewählt wurde, welche Auswirkung eine Änderung haben kann und wie in einer Ausnahmesituation vorzugehen ist.

Manuell gepflegt werden sollten beispielsweise:

• fachlicher Zweck und Geschäftskritikalität eines Services;

• Begründungen für besondere Konfigurationsentscheidungen;

• bekannte Einschränkungen und akzeptierte Risiken;

• Abhängigkeiten zu externen Anbietern oder organisatorischen Abläufen;

• geprüfte Schritte zur Fehlerbehebung und Wiederherstellung;

• Hinweise aus vergangenen Incidents und Problemfällen;

• Bedingungen für Eskalation, Workaround und Rückfallverfahren.

Diese Trennung ist wichtig: Automatisierung hält strukturierte technische Fakten aktuell. Menschen ergänzen Kontext, Erfahrung und Entscheidungswissen. Erst beides zusammen macht die Dokumentation im Betrieb wirklich nutzbar.

Das WOTAN Wiki verbindet diese beiden Ebenen. Automatisch erzeugte Inhalte können individuell erweitert werden. Damit bleibt die technische Basis eng mit der Monitoring-Konfiguration verbunden, während Administratoren, Service Desk und andere Verantwortliche ihr Betriebswissen ergänzen können.

Verfahrensanweisungen am richtigen Ort

Im Incident Management zählt nicht nur, ob eine Anleitung existiert. Sie muss im entscheidenden Moment auffindbar und dem betroffenen System eindeutig zugeordnet sein. Eine umfangreiche Wissensdatenbank hilft wenig, wenn ein Mitarbeiter während einer Störung zuerst nach dem richtigen Dokument suchen und dessen Gültigkeit prüfen muss.

Verfahrensanweisungen sollten deshalb direkt mit Hosts oder Services verknüpft sein. In WOTAN können dafür definierte Abschnitte aus dem Wiki beim zugehörigen Monitoring-Objekt verfügbar gemacht werden. Erkennt das Monitoring eine Abweichung, lässt sich die passende Handlungsanweisung im Kontext des betroffenen Geräts oder Dienstes aufrufen.

Solche Anweisungen können zum Beispiel festhalten:

• welche Erstprüfung durchzuführen ist;

• welcher Workaround freigegeben wurde;

• welche Abhängigkeiten vor einem Neustart zu beachten sind;

• wann ein Spezialist oder externer Partner einzubeziehen ist;

• wie die erfolgreiche Wiederherstellung geprüft wird;

• welche Informationen für die Nachbearbeitung zu dokumentieren sind.

Eine Verfahrensanweisung ist allerdings kein statischer Text. Nach einem Change muss geprüft werden, ob die beschriebenen Schritte weiterhin stimmen. Nach einem Incident sollte kontrolliert werden, welche Information gefehlt hat oder welcher Schritt verbessert werden kann.

Der Change aktualisiert die Doku

Die IT-Dokumentation aktuell zu halten gelingt am zuverlässigsten, wenn jeder relevante Change zugleich einen Dokumentationsprozess auslöst. Dokumentation wird dann nicht irgendwann nachgetragen, sondern ist Teil der Definition of Done.

Ein praxistauglicher Ablauf besteht aus fünf Schritten:

1. Auswirkung bestimmen: Welche Geräte, Services, Abhängigkeiten, Kontakte und Verfahren betrifft die geplante Änderung?

2. Konfiguration anpassen: Die produktive Monitoring-Konfiguration wird entsprechend dem freigegebenen Change aktualisiert.

3. Technische Daten übernehmen: Dokumentierbare Konfigurationsinformationen werden automatisiert mit dem neuen Stand abgeglichen.

4. Betriebswissen prüfen: Verantwortliche kontrollieren Verfahrensanweisungen, Begründungen, Workarounds und Wiederherstellungsschritte.

5. Vollständigkeit bestätigen: Der Change wird erst abgeschlossen, wenn Monitoring, Dokumentation und betriebliche Zuständigkeiten zusammenpassen.

Das IT-Service-Management liefert dafür den organisatorischen Rahmen. Change Management strukturiert geplante Änderungen; CMDB und Inventarisierung ordnen Betriebsmittel zu; Tickets und Wissensdatenbank dokumentieren Vorfälle, Lösungen und Erfahrungen. Die Verbindung mit dem Monitoring verhindert, dass technische Realität und dokumentierter Stand als voneinander getrennte Welten behandelt werden.

Aktuelle Dokumentation schützt den Betrieb

Eine aktuelle IT-Dokumentation spart nicht nur Zeit bei Audits. Ihr größter Nutzen zeigt sich im täglichen Betrieb und besonders in Störungen.

Fällt ein wichtiger Mitarbeiter aus, können Vertretungen Zuständigkeiten, Konfigurationen und erprobte Lösungswege nachvollziehen. Bei einem Incident verkürzt eine passende Verfahrensanweisung die Suche nach dem nächsten Schritt. Bei einem schwerwiegenden Ausfall unterstützen aktuelle Systeminformationen und ein Notfallhandbuch die geordnete Wiederaufnahme des Betriebs.

Aktualität reduziert außerdem das Risiko falscher Entscheidungen. Ein veralteter Kontakt verzögert die Alarmierung. Ein überholter Schwellwert führt zu falschen Annahmen. Eine nicht mehr gültige Wiederherstellungsanweisung kann die Störung sogar verschärfen.

Betriebssicherheit entsteht daher nicht durch möglichst viele Dokumentseiten. Sie entsteht durch verlässliche Informationen, klare Verantwortung und direkten Zugriff im richtigen Kontext.

Aktualität regelmäßig prüfen

Auch eine automatisierte IT-Dokumentation braucht Qualitätskontrolle. Unternehmen sollten regelmäßig prüfen:

• Welche technischen Angaben werden aus einer führenden Quelle übernommen?

• Welche Inhalte werden manuell gepflegt und wer ist dafür verantwortlich?

• Welche Changes haben eine Überprüfung der Dokumentation ausgelöst?

• Wurden nach Incidents fehlende oder unklare Anweisungen verbessert?

• Sind Kontakte, Bereitschaftspläne und Eskalationswege noch gültig?

• Lässt sich im Notfall auch ohne das produktive System auf wichtige Unterlagen zugreifen?

Der BizResilient-Cycle ordnet diese Prüfung in einen kontinuierlichen Verbesserungsprozess ein: Inhalte und Zuständigkeiten planen, Dokumentation in den Betrieb integrieren, ihre Wirksamkeit bei Tests und Incidents kontrollieren und erkannte Lücken gezielt schließen.

So wird Aktualität nicht als einmaliger Zustand verstanden, sondern als messbare Eigenschaft eines funktionierenden Betriebsprozesses.

Fazit: Dokumentation folgt dem Betrieb

Eine IT-Dokumentation kann an einem Tag vollständig und am nächsten bereits veraltet sein. Das liegt nicht an ihrem Umfang, sondern an der fehlenden Verbindung zu Changes, Monitoring und täglicher Arbeit.

Wer seine IT-Dokumentation aktuell halten möchte, sollte strukturierte technische Informationen nicht mehrfach manuell pflegen. Die laufend benötigte Monitoring-Konfiguration kann als Datenquelle für Geräte, Services, Prüfungen, Schwellwerte und Zuständigkeiten dienen. Verfahrensanweisungen und Erfahrungswissen werden von Menschen ergänzt, direkt mit den betroffenen Objekten verbunden und nach Changes sowie Incidents überprüft.

Für mich ist eine Dokumentation dann hochwertig, wenn sie nicht nur vollständig aussieht, sondern im richtigen Moment eine verlässliche Entscheidung ermöglicht. Dazu muss sie der technischen Realität folgen – möglichst automatisch und dort, wo menschliches Wissen gefragt ist, mit klarer Verantwortung.

Sie möchten Ihre IT-Dokumentation enger mit Monitoring, Änderungen und Störungsbehebung verbinden? Informieren Sie sich über die WOTAN IT-Dokumentation oder vereinbaren Sie ein unverbindliches Gespräch.