> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/de/configuration/system-settings/throttling-prevention.md). # Vermeidung von Drosselung **KONNEKTs Drosselungsschutz** umfasst zwei Richtlinien, eine „[Aktualisierungshäufigkeitssteuerung](/de/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)“-Richtlinie und eine „[Anforderungsratenbegrenzung](/de/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)“-Richtlinie, die darauf ausgelegt ist, die Rate zu verwalten und zu steuern, mit der Anfragen an die Microsoft GraphAPI gestellt werden, damit die Verbindungen zu SharePoint Online (SPO) stabil bleiben und optimal funktionieren. Diese Richtlinien sind besonders nützlich, um einen übermäßigen Ressourcenverbrauch zu verhindern und eine reibungslose Benutzererfahrung aufrechtzuerhalten. Die Nutzung von Microsoft 365-APIs unterliegt Beschränkungen hinsichtlich der Anzahl von Anfragen pro Zeiteinheit, die eine Anwendung senden darf. Wenn eine Anwendung mehr Ressourcen verbraucht, wird sie gedrosselt. Mehr dazu finden Sie im [Microsoft-Dokumentation](https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online). Da KONNEKT die Microsoft SharePoint Online REST API und die Microsoft Graph API verwendet, kann es vorkommen, dass Microsoft-APIs Ihre KONNEKT-Nutzung drosseln. Wenn eine Anwendung gedrosselt wird, teilt die entsprechende API (z. B. die SPO REST API) KONNEKT mit, dass es eine definierte Zeit warten muss. Das beginnt bei einigen Sekunden und kann je nach Nutzung auf mehrere Minuten anwachsen. Auswirkungen für KONNEKT können langsames Durchsuchen oder Laden/Schreiben von Dateien sein. Wenn die Drosselung auf mehrere Minuten anwächst, führt das zu Fehlermeldungen, dass das Laufwerk derzeit nicht verfügbar ist. KONNEKT verfügt über mehrere Mechanismen zur Verringerung des Auftretens von Drosselung, die automatisch angewendet werden. ## Häufige Szenarien zur Vermeidung von Drosselung ### **Szenario 1: Daten-Uploads mit hohem Volumen oder Datenmigration** Wenn ein Benutzer versucht, innerhalb kurzer Zeit eine große Anzahl von Dateien hochzuladen oder eine Datenmigration innerhalb von SPO durchzuführen, kann das Gerät die angegebene Grenze erreichen. ### **Szenario 2: Intensive Lesevorgänge** Wenn ein Benutzer intensive Lesevorgänge durchführt, z. B. das Abfragen oder Durchsuchen eines großen Verzeichnisses (> 1000 Elemente), kann das Gerät die angegebene Grenze erreichen. Beispiele: * Verwendung der Suche im Datei-Explorer in großen Ordnern * Durchscrollen von Ordnern mit zahlreichen Grafik- oder PDF-Dateien ### **Szenario 3: Berechtigungsabfragen** Seit Version 2.10 prüft KONNEKT zusätzlich Berechtigungen pro Ordner und Datei, da diese Abfragen im Vergleich zu den anderen Vorgängen eine höhere Anzahl an Ressourceneinheiten verbrauchen. Das System kann die angegebene Grenze dadurch viel schneller erreichen, wodurch Drosselungsschutz ausgelöst werden kann. Berechtigungsabfragen werden nicht ausgelöst, wenn „[SharePoint-Drosselungsschutz](/de/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)“ auf 'High' gesetzt ist. {% hint style="warning" %} In Umgebungen mit hoher Last reichen möglicherweise nicht alle Maßnahmen aus, um Drosselung zu verhindern. KONNEKT ist für die reguläre Büroarbeit gemacht. Wenn Sie Dateien mit hohem Volumen verwenden (z. B. Videobearbeitung, Grafikdesign, CAD) oder Gigabytes an Daten lesen/schreiben, ist KONNEKT (& SPO) möglicherweise nicht das geeignete Werkzeug der Wahl. Bitte prüfen Sie auch unsere [Anwendungsfälle](/de/readme.md#use-cases). {% endhint %} ## **Ressourceneinheiten** Jede Art von GraphAPI-Anfrage verbraucht unterschiedliche Mengen an Ressourceneinheiten: * Lesezugriffe auf einzelne Elemente: jeweils 1 Ressourceneinheit * Schreibvorgänge und Verzeichnisabfragen: jeweils 2 Ressourceneinheiten * Berechtigungsabfragen: 5 Details siehe:\ ## Wie kann ich Drosselung verhindern? #### Folgende Umstände begünstigen Drosselung: * Verwendung von Drittanbieter-Tools für SPO-Backups - insbesondere während der Arbeitszeit * Verwendung von Tools, die Ihr gesamtes Dateisystem durchforsten (wie z. B. Vorschau-Renderer usw.) * Verwendung von sehr großen Ordnern mit >1000 Dateien auf der ersten Ordnerebene * Übermäßige Verwendung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken {% hint style="info" %} Berücksichtigen Sie die folgenden Einstellungen und Aktionen für alle Benutzer eines M365 Tenant ohne Ausnahmen. {% endhint %} #### Zur Vermeidung von Drosselung: * Führen Sie SPO-Backups nicht während der Geschäftszeiten aus. * Wenn die Datei-Explorer-Suche unvermeidbar ist: Optimieren Sie die Datei-Explorer-Suchen und konzentrieren Sie sich auf bestimmte Ordner oder Unterordner, um GraphAPI-Anfragen zu begrenzen * Regelmäßige Wartung: Archivieren oder entfernen Sie veraltete Dateien, Ordner, Dokumentbibliotheken und Site Collections. * Vermeiden Sie die übermäßige Verwendung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken * Verwenden Sie keinen Vorschau-Renderer für KONNEKT-Ressourcen. Siehe auch [hier](/de/configuration/system-settings/offline-attribute.md). Zusätzlich können Sie den [Offline-Filter](/de/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) auf die Dateiendung "YYY" (die nicht existiert) setzen, um zu verhindern, dass der Windows-Datei-Explorer Vorschauen für PDF-Dateien rendert. * Segmentieren Sie Ihre Daten (nicht zu viele Dateien auf der ersten Ebene eines Ordners). * Setzen Sie die „[SharePoint-Drosselungsschutz](/de/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)“-Richtlinie auf „High“ - nur empfohlen bis KONNEKT-Version 2.10.2 * Ab Version 2.11.0 empfehlen wir, „[clientseitige Drosselung](/de/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)“ zu aktivieren und die „[SharePoint-Drosselungsschutz](/de/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)“-Richtlinie auf „Auto“ zu setzen. Wenn Sie das [KONNEKT-Logging auf „debug“](/de/configuration/system-settings/logging.md#log-level), sehen Sie Logeinträge mit „`ThrottlingHook: Es muss Xs gewartet werden, bevor gestartet wird`“ (wobei X für die Anzahl der Sekunden steht, die SPO uns warten lassen möchte). Logeinträge, die „`[Sharepoint] UpdateDrives: Volume wird aufgrund von Drosselungsschutz übersprungen.`“ enthalten, werden NICHT durch SharePoint-Drosselung verursacht. Diese weisen auf normale Vorgänge zur Vermeidung von Drosselung hin - kein Grund zur Sorge. ;-) ## **Wie es funktioniert** Die „[Aktualisierungshäufigkeitssteuerung](/de/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)“-Richtlinie begrenzt Anfragen durch erweiterte Aktualisierungszyklen, z. B. beim Aktualisieren der Site Collections der Benutzer. Die „[Anforderungsratenbegrenzung](/de/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)“-Richtlinie funktioniert, indem die Anzahl der Anfragen und der entsprechenden Ressourceneinheiten, die innerhalb eines festgelegten Zeitfensters erfolgen, überwacht und Beschränkungen auf diese Anfragen angewendet werden. Diese Richtlinie, „[clientseitige Drosselung](/de/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)“, umfasst **weiche** und **harte** Grenzwerte: * **Soft-Limit**:\ Wenn der weiche Grenzwert erreicht wird, beginnt das System, Anfragen zu drosseln. Das bedeutet, dass die meisten Vorgänge für kurze Zeit verzögert werden (z. B. 2 Sekunden), und die Stufe des Drosselungsschutzes wechselt auf HOCH. Einige Vorgänge, wie opportunistische Upload-Jobs und Vorab-Lesevorgänge, werden aufgeschoben, bis die Anzahl der Anfragen wieder unter den weichen Grenzwert fällt. * **Hard-Limit**:\ Wenn der harte Grenzwert erreicht wird, sendet das System keine Anfragen mehr. Die Anwendung zeigt eine Fehlermeldung an, bis das Ende des Zeitfensters erreicht ist. {% hint style="warning" %} Verwenden Sie „Hard Limit“ nur, wenn nötig, da es KONNEKT daran hindert, mit den Endpunkten von Microsoft zu kommunizieren. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.konnekt.io/de/configuration/system-settings/throttling-prevention.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.