Projekte

IT-Dokumentation nach Standort: Wie Kosmos.Atlas Räume, Racks und Geräte verbindet

Eine technische Umgebung lässt sich erstaunlich detailliert dokumentieren und trotzdem im entscheidenden Moment eine ganz banale Frage offenlassen: Wo befindet sich das betreffende Gerät eigentlich? IP-Adresse, Modell, Betriebssystem, Schnittstellen und technische Beziehungen sind wichtig, helfen aber nur begrenzt weiter, wenn jemand vor Ort nicht weiß, in welchem Gebäude, Raum oder Rack die gesuchte Komponente zu finden ist. Gerade in Produktionsbetrieben, Werkstätten, Lagern oder größeren privaten technischen Umgebungen entsteht deshalb neben der rein technischen Dokumentation zwangsläufig eine zweite Ebene, nämlich die räumliche Zuordnung der vorhandenen Systeme.

Genau dafür gibt es Kosmos.Atlas. Während Argos die IT-Infrastrukturanalyse übernimmt und technische Systeme möglichst automatisch erkennt, soll Atlas diese technischen Informationen mit der realen Welt verbinden. Ein Switch ist dann nicht nur ein Netzwerkgerät mit einer bestimmten Adresse, sondern steht beispielsweise in Gebäude 1, im Erdgeschoss, im Technikraum, in Rack 2 und dort auf einer konkreten Position. Dasselbe Prinzip lässt sich auf Maschinen, mobile Geräte, Lagerobjekte oder andere Dinge übertragen, deren physischer Standort für Betrieb, Wartung oder Fehlersuche relevant ist.

Eine räumliche Struktur muss der wirklichen Umgebung entsprechen

Eine einfache Standortangabe als Freitextfeld wirkt zunächst ausreichend, solange nur wenige Geräte erfasst werden müssen. Mit zunehmender Größe entstehen daraus jedoch schnell uneinheitliche Angaben wie „EG Technik“, „Technikraum unten“ oder „Serverraum Erdgeschoss“, die für einen Menschen noch ungefähr verständlich sein mögen, für eine systematische Auswertung aber keine verlässliche Struktur mehr bilden. Deshalb soll Atlas Standorte hierarchisch abbilden und nicht nur als beliebigen Text speichern.

Ein Gebäude kann Etagen enthalten, innerhalb einer Etage liegen Räume, und innerhalb eines Raumes können wiederum Racks, Regale oder andere Unterstrukturen vorhanden sein. Ein Rack kann einzelne Einbaupositionen besitzen, ein Regal wiederum Fächer, während andere Objekte vielleicht direkt einem Raum zugeordnet werden. Dadurch entsteht kein künstliches abstraktes Modell, sondern eine digitale Abbildung dessen, was ein Mensch vor Ort tatsächlich vorfindet.

Diese Hierarchie ist für mich besonders deshalb wichtig, weil sie unterschiedliche Größenordnungen miteinander verbinden kann. Ein Server befindet sich möglicherweise sehr präzise in einem Rack, eine Maschine dagegen lediglich in einer bestimmten Halle, während ein mobiler Gegenstand vielleicht nur einem Gebäude oder einer Abteilung zugeordnet werden kann. Atlas soll diese unterschiedlichen Genauigkeiten zulassen, ohne für jede Objektart eine komplett eigene Standortlogik zu benötigen.

Technische Identität und physischer Standort bleiben getrennt

Ein zentrales Architekturprinzip von Atlas besteht darin, ein Objekt nicht mit seinem Standort gleichzusetzen. Ein Switch bleibt derselbe Switch, wenn er aus Rack 1 in Rack 2 umgebaut wird, und eine Maschine verliert ihre technische Identität nicht dadurch, dass sie innerhalb einer Halle an einen anderen Platz versetzt wird. Die räumliche Zuordnung ist deshalb eine eigene Information, die sich unabhängig vom technischen Objekt verändern kann.

Diese Trennung klingt zunächst selbstverständlich, verhindert aber eine Menge unnötiger Probleme. Wenn Standort und Gerät zu eng miteinander verbunden würden, könnte jede physische Veränderung dazu führen, dass technische Beziehungen, Historien oder andere Zuordnungen ebenfalls neu aufgebaut werden müssten. In Atlas soll stattdessen lediglich der Ort wechseln, während das Objekt selbst und seine übrigen Eigenschaften erhalten bleiben.

Gerade in Verbindung mit Argos ist das wichtig. Argos kann ein technisches System erneut erkennen, auch wenn es physisch an einer anderen Stelle steht; Atlas wiederum kann feststellen, dass die dokumentierte räumliche Zuordnung nicht mehr passt oder bewusst geändert wurde. Beide Anwendungen beschreiben dasselbe reale Objekt aus unterschiedlichen Blickwinkeln, ohne ihre Verantwortlichkeiten miteinander zu vermischen.

Racks sind mehr als nur ein weiterer Standort

Bei Netzwerk- und Servertechnik reicht die Angabe eines Raums häufig nicht aus. Wer vor einem voll bestückten Rack steht, möchte im Idealfall schon vorher wissen, welche Geräte dort eingebaut sind, auf welchen Positionen sie sitzen und wie die vorhandene Struktur ungefähr aussieht. Deshalb gehört für mich eine Rackansicht zu Atlas und nicht lediglich ein Feld mit der Bezeichnung des Schranks.

