Search…
SharePoint Throttling Prevention
This feature is available in KONNEKT 2.2 or newer
The usage of SharePoint Online API is subject to limitations in terms of the amount of requests per time, that an application may use. If an application uses more resources, it will be throttled by SharePoint Online. You can find more on this in the Microsoft docs.
Since KONNEKT is using Microsoft SharePoint Online and Microsoft Graph APIs, it may happen, that SharePoint Online will throttle your KONNEKT usage. If an application is throttled, SharePoint Online will not respond for a defined amount of time. This starts from some seconds and can grow up to minutes, depending on the usage. Impacts for KONNEKT may be slow browsing through or loading/writing of files. If the throttling grows up to minutes, it will result in error messages that the drive is currently not available.
KONNEKT has several mechanisms to reduce the occurrence of throttling, which are applied automatically. There are other settings, that you can decide on, since this will affect the timeliness e.g. of new libraries or files being available in KONNEKT. Please take a look at the following policy to learn about the available options.
In heavy load environments, all measures may not be enough to prevent throttling.
KONNEKT was made for regular office work. If you use high volume files (e.g. video editing, graphics design, CAD) or read/write gigabytes of data, KONNEKT (& SharePoint Online) may not be the proper tool of choice.

How can I prevent throttling?

The following circumstances promote throttling:
  • Use of very big libraries with hundred-thousands of files in total
  • Use of very big folders with >1000 files on the first level of the folder
  • Use of tools that crawl your whole filesystem (like preview renderer etc.)
To avoid this, please
  • Do not use any preview renderer for KONNEKT resources. See also here. You can additionally set the Offline Filter to the file extension "YYY" (which does not exist), to prevent Windows File Explorer from rendering previews for PDF files.
  • Segment your data (no very big libraries, not too many files in the first level of a folder).

How can I detect throttling?

When you turn the KONNEKT logging to "debug", you will see log entries with "Throttling detected: 429 Retry-After X" (where X stands for the amount of seconds SharePoint Online wants us to wait).
Log entries that contain "ThrottledRequest:" are NOT caused by SharePoint throttling. Those indicate regular operations - nothing to worry about. ;-)

Policy

You can load this policy in Policy Editor or Intune with our ADMX.
Policy Name (GPO & Intune): Sharepoint Throttling Prevention
Available settings:
  • Enabled
    • Autodetect (default) KONNEKT will decide on active measures.
    • Low Throttling prevention takes place in case of throttling events, only.
    • Medium More data is cached than in Low to prevent unnecessary requests to SharePoint Online.
    • High Throttling prevention has the highest priority. Some changes from other clients (e.g. new libraries or new files/folders) may be updated late (up to 24 hours).
  • Disabled Default Throttling Prevention takes place
SharePoint Online monitors throttling on several levels. From our experience the tenant level is the most important one for KONNEKT.
Because of that, throttling prevention becomes effective, if ALL KONNEKT clients in your tenant use the same prevention level. For example: Just setting this policy to "high" on some clients may have no effect at all. Please set all to "high", if you experience throttling while using KONNEKT.

Manual setting in the registry

You do not need this, if you use GPO or Intune management.
  • Value name: SharepointThrottling
  • Value type: REG_DWORD
  • Value data
    • 0 => Autodetect (default)
    • 1 => Low
    • 2 => Medium
    • 3 => High
  • Value stored in:
    • HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt or
    • HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt
Copy link
Edit on GitHub
On this page
How can I prevent throttling?
How can I detect throttling?
Policy
Manual setting in the registry