/

IT-Workarounds dokumentieren, die nicht in SOPs gehören

von Team Ninja
How to Document Workarounds That Don’t Belong in SOPs blog banner image
How to Document Workarounds That Don’t Belong in SOPs blog banner image

Try our #1 rated endpoint management platform on G2

NinjaOne dashboard screenshot

Automate the Hardest Parts of IT

Die wichtigsten Punkte

  • Definieren Sie klare Kriterien, die temporäre Workarounds von Standard-SOPs abgrenzen.
  • Führen Sie ein zentrales, strukturiertes Verzeichnis für alle Workarounds.
  • Verknüpfen Sie Workaround-Einträge mit den relevanten Assets und Service-Datensätzen.
  • Prüfen Sie veraltete Workarounds in regelmäßigen Governance-Zyklen und setzen Sie sie außer Kraft.
  • Schulen Sie Techniker:innen darin, Workarounds einheitlich zu dokumentieren und zu verwalten.

Standardprozeduren (SOPs) sind ein zentrales Tool für Managed Service Provider (MSPs): Sie definieren wiederholbare Schritte für wiederkehrende Aufgaben und ermöglichen so einen konsistenten, gründlichen Service.

Trotzdem gibt es Situationen, in denen Sie Workarounds zur Fehlerbehebung und einmalige Lösungen brauchen, um die spezifischen Anforderungen von Kund:innen oder Benutzer:innen zu erfüllen. Das Problem: Diese schnellen Fixes verstopfen schnell Ihr SOP-Verzeichnis, wenn sie nicht sauber dokumentiert werden.

Dieser Leitfaden erklärt, wie Sie IT-Workarounds dokumentieren, die nicht in Ihre SOPs gehören.

Darum sollten Sie Workarounds in der IT dokumentieren

IT-Workarounds sind vorübergehende Lösungen für unerwartete System- oder Softwareprobleme. Sie ermöglichen es Benutzer:innen, weiterzuarbeiten, während die IT das Problem untersucht und nach einer langfristigen Lösung sucht.

Eines der größten Probleme mit Workarounds: Sie werden häufig zu „Tribal Knowledge“, das nur in den Köpfen einzelner Personen existiert. Es kommt sehr oft vor, dass Techniker:innen vergessen, die von ihnen entwickelten Workarounds zu dokumentieren. Stößt dann ein:e neue:r Mitarbeiter:in auf dasselbe Problem, hat die ursprüngliche Technikerin oder der ursprüngliche Techniker den Workaround entweder komplett vergessen oder das Unternehmen bereits verlassen.

So sieht die Realität in vielen Support-Teams aus. Laut dem State of Teams Report 2024 von Atlassian haben 55 % der Wissensarbeiter:innen Schwierigkeiten, Informationen zu finden, obwohl sie wissen, dass diese im Unternehmen vorhanden sind. 50 % haben zudem unwissentlich Arbeit doppelt erledigt, weil Wissen schlecht geteilt wurde. Das zeigt deutlich, wie undokumentierte Prozesse und Tribal Knowledge zu operativen Engpässen führen.

Wenn Sie diese Workarounds in SOPs dokumentieren, bleiben sie zwar erhalten. Gleichzeitig kann das aber zu Verwirrung führen oder dazu, dass sie fälschlich als Teil der Standardkonfiguration verstanden und breit ausgerollt werden. Die Folge wären inkonsistente Konfigurationen und mögliche Sicherheits- oder Compliance-Lücken.

So dokumentieren Sie IT-Workarounds, ohne Ihre SOPs zu überfrachten

Die gute Nachricht: Es gibt einen Weg, IT-Workarounds zu dokumentieren, ohne die SOPs Ihres Unternehmens ungewollt aufzublähen. Dafür brauchen Sie:

  • Eine vorhandene Plattform für SOP-Dokumentation (z. B. IT Glue, Confluence, NinjaOne Docs oder SharePoint)
  • Einen festgelegten Rhythmus für SOP-Reviews (quartalsweise oder halbjährlich)
  • Einvernehmen darüber, was als Workaround gilt und was als regulärer SOP-Inhalt
  • Schulungen für Techniker:innen, wie neue Workarounds einheitlich erfasst werden
  • Eine klar definierte Richtlinie dazu, wie KI-Assistenten und Copiloten auf die Workaround-Dokumentation zugreifen, sie anzeigen oder auf ihrer Basis handeln dürfen
SchrittMaßnahmeErgebnis
1Workarounds von SOP-Kandidaten abgrenzen.Festgelegte Kriterien oder Entscheidungsbaum
2Ein Workaround-Verzeichnis anlegen.Zentrales, durchsuchbares Protokoll
3Workarounds mit Service-Datensätzen verknüpfen.Verknüpfung mit Assets und Tickets
4Workarounds prüfen und außer Kraft setzen.Governance-Rhythmus
5Den Geltungsbereich von Workarounds an Techniker:innen kommunizieren.Geschultes, abgestimmtes Team