Eine solche Darstellung kann später deutlich mehr leisten als eine optisch hübsche Skizze. Sie kann helfen, freie Positionen zu erkennen, Geräte schneller zuzuordnen und bei Wartungsarbeiten vorab zu sehen, welches System sich an welcher Stelle befinden sollte. Gerade bei Kundenumgebungen oder Installationen, die man nicht täglich sieht, reduziert das die Abhängigkeit vom eigenen Erinnerungsvermögen erheblich.

Dasselbe Prinzip lässt sich auf Regale oder Fächer übertragen, wenn dort Ersatzgeräte, technische Komponenten oder andere relevante Objekte liegen. Atlas ist damit nicht auf klassische Rechenzentrumstechnik beschränkt, sondern bildet allgemein den physischen Kontext ab, in dem technische und andere relevante Objekte vorkommen.

QR-Codes verbinden den realen Gegenstand direkt mit seiner digitalen Darstellung

Besonders nützlich wird diese räumliche Dokumentation für mich dann, wenn sich die physische und digitale Welt ohne Sucharbeit miteinander verbinden lassen. Ein QR-Code an einem Rack, einem Regal, einer Maschine oder einem Gerät kann direkt zu dem passenden Atlas-Eintrag führen, sodass ich vor Ort nicht erst nach Namen, Seriennummern oder Inventarkennungen suchen muss. Der reale Gegenstand wird damit selbst zum Einstiegspunkt in seine Dokumentation.

Das funktioniert auch in die andere Richtung. Wenn ich einen Eintrag in Atlas öffne, kann die räumliche Struktur anzeigen, wo das Objekt zu finden sein sollte, und bei Bedarf bis auf Raum, Rack und konkrete Position herunterführen. Dadurch wird die Ortsangabe nicht zu einem Zusatzfeld, das irgendwann veraltet, sondern zu einem integralen Bestandteil der täglichen Nutzung.

Gerade auf dem Smartphone ergibt diese Verbindung Sinn, weil der Arbeitsort häufig nicht der Schreibtisch ist. Wenn ich direkt am Rack stehe, sollte ich dort Informationen prüfen oder eine Standortänderung erfassen können, anstatt mir vorzunehmen, die Dokumentation später am Rechner zu korrigieren. Jede zusätzliche Hürde erhöht die Wahrscheinlichkeit, dass solche Änderungen irgendwann nicht mehr sauber nachgeführt werden.

Atlas soll nicht nur perfekte Zuordnungen darstellen

Eine realistische Dokumentation besteht nicht ausschließlich aus vollständig gepflegten Datensätzen. Es kann Systeme geben, die Argos technisch erkennt, deren physischer Standort aber noch unbekannt ist, und ebenso kann Atlas einen dokumentierten Platz enthalten, an dem das erwartete Gerät technisch nicht mehr gefunden wird. Genau solche Lücken und Widersprüche sind für mich relevante Informationen und sollen deshalb nicht unsichtbar gemacht werden.

Ein nicht zugeordnetes Gerät kann bedeuten, dass die Dokumentation noch ergänzt werden muss. Ein dokumentiertes Gerät, das technisch nicht mehr auftaucht, kann auf einen Umbau, einen Defekt oder schlicht eine veraltete Zuordnung hinweisen. Kompass kann solche offenen Punkte später gezielt hervorheben, anstatt nur eine scheinbar perfekte Umgebung zu präsentieren.

Dieses Prinzip gefällt mir generell an Kosmos: Ein System sollte fehlendes Wissen als fehlendes Wissen darstellen können. Es muss nicht jede Lücke mit einer Vermutung schließen, nur damit die Oberfläche vollständig aussieht.

Atlas macht technische Umgebungen räumlich verständlich

Der eigentliche Nutzen von Atlas entsteht für mich deshalb nicht durch einzelne Funktionen wie Rackansichten oder QR-Codes, sondern durch den räumlichen Zusammenhang, den diese Funktionen gemeinsam schaffen. Eine IT-Infrastruktur besteht nicht ausschließlich aus Adressen, Geräten und Diensten, sondern befindet sich in Gebäuden, Räumen, Schränken und an Maschinen, an denen im Fehlerfall ein realer Mensch arbeiten muss.

Wenn die technische Analyse von Argos und die räumliche Struktur von Atlas zusammenkommen, lässt sich dieselbe Umgebung auf zwei Arten betrachten, die sich sinnvoll ergänzen. Ich kann verstehen, was technisch vorhanden ist und gleichzeitig nachvollziehen, wo es physisch zu finden ist, ohne beide Fragen in einer einzigen Anwendung vermischen zu müssen.

Damit wird Atlas für mich zu mehr als einer Standortverwaltung. Es bildet die räumliche Ebene von Kosmos und sorgt dafür, dass technische Informationen nicht in einer abstrakten digitalen Welt enden, sondern mit der Umgebung verbunden bleiben, in der sie tatsächlich genutzt werden.