Prévention de la limitation

La prévention de l’étranglement de KONNEKT comprend deux stratégies, une politique « commande de fréquence de mise à jour » et une politique « limitation du taux de requêtes » conçue pour gérer et contrôler la fréquence à laquelle les requêtes sont envoyées à l’API Graph de Microsoft, afin de garantir que les connexions à SharePoint Online (SPO) restent stables et fonctionnent de manière optimale. 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 consomme davantage de ressources, elle sera soumise à un étranglement. Vous trouverez plus d’informations à ce sujet dans le la documentation Microsoft.

Comme KONNEKT utilise l’API REST Microsoft SharePoint Online et l’API Microsoft Graph, il peut arriver que les API Microsoft limitent l’utilisation de KONNEKT. Si une application est soumise à une limitation, l’API correspondante (par ex. l’API REST SPO) indique à KONNEKT qu’il doit attendre pendant une durée définie. Cela peut aller de quelques secondes à plusieurs minutes, selon l’utilisation. Les impacts pour KONNEKT peuvent être une navigation lente ou un chargement/une écriture de fichiers lent. Si la limitation s’étend sur plusieurs minutes, cela entraînera des messages d’erreur indiquant que le lecteur n’est actuellement pas disponible.

KONNEKT dispose de plusieurs mécanismes pour réduire l’apparition de l’étranglement, qui sont appliqués automatiquement.

Scénarios courants de prévention de l’étranglement

Scénario 1 : Téléversements de données en grande quantité ou migration de données

Lorsqu’un utilisateur tente de téléverser un grand nombre de fichiers dans / ou d’effectuer une migration de données dans SPO sur 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, comme interroger ou rechercher un grand répertoire (> 1000 éléments), l’appareil peut atteindre la limite spécifiée.

Exemples :

• Utilisation de la recherche de l’Explorateur de fichiers dans de grands dossiers

• Défilement dans des dossiers contenant de nombreux fichiers graphiques ou PDF

Scénario 3 : Requêtes de permissions

Depuis la version 2.10, KONNEKT vérifie également les permissions par dossier et par fichier, car ces requêtes consomment un nombre plus élevé d’unités de ressources que les autres opérations. Le système peut atteindre la limite spécifiée beaucoup plus rapidement, ce qui peut déclencher la prévention de l’étranglement. Les requêtes de permissions ne seront pas déclenchées si « SharePoint Throttling Prevention » est défini sur « Élevé ».

Dans les environnements fortement chargés, toutes les mesures peuvent ne pas suffire pour éviter l’étranglement.

KONNEKT a été conçu pour le travail de bureau habituel. Si vous utilisez des fichiers de grande taille (par ex. montage vidéo, conception graphique, CAO) ou si vous lisez/écrivez des gigaoctets de données, KONNEKT (& SPO) n’est peut-être pas l’outil le plus approprié.

Veuillez également consulter nos cas d’utilisation.

Unités de ressources

Chaque type de requête GraphAPI consomme un nombre différent d’unités de ressources :

• Lectures d’un seul élément : 1 unité de ressource chacune

• Opérations d’écriture et requêtes de répertoire : 2 unités de ressource 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 l’étranglement ?

Les circonstances suivantes favorisent l’étranglement :

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

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

• Utilisation de très grands dossiers contenant >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

Prenez en compte les paramètres et actions suivants pour tous les utilisateurs d’un tenant M365, sans exception.

Pour éviter l’étranglement :

• N’effectuez pas de sauvegardes SPO pendant les heures ouvrables.

• Si l’utilisation de 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 également définir le Offline Filter sur l’extension de fichier « YYY » (qui n’existe pas), afin d’empêcher l’Explorateur de fichiers Windows d’afficher des aperçus pour les fichiers PDF.

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

• Définissez la politique « SharePoint Throttling Prevention » sur « Élevé » - recommandé uniquement jusqu’à la version 2.10.2 de KONNEKT

• À partir de la version 2.11.0, nous recommandons d’activer « Client side throttling » et de définir la politique « SharePoint Throttling Prevention » sur « Auto ».

Lorsque vous activez le journalisation KONNEKT en mode « debug », vous verrez des entrées de journal avec « ThrottlingHook: Need to wait Xs before start » (où X représente le nombre de secondes que SPO nous demande d’attendre).

Les entrées de journal contenant « [Sharepoint] UpdateDrives: Skipping volume due to throttling prevention. » ne sont PAS causées par une limitation SharePoint. Elles indiquent des opérations normales de prévention de l’étranglement - il n’y a pas lieu de s’inquiéter. ;-)

Comment cela fonctionne

La politique « commande de fréquence de mise à jour » limite les requêtes via des cycles d’actualisation améliorés, par exemple la mise à jour des collections de sites des utilisateurs.

La politique « limitation du taux de requêtesLa politique « » fonctionne en surveillant le nombre de requêtes et les unités de ressources correspondantes effectuées dans une fenêtre de temps spécifiée, puis en appliquant des limites à ces requêtes. Cette politique, « Client side throttling », inclut des limites et des limites souples et dures :

• Limite souple : Lorsque la limite souple 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 que le niveau de prévention de l’étranglement passera à ÉLEVÉ. Certaines opérations, comme 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 passe sous la limite souple.

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

N’utilisez « Limite dure » qu’en cas de nécessité, car cela empêche KONNEKT d’accéder aux points de terminaison de Microsoft.