Schritt 1: Workarounds von SOP-Kandidaten abgrenzen

Trennen Sie klar, welche Verfahren und Informationen in Ihre SOPs gehören und was als „Workaround“ gilt. Als Workaround kann beispielsweise jeder Fix gelten, der ein Problem nur vorübergehend behebt oder einem einmaligen Zweck dient, etwa eine Einstellung oder Berechtigung für eine bestimmte Person aufgrund einer Sonderanforderung (zum Beispiel Legacy-Software, die lokale Administratorrechte zur Ausführung benötigt). Die Entscheidung, ob eine Information in ein SOP- oder ein Workaround-Dokument gehört, lässt sich als Tabelle oder Entscheidungsbaum darstellen und für künftige Fälle in Ihrer Dokumentationsplattform hinterlegen.

Schritt 2: Ein Workaround-Verzeichnis anlegen

Dokumentierte Workarounds sollten zentral, strukturiert und durchsuchbar abgelegt werden. Das schafft Überblick und stellt sicher, dass Workarounds auch gefunden werden. Andernfalls wird Arbeit doppelt erledigt und ihr Zweck läuft ins Leere. Folgende Felder sollten enthalten sein:

  • Eindeutige Workaround-ID
  • Datum der Erfassung
  • Problem- oder Systemkontext
  • Durchgeführte Schritte
  • Risiken oder Einschränkungen
  • Quelle (z. B. Ticketnummer, Techniker:in oder Kundenstandort)
  • Status (z. B. aktiv, ersetzt oder außer Kraft gesetzt)
  • Compliance-/Risikokennzeichnung
  • Prüf- oder Ablaufdatum

Eine einheitliche Struktur sorgt dafür, dass Techniker:innen immer wissen, wie sie Workaround-Details erfassen, und verhindert, dass Informationen fehlen. Manche Dokumentationsplattformen versenden automatisiert Benachrichtigungen oder Erinnerungen, wenn ein Workaround oder Dokument zur Prüfung ansteht oder sein Ablaufdatum näher rückt. Das reduziert manuelle Kontrollen.

Schritt 3: Workarounds mit Service-Datensätzen verknüpfen

Ihr ITSM-Toolset sollte Asset-Management umfassen, damit Sie die Komponenten Ihrer IT-Infrastruktur erfassen und deren Status nachverfolgen können. Wenn Sie in einem Asset auf Ihr Workaround-Verzeichnis verweisen (etwa durch Erfassen der eindeutigen Workaround-ID oder einen Link), sind die Workarounds im jeweiligen Kontext auffindbar. Geräte lassen sich zusätzlich kennzeichnen, wenn für sie ein aktiver Workaround besteht.

Indem Sie das Kennzeichnen, Erfassen und Prüfen von Workarounds in Ihrer Asset-Management-Plattform zum Bestandteil Ihrer SOPs machen, ist der Prozess dort abgebildet, ohne dass jeder einzelne Workaround in den SOP-Dokumenten stehen muss.

Schritt 4: Workarounds prüfen und außer Kraft setzen

Prüfen Sie Ihr Workaround-Verzeichnis regelmäßig in seiner Gesamtheit, damit veraltete oder nicht mehr benötigte Workarounds nicht dauerhaft in Ihrer Infrastruktur bestehen bleiben. Das lässt sich im Rahmen regelmäßiger IT-Governance-Zyklen erledigen. Optional können Sie Ablaufdaten setzen oder die Ticketerstellung automatisieren, wenn Workarounds ein Sicherheits- oder Compliance-Risiko darstellen. So werden sie geprüft und außer Kraft gesetzt oder die Maßnahmen zur Minderung bleiben erhalten.

Ein fester Prüfrhythmus gilt nicht nur als Best Practice für saubere Daten, er hilft auch dabei, Compliance nachzuweisen.

Manche Cyberversicherer verlangen Nachweise über laufende Kontrollen und eine kontinuierliche Überwachung, bevor sie eine Police ausstellen oder verlängern. Ein veraltetes Workaround-Verzeichnis wird schnell zur Prüfungsfeststellung, wenn es nicht regelmäßig überprüft wird.

Häufig eingesetzte Workarounds können nach weiteren Tests für die Aufnahme in SOPs infrage kommen, sofern sie den Best Practices entsprechen.

Schritt 5: Den Geltungsbereich von Workarounds an Techniker:innen kommunizieren

Ihre Techniker:innen sollten den Unterschied zwischen freigegebenen SOPs und Workarounds kennen. Workarounds sind als vorübergehend zu behandeln, mit vollständig dokumentierten technischen Details und den damit verbundenen Risiken. Für Workarounds mit hohem Risiko sollte vor der Anwendung eine Freigabe über die Eskalation erforderlich sein.

Techniker:innen sollten während der Einarbeitung und bei regelmäßigen Reviews auf diese Richtlinien hingewiesen werden.

Entscheidend ist außerdem eine Richtlinie dazu, wie KI-Agenten auf Workarounds zugreifen, sie anzeigen oder auf ihrer Basis handeln dürfen. KI-Agenten können diese Informationen über das Model Context Protocol lesen und darauf reagieren.

