Prévention du throttling

Prévention du throttling de KONNEKT comprend deux politiques une "contrôle de la fréquence des mises à jour" politique et une "limitation du taux de requêtes" politique conçue pour gérer et contrôler le rythme auquel les requêtes sont envoyées au GraphAPI de Microsoft, garantissant que les connexions à SharePoint Online (SPO) restent stables et offrent des performances optimales. Ces politiques sont particulièrement utiles pour éviter une utilisation excessive des ressources et maintenir une expérience utilisateur fluide.

L'utilisation des API Microsoft 365 est soumise à des limitations en termes de nombre de requêtes par unité de temps qu'une application peut envoyer. Si une application utilise plus de ressources, elle sera throttlée. Vous pouvez en savoir plus à ce sujet dans le la documentation Microsoft.

Étant donné que KONNEKT utilise l'API REST de Microsoft SharePoint Online et l'API Microsoft Graph, il peut arriver que les API Microsoft limitent (throttlent) votre utilisation de KONNEKT. Si une application est throttlée, l'API correspondante (par ex. l'API REST de SPO) indique à KONNEKT qu'il doit attendre pendant une durée définie. Cela commence à quelques secondes et peut aller jusqu'à plusieurs minutes, en fonction de l'utilisation. Les impacts pour KONNEKT peuvent être une navigation plus lente ou le chargement/l'enregistrement de fichiers ralenti. Si le throttling dure plusieurs minutes, cela se traduira par des messages d'erreur indiquant que le lecteur n'est actuellement pas disponible.

KONNEKT dispose de plusieurs mécanismes pour réduire la survenue du throttling, qui sont appliqués automatiquement.

Scénarios courants de prévention du throttling

Scénario 1 : Téléversements de données en grand volume ou migration de données

Lorsqu'un utilisateur tente de téléverser un grand nombre de fichiers vers / ou une migration de données au sein de SPO dans une courte période, l'appareil peut atteindre la limite spécifiée.

Scénario 2 : Opérations de lecture intensives

Si un utilisateur effectue des opérations de lecture intensives, telles que des requêtes ou des recherches dans un grand répertoire (> 1000 éléments), l'appareil peut atteindre la limite spécifiée.

Exemples :

• Utiliser la recherche de l'Explorateur de fichiers dans de grands dossiers

• Faire défiler des dossiers contenant de nombreux fichiers graphiques ou PDF

Scénario 3 : Requêtes de permissions

Depuis la version 2.10, KONNEKT vérifie en outre les permissions par dossier et fichier car ces requêtes consomment un nombre plus élevé d'unités de ressources par rapport aux autres opérations. Le système peut atteindre la limite spécifiée beaucoup plus rapidement, ce qui peut déclencher la prévention du throttling. Les requêtes de permissions ne seront pas déclenchées si "Prévention du throttling SharePoint" est réglé sur 'Élevé'.

Dans des environnements à forte charge, toutes les mesures peuvent ne pas suffire à prévenir le throttling.

KONNEKT a été conçu pour le travail de bureau régulier. Si vous utilisez des fichiers de très gros volume (par ex. montage vidéo, conception graphique, CAO) ou si vous lisez/écrivez des gigaoctets de données, KONNEKT (& SPO) peut ne pas être l'outil approprié.

Veuillez également consulter nos cas d'utilisation.

Unités de ressources

Chaque type de requête GraphAPI consomme des quantités différentes d'unités de ressources :

• Lectures d'éléments uniques : 1 unité de ressource chacune

• Opérations d'écriture et requêtes de répertoire : 2 unités de ressources chacune

• Requêtes de permissions : 5

Pour plus de détails, voir : https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online

Comment puis-je prévenir le throttling ?

Les circonstances suivantes favorisent le throttling :

• Utilisation d'outils tiers pour la sauvegarde de SPO - surtout pendant les heures de travail

• Utilisation d'outils qui parcourent l'ensemble de votre système de fichiers (comme un moteur de rendu d'aperçu, etc.)

• Utilisation de dossiers très volumineux avec >1000 fichiers au premier niveau du dossier

• Utilisation excessive de la recherche de l'Explorateur de fichiers dans de grandes Collections de sites ou bibliothèques de documents

Envisagez les paramètres et actions suivants pour tous les utilisateurs d'un locataire M365 sans exception.

Pour éviter le throttling :

• Ne lancez pas de sauvegardes SPO pendant les heures ouvrables.

• Si la recherche de l'Explorateur de fichiers est inévitable : optimisez les recherches de l'Explorateur de fichiers, concentrez-vous sur des dossiers ou sous-dossiers spécifiques pour limiter les requêtes GraphAPI

• Maintenance régulière : archivez ou supprimez les fichiers, dossiers, bibliothèques de documents et collections de sites obsolètes.

• Évitez l'utilisation excessive de la recherche de l'Explorateur de fichiers dans de grandes Collections de sites ou bibliothèques de documents

• N'utilisez aucun moteur de rendu d'aperçu pour les ressources KONNEKT. Voir aussi ici. Vous pouvez en outre définir le Filtre hors ligne sur l'extension de fichier "YYY" (qui n'existe pas), pour empêcher l'Explorateur Windows de rendre des aperçus pour les fichiers PDF.

• Segmentez vos données (pas trop de fichiers au premier niveau d'un dossier).

• Définissez "Prévention du throttling SharePoint" Politique sur "Élevé" - recommandé uniquement jusqu'à la version KONNEKT 2.10.2

• À partir de la version 2.11.0, nous recommandons d'activer "Limitation côté client" et de régler la politique "Prévention du throttling SharePoint" sur "Auto".

Lorsque vous activez le journalisation KONNEKT sur "debug", vous verrez des entrées de journal contenant "ThrottlingHook : Besoin d'attendre Xs avant de démarrer" (où X représente le nombre de secondes que SPO veut que nous attendions).

Les entrées de journal qui contiennent "[Sharepoint] UpdateDrives : Ignorer le volume en raison de la prévention du throttling." ne sont PAS causées par le throttling de SharePoint. Celles-ci indiquent des opérations régulières pour prévenir le throttling - rien d'inquiétant. ;-)

Comment ça marche

La politique "contrôle de la fréquence des mises à jour" limite les requêtes par des cycles de rafraîchissement améliorés, par ex. la mise à jour des collections de sites des utilisateurs.

La politique "limitation du taux de requêtesLa politique "Limitation côté client", inclut des et limites dures :

• Limite souple: Lorsque la limite douce est atteinte, le système commencera à limiter les requêtes. Cela signifie que la plupart des opérations seront retardées pendant une courte période (par ex., 2 secondes), et le niveau de prévention du throttling passera à ÉLEVÉ. Certaines opérations, telles que les travaux de téléversement opportunistes et les opérations de lecture anticipée, seront reportées jusqu'à ce que le nombre de requêtes redescende en dessous de la limite douce.

• Limite stricte: Lorsque la limite dure est atteinte, le système cessera d'envoyer des requêtes. L'application affichera un message d'erreur jusqu'à la fin de la fenêtre temporelle.

N'utilisez "Limite dure" que lorsque cela est nécessaire, car cela empêche KONNEKT d'accéder et de communiquer avec les points de terminaison de Microsoft.