Prevenção de limitação de débito

Prevenção de limitação de taxa da KONNEKT inclui duas políticas, uma política "controlo da frequência de atualização" e uma política de "limitação da taxa de pedidos" concebida para gerir e controlar a taxa a que os pedidos são feitos à GraphAPI da Microsoft, garantindo que as ligações ao SharePoint Online (SPO) permanecem estáveis e com desempenho ideal. Estas políticas são particularmente úteis para prevenir o uso excessivo de recursos e manter uma experiência de utilizador fluida.

A utilização das APIs do Microsoft 365 está sujeita a limitações em termos do número de pedidos por período de tempo que uma aplicação pode enviar. Se uma aplicação utilizar mais recursos, será sujeita a throttling. Pode saber mais sobre isto na os documentos da Microsoft.

Como a KONNEKT utiliza a Microsoft SharePoint Online REST API e a Microsoft Graph API, pode acontecer que as APIs da Microsoft limitem a utilização da KONNEKT. Se uma aplicação for sujeita a throttling, a API correspondente (por exemplo, a SPO REST API) indica à KONNEKT que tem de aguardar durante um período de tempo definido. Isto começa com alguns segundos e pode aumentar até minutos, dependendo da utilização. Os impactos para a KONNEKT podem ser navegação lenta ou carregamento/gravação de ficheiros. Se o throttling se prolongar por minutos, resultará em mensagens de erro de que a unidade não está atualmente disponível.

A KONNEKT tem vários mecanismos para reduzir a ocorrência de throttling, que são aplicados automaticamente.

Cenários Comuns para a Prevenção de Throttling

Cenário 1: Uploads de Dados de Grande Volume ou Migração de Dados

Quando um utilizador tenta carregar um grande número de ficheiros para / ou realiza uma migração de dados dentro do SPO num curto período, o dispositivo pode atingir o limite especificado.

Cenário 2: Operações de Leitura Intensivas

Se um utilizador realizar operações de leitura intensivas, como consultar ou pesquisar um diretório grande (> 1000 itens), o dispositivo pode atingir o limite especificado.

Exemplos:

• Utilizar a Pesquisa do Explorador de Ficheiros em pastas grandes

• Navegar por pastas com numerosos ficheiros gráficos ou PDF

Cenário 3: Consultas de Permissões

Desde a versão 2.10, a KONNEKT também verifica permissões por pasta e ficheiro, uma vez que estas consultas consomem um número mais elevado de unidades de recursos em comparação com as outras operações. O sistema pode atingir o limite especificado muito mais rapidamente, o que pode desencadear a prevenção de throttling. As consultas de permissões não serão acionadas se "Prevenção de Throttling do SharePoint" estiver definido como 'High'.

Em ambientes com carga elevada, todas as medidas podem não ser suficientes para evitar throttling.

A KONNEKT foi criada para trabalho de escritório regular. Se utilizar ficheiros de grande volume (por exemplo, edição de vídeo, design gráfico, CAD) ou ler/escrever gigabytes de dados, a KONNEKT (& SPO) pode não ser a ferramenta mais adequada.

Consulte também os nossos casos de utilização.

Unidades de Recursos

Cada tipo de pedido GraphAPI consome diferentes quantidades de unidades de recursos:

• Leituras de item único: 1 unidade de recurso cada

• Operações de escrita e consultas de diretório: 2 unidades de recurso cada

• Consultas de permissões: 5

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

Como posso evitar o throttling?

As seguintes circunstâncias promovem o throttling:

• Utilização de ferramentas de terceiros para backup do SPO - especialmente durante o horário de trabalho

• Utilização de ferramentas que percorrem todo o seu sistema de ficheiros (como renderizador de pré-visualização, etc.)

• Utilização de pastas muito grandes com >1000 ficheiros no primeiro nível da pasta

• Utilização excessiva da Pesquisa do Explorador de Ficheiros em grandes coleções de sites ou bibliotecas de documentos

Considere as seguintes definições e ações para todos os utilizadores de um tenant M365, sem exceções.

