For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prevención de limitación de velocidad

La prevención de limitación 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 tasa a la que se realizan solicitudes a la GraphAPI de Microsoft, garantizando que las conexiones a SharePoint Online (SPO) se mantengan estables y funcionen de forma óptima. Estas políticas son especialmente útiles para prevenir 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 unidad de tiempo que una aplicación puede enviar. Si una aplicación utiliza más recursos, se le aplicará limitación. Puede encontrar más información al respecto en el la documentación de Microsoft.

Dado que KONNEKT utiliza la API REST de Microsoft SharePoint Online y la API de Microsoft Graph, puede ocurrir que las API de Microsoft limiten el uso de KONNEKT. Si una aplicación se ve limitada, la API correspondiente (p. ej., la API REST de SPO) indica a KONNEKT que debe esperar un tiempo determinado. Esto puede ir desde unos segundos hasta minutos, según el uso. Para KONNEKT, los impactos pueden ser una navegación lenta o la carga/escritura de archivos. Si la limitación se prolonga hasta minutos, dará lugar a mensajes de error indicando que la unidad no está disponible actualmente.

KONNEKT tiene varios mecanismos para reducir la aparición de limitaciones, que se aplican automáticamente.

Escenarios comunes para la prevención de la limitación

Escenario 1: cargas de datos de gran volumen o migración de datos

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

Escenario 2: operaciones de lectura intensivas

Si un usuario realiza operaciones de lectura intensivas, 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 carpetas y archivos, ya que estas consultas consumen un mayor número de unidades de recursos en comparación con las 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 'High'.

Unidades de recursos

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

  • 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

¿Cómo puedo evitar la limitación?

Las siguientes circunstancias favorecen la limitación:

  • Uso de herramientas de terceros para copias de seguridad de SPO, especialmente durante el horario laboral

  • Uso de herramientas que rastrean todo su sistema de archivos (como el generador de vistas previas, 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 de M365 sin excepciones.

Para evitar la limitación:

  • No ejecute copias de seguridad de SPO durante el horario laboral.

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

  • Mantenimiento regular: archive o elimine archivos, carpetas, bibliotecas de documentos y colecciones de sitios obsoletos.

  • Evite el uso excesivo de la búsqueda del Explorador de archivos en grandes colecciones de sitios o bibliotecas de documentos

  • No utilice ningún generador de vistas previas para los recursos de KONNEKT. Véase también aquí. Además, puede establecer el Filtro sin conexión a la extensión de archivo "YYY" (que no existe), para evitar que el Explorador de archivos de Windows genere vistas previas de archivos PDF.

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

  • Establezca "Prevención de limitación de SharePoint" política en "High" - solo recomendado hasta la versión 2.10.2 de KONNEKT

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

Cuando active el registro de KONNEKT en "debug", verá entradas de registro con "ThrottlingHook: es necesario esperar X s antes de iniciar" (donde X representa la cantidad de segundos que SPO quiere que esperemos).

Las entradas de registro que contienen "[Sharepoint] UpdateDrives: omitiendo el volumen debido a la prevención de limitación." NO están causadas por la limitación de SharePoint. Estas indican operaciones normales para evitar la limitación: no hay de qué preocuparse. ;-)

Cómo funciona

La "control de frecuencia de actualización" política limita las solicitudes mediante ciclos de actualización mejorados, por ejemplo, al actualizar las colecciones de sitios de los usuarios.

La "limitación de la tasa de solicitudes" política funciona monitorizando el número de solicitudes y las unidades de recursos correspondientes realizadas dentro de una ventana de tiempo especificada y aplicando límites a estas solicitudes. Esta política, “limitación del lado del cliente”, incluye blandos y duros límites:

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

  • Límite duro: Cuando se alcance el límite duro, el sistema dejará de enviar solicitudes. La aplicación mostrará un mensaje de error hasta que se alcance el final de la ventana de tiempo.

Última actualización

¿Te fue útil?