Workaround-Dokumentation und wirksame SOPs mit NinjaOne

NinjaOne bietet MSPs ein umfassendes Toolset: Fernwartung und -Verwaltung (inklusive Fernzugriff), Mobile Device Management (MDM) und Backup, dazu IT-Asset-Management (ITAM), Ticketdesk und Dokumentation. So können Sie Workarounds außerhalb von SOPs dokumentieren, mit Tickets und Assets verknüpfen und Endpunkte kennzeichnen, auf denen Workarounds aktiv sind.

Automatisierung und Patch-Management helfen dabei, Konflikte durch Workarounds zu vermeiden. Über geplante Skripte lassen sich Workarounds wieder zurücknehmen. Für den vollständigen Überblick können Sie zudem Dashboards und zusammenfassende Berichte erstellen.

Workarounds sind in der IT unvermeidlich und können, solange sie aktiv sind, ein dauerhaftes Compliance- oder Sicherheitsrisiko darstellen. Eine systematische Dokumentation, in der jeder Workaround vollständig erfasst und nachvollziehbar ist, verhindert, dass daraus Tribal Knowledge wird.

Quick-Start-Guide

Workarounds in NinjaOne dokumentieren

NinjaOne bietet mehrere Dokumentationsoptionen, um Workarounds zu erfassen, die nicht in Standard-SOPs passen:

Empfohlene Vorgehensweisen
1. Wissensdatenbank-Tool: Nutzen Sie die Dokumentationsfunktion von NinjaOne, um interne Artikel in der Wissensdatenbank anzulegen. Damit können Sie:
, Workarounds in einem kontrollierten, gut zugänglichen Format dokumentieren
, Artikel mit bestimmten Berechtigungen erstellen
, Workarounds nach Produkt oder Funktionsbereich strukturieren

2. Richtlinien für interne Dokumentation zur Fehlerbehebung:
, Nehmen Sie einen deutlichen Hinweis auf, dass das Dokument nur für den internen Gebrauch bestimmt ist
, Gliedern Sie das Dokument wie folgt:
, Oberer Abschnitt: Hinweis und behandelte Themen
, Mittlerer Abschnitt: Ausführliche Erläuterung des Workarounds
, Letzter Abschnitt: Möglicher Eskalationsprozess, sofern zutreffend

Wichtige Aspekte
, Kennzeichnen Sie Dokumente als „Intern“, damit sie nicht an Kund:innen weitergegeben werden
, Verlinken Sie nach Möglichkeit auf die zugehörige Kundendokumentation
, Lassen Sie Workarounds von der Leitung prüfen und freigeben
, Aktualisieren Sie die Dokumentation regelmäßig, wenn sich Produktfunktionen ändern

Best Practices
, Verwenden Sie eine klare, präzise Sprache
, Erklären Sie den Kontext, warum es den Workaround gibt
, Benennen Sie Einschränkungen und mögliche Risiken
, Erwägen Sie einen eigenen Abschnitt für bekannte Workarounds in Ihrer internen Dokumentation

FAQs

Ein Workaround kommt als dauerhafte Lösung infrage, wenn er wiederholt bei mehreren Kund:innen oder in mehreren Szenarien zum Einsatz kommt. Zeigen Tests, dass er den Best Practices entspricht und kein Risiko mit sich bringt, lässt er sich als Standard in Ihre SOPs übernehmen.

Klare Eskalationsregeln und Schulungen sorgen dafür, dass Workarounds vorübergehend bleiben. Wer SOPs konsequent als einheitliche Datenquelle etabliert und Workarounds regelmäßig überprüft, verhindert, dass Ad-hoc-Fixes zur Dauerlösung werden.

Legen Sie einen Prüfplan fest und bestimmen Sie Verantwortliche für das Aktualisieren oder Außerkraftsetzen von Einträgen. Automatisierung, etwa Erinnerungen oder Governance-Tickets, hilft dabei, dass das Verzeichnis nicht veraltet.

Veraltete Workarounds können Sicherheitslücken, Performance-Probleme und Inkonsistenzen in verwalteten Umgebungen verursachen. Außerdem verdecken sie womöglich zugrunde liegende Probleme, die dauerhaft behoben werden sollten.

Machen Sie die Dokumentation zum festen Bestandteil des Fehlerbehebungs-Workflows und stellen Sie ein einfaches, einheitliches Template bereit. Verankern Sie die Erwartungen in der Einarbeitung und überprüfen Sie sie regelmäßig durch Audits oder Stichproben.

Kund:innen sollten informiert werden, wenn ein Workaround ein Risiko birgt, die Performance beeinträchtigt oder später nachgebessert werden muss. Transparente Kommunikation schafft Vertrauen und macht deutlich, dass der Fix nur vorübergehend ist.

Das könnte Sie auch interessieren

Sind Sie bereit, die schwierigsten Aufgaben der IT zu vereinfachen?