Para evitar throttling:

• Não execute backups do SPO durante o horário de expediente.

• Se a Pesquisa do Explorador de Ficheiros for inevitável: otimize as pesquisas do Explorador de Ficheiros, concentre-se em pastas ou subpastas específicas para limitar os pedidos GraphAPI

• Manutenção regular: arquivar ou remover ficheiros, pastas, bibliotecas de documentos e coleções de sites desatualizados.

• Evite a utilização excessiva da Pesquisa do Explorador de Ficheiros em grandes coleções de sites ou bibliotecas de documentos

• Não utilize qualquer renderizador de pré-visualização para recursos da KONNEKT. Veja também aqui. Também pode definir o Filtro Offline para a extensão de ficheiro "YYY" (que não existe), para impedir que o Explorador de Ficheiros do Windows apresente pré-visualizações de ficheiros PDF.

• Segmente os seus dados (não demasiados ficheiros no primeiro nível de uma pasta).

• Defina a política "Prevenção de Throttling do SharePoint" para "High" - apenas recomendado até à versão 2.10.2 da KONNEKT

• A partir da versão 2.11.0, recomendamos ativar "limitação de taxa do lado do cliente" e definir a política "Prevenção de Throttling do SharePoint" para "Auto".

Quando ativa o registo da KONNEKT para "debug", verá entradas de registo com "ThrottlingHook: Need to wait Xs before start" (onde X representa a quantidade de segundos que o SPO nos pede para esperar).

As entradas de registo que contêm "[Sharepoint] UpdateDrives: Skipping volume due to throttling prevention." NÃO são causadas por throttling do SharePoint. Essas indicam operações normais para prevenir throttling - nada com que se preocupar. ;-)","t63":"Como Funciona","t64":"A política \"","t65":"\" limita os pedidos por ciclos de atualização melhorados, por exemplo, atualizando as Coleções de Sites dos utilizadores.","t66":"\" policy operates by monitoring the number of requests and there corresponding resource units made within a specified time window and applying limits to these requests. This policy, “","t67":"”, includes","t68":"soft","t69":"hard","t70":"limits:","t71":":\nQuando o limite suave é atingido, o sistema começará a limitar os pedidos. Isto significa que a maioria das operações será atrasada por um curto período (por exemplo, 2 segundos), e o nível de prevenção de throttling passará para HIGH. Algumas operações, como trabalhos de upload oportunista e operações de leitura antecipada, serão adiadas até que a quantidade de pedidos fique abaixo do limite suave.","t72":":\nQuando o limite rígido é atingido, o sistema deixará de enviar quaisquer pedidos. A aplicação apresentará uma mensagem de erro até ao final do período de tempo ser alcançado.","t73":"Use \"Hard Limit\" apenas quando necessário, pois impede a KONNEKT de aceder e comunicar com os endpoints da Microsoft."}】]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}

Como Funciona

A política "controlo da frequência de atualização" limita os pedidos por ciclos de atualização melhorados, por exemplo, atualizando as Coleções de Sites dos utilizadores.

A política "limitação da taxa de pedidos" funciona monitorizando o número de pedidos e as correspondentes unidades de recursos efetuadas dentro de uma janela de tempo especificada e aplicando limites a esses pedidos. Esta política, “limitação de taxa do lado do cliente”, inclui suaves e rígidos limites:

• Limite suave: Quando o limite suave é atingido, o sistema começará a limitar os pedidos. Isto significa que a maioria das operações será atrasada por um curto período (por exemplo, 2 segundos), e o nível de prevenção de throttling passará para HIGH. Algumas operações, como trabalhos de upload oportunista e operações de leitura antecipada, serão adiadas até que a quantidade de pedidos fique abaixo do limite suave.

• Limite rígido: Quando o limite rígido é atingido, o sistema deixará de enviar quaisquer pedidos. A aplicação apresentará uma mensagem de erro até ao final do período de tempo ser alcançado.

Use "Hard Limit" apenas quando necessário, pois impede a KONNEKT de aceder e comunicar com os endpoints da Microsoft.