Prevención de limitación (throttling)

Prevención de limitación (throttling) de KONNEKT incluye dos políticas una "control de frecuencia de actualización" política y una "limitación de la tasa de solicitudes" política diseñada para gestionar y controlar la velocidad a la que se realizan solicitudes al GraphAPI de Microsoft, asegurando que las conexiones a SharePoint Online (SPO) permanezcan estables y funcionen de manera óptima. Estas políticas son especialmente útiles para evitar un uso excesivo de recursos y mantener una experiencia de usuario fluida.

El uso de las API de Microsoft 365 está sujeto a limitaciones en cuanto a la cantidad de solicitudes por tiempo que una aplicación puede enviar. Si una aplicación utiliza más recursos, será limitada (throttled). Puede encontrar más información sobre esto en el documentación de Microsoft.

Dado que KONNEKT utiliza la API REST de Microsoft SharePoint Online y la Microsoft Graph API, puede ocurrir que las APIs de Microsoft limiten (throttle) el uso de KONNEKT. Si una aplicación es limitada, la API correspondiente (por ejemplo, la API REST de SPO) le indica a KONNEKT que debe esperar una cantidad de tiempo definida. Esto comienza en algunos segundos y puede llegar a minutos, dependiendo del uso. Los efectos para KONNEKT pueden ser navegación lenta o carga/escritura de archivos lenta. Si la limitación llega a minutos, resultará en mensajes de error indicando que la unidad no está disponible actualmente.

KONNEKT tiene varios mecanismos para reducir la ocurrencia de limitaciones, los cuales se aplican automáticamente.

Escenarios comunes para la prevención de limitación

Escenario 1: Cargas de datos de alto volumen o migración de datos

Cuando un usuario intenta subir una gran cantidad de archivos a / o realiza una migración de datos dentro de SPO en un período corto, el dispositivo puede alcanzar el límite especificado.

Escenario 2: Operaciones intensivas de lectura

Si un usuario realiza operaciones intensivas de lectura, como consultar o buscar en un directorio grande (> 1000 elementos), el dispositivo puede alcanzar el límite especificado.

Ejemplos:

• Usar la búsqueda del Explorador de archivos en carpetas grandes

• Desplazarse por carpetas con numerosos archivos gráficos o PDF

Escenario 3: Consultas de permisos

Desde la versión 2.10, KONNEKT además comprueba permisos por carpeta y archivo ya que estas consultas consumen una mayor cantidad de unidades de recurso en comparación con otras operaciones. El sistema puede alcanzar el límite especificado mucho más rápido, lo que puede activar la prevención de limitación. Las consultas de permisos no se activarán si "Prevención de limitación de SharePoint" está configurado en 'Alto'.

En entornos de alta carga, todas las medidas pueden no ser suficientes para evitar la limitación.

KONNEKT fue creado para el trabajo de oficina habitual. Si usa archivos de alto volumen (p. ej., edición de video, diseño gráfico, CAD) o lee/escribe gigabytes de datos, KONNEKT (& SPO) puede no ser la herramienta adecuada.

Por favor también revise nuestro casos de uso.

Unidades de recurso

Cada tipo de solicitud de GraphAPI consume diferentes cantidades de unidades de recurso:

• Lecturas de un solo elemento: 1 unidad de recurso cada una

• Operaciones de escritura y consultas de directorio: 2 unidades de recurso cada una

• Consultas de permisos: 5

Para detalles vea: https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online

¿Cómo puedo prevenir la limitación?

Las siguientes circunstancias fomentan la limitación:

• Uso de herramientas de terceros para respaldo de SPO - especialmente durante el horario laboral

• Uso de herramientas que rastrean todo su sistema de archivos (como renderizadores de vista previa, etc.)

• Uso de carpetas muy grandes con >1000 archivos en el primer nivel de la carpeta

• Uso excesivo de la búsqueda del Explorador de archivos en grandes Colecciones de Sitios o Bibliotecas de Documentos

Considere los siguientes ajustes y acciones para todos los usuarios de un tenant M365 sin excepciones.

Para evitar la limitación:

• No realice respaldos de SPO durante el horario laboral.

• Si la búsqueda del Explorador de archivos es inevitable: optimice las búsquedas del Explorador de archivos, concéntrese en carpetas específicas o subcarpetas para limitar las solicitudes a GraphAPI

• Mantenimiento regular: archive o elimine archivos, carpetas, Bibliotecas de Documentos y Colecciones de Sitios desactualizados.

• Evite el uso excesivo de la búsqueda del Explorador de archivos en grandes Colecciones de Sitios o Bibliotecas de Documentos

• No use ningún renderizador de vista previa para los recursos de KONNEKT. Vea también aquí. Puede además configurar el Filtro sin conexión a la extensión de archivo "YYY" (que no existe), para evitar que el Explorador de archivos de Windows renderice vistas previas para archivos PDF.

• Segmente sus datos (no demasiados archivos en el primer nivel de una carpeta).

• Configure "Prevención de limitación de SharePoint" Política a "Alto" - solo recomendado hasta la versión de KONNEKT 2.10.2

• A partir de la versión 2.11.0, recomendamos habilitar "Limitación del lado del cliente" y configurar la política "Prevención de limitación de SharePoint" a "Auto".

Cuando active el registro de KONNEKT a "debug", verá entradas de registro con "ThrottlingHook: Need to wait Xs before start" (donde X representa la cantidad de segundos que SPO quiere que esperemos).

Las entradas de registro que contienen "[Sharepoint] UpdateDrives: Skipping volume due to throttling prevention." NO son causadas por la limitación de SharePoint. Estas indican operaciones habituales para prevenir la limitación - nada de qué preocuparse. ;-)

Cómo funciona

La "control de frecuencia de actualización" política limita las solicitudes mediante ciclos de actualización mejorados p. ej. actualizando las Colecciones de Sitios de los usuarios.

La "limitación de la tasa de solicitudesLa "Limitación del lado del cliente", incluye límites y duros y suaves:

• Límite suave: Cuando se alcanza el límite suave, el sistema comenzará a limitar las solicitudes. Esto significa que la mayoría de las operaciones se retrasarán por un corto período (p. ej., 2 segundos), y el nivel de prevención de limitación cambiará a ALTO. Algunas operaciones, como trabajos de carga oportunista y operaciones de lectura anticipada, se pospondrán hasta que la cantidad de solicitudes caiga por debajo del límite suave.

• Límite estricto: Cuando se alcanza el límite duro, el sistema dejará de enviar cualquier solicitud. La aplicación mostrará un mensaje de error hasta que finalice la ventana de tiempo.

Use "Límite duro" solo cuando sea necesario, ya que impide que KONNEKT se comunique con los endpoints de Microsoft.