Opções de configuração de runtime para threading

Este artigo detalha as configurações que você pode usar para configurar o threading no .NET.

Usar todos os grupos de CPU no Windows

• Em computadores que têm vários grupos de CPU, essa configuração configura se componentes como o pool de threads usam todos os grupos de CPU ou apenas o grupo de CPU primário do processo. A configuração também afeta o que Environment.ProcessorCount retorna.
• Quando essa configuração está habilitada, todos os grupos de CPU são usados e os threads também são distribuídos automaticamente entre grupos de CPU por padrão.
• Essa configuração é habilitada por padrão no Windows 11 e versões posteriores e desabilitada por padrão no Windows 10 e versões anteriores. Para que essa configuração entre em vigor quando habilitada, o GC também deve ser configurado para usar todos os grupos de CPU; para obter mais informações, consulte grupos de CPU do GC.

Atribuir threads a grupos de CPU no Windows

• Em computadores que têm vários grupos de CPU e todos os grupos de CPU estão sendo usados, essa configuração configura se os threads são distribuídos automaticamente entre grupos de CPU.
• Quando essa configuração está habilitada, novos threads são atribuídos a um grupo de CPU de uma maneira que tenta preencher totalmente um grupo de CPU que já está em uso antes de utilizar um novo grupo de CPU.
• Essa configuração é habilitada por padrão.

Threads mínimos

• Especifica o número mínimo de threads para o pool de threads de trabalho.
• Corresponde ao ThreadPool.SetMinThreads método.

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MinThreads": 4
      }
   }
}

Arquivo runtimeconfig.template.json:

{
   "configProperties": {
      "System.Threading.ThreadPool.MinThreads": 4
   }
}

Arquivo de projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <ThreadPoolMinThreads>4</ThreadPoolMinThreads>
  </PropertyGroup>

</Project>

Máximo de threads

• Especifica o número máximo de threads para o pool de threads de trabalho.
• Corresponde ao ThreadPool.SetMaxThreads método.

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MaxThreads": 20
      }
   }
}

Arquivo runtimeconfig.template.json:

{
   "configProperties": {
      "System.Threading.ThreadPool.MaxThreads": 20
   }
}

Arquivo de projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <ThreadPoolMaxThreads>20</ThreadPoolMaxThreads>
  </PropertyGroup>

</Project>

Pool de threads do Windows

• Para projetos no Windows, configura se o gerenciamento de threads do pool de threads é delegado ao pool de threads do Windows.
• Se você omitir essa configuração ou a plataforma não for Windows, o pool de threads do .NET será usado.
• Somente os aplicativos publicados com AOT Nativo no Windows usam o pool de threads do Windows por padrão, para o qual você pode optar por usar o pool de threads do .NET desabilitando a configuração de configuração.
• O pool de threads do Windows pode ter um desempenho melhor em alguns casos, como em casos em que o número mínimo de threads está configurado para um valor alto ou quando o pool de threads do Windows já está sendo fortemente usado pelo aplicativo. Também pode haver casos em que o pool de threads do .NET tem um desempenho melhor, como no tratamento de E/S pesado em computadores maiores. É aconselhável verificar as métricas de desempenho ao alterar essa configuração de configuração.
• Não há suporte para algumas APIs ao usar o pool de threads do Windows, como ThreadPool.SetMinThreads, ThreadPool.SetMaxThreadse ThreadPool.BindHandle(SafeHandle). As configurações de configuração do pool de threads para threads mínimos e máximos também não são eficazes. Uma alternativa é a ThreadPool.BindHandle(SafeHandle)ThreadPoolBoundHandle classe.

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.UseWindowsThreadPool": true
      }
   }
}

Arquivo runtimeconfig.template.json:

{
   "configProperties": {
      "System.Threading.ThreadPool.UseWindowsThreadPool": true
   }
}

Arquivo de projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <UseWindowsThreadPool>true</UseWindowsThreadPool>
  </PropertyGroup>

</Project>

Injeção de thread em resposta ao bloqueio de itens de trabalho

Em alguns casos, o pool de threads detecta itens de trabalho que bloqueiam seus threads. Para compensar, ele injeta mais threads. No .NET 6+, você pode usar as seguintes configurações de runtime para configurar a injeção de thread em resposta ao bloqueio de itens de trabalho. Atualmente, essas configurações têm efeito apenas para itens de trabalho que aguardam a conclusão de outra tarefa, como em casos típicos de sincronização sobre assíncrona .

Como as configurações entrarão em vigor

• Depois que a contagem de threads com base MinThreads for atingida, até ThreadsToAddWithoutDelay threads adicionais poderão ser criados sem atraso.
• Depois disso, antes de cada thread adicional ser criado, um atraso é induzido, começando com DelayStepMs.
• Para cada ThreadsPerDelayStep thread adicionado com um atraso, um adicional DelayStepMs é adicionado ao atraso.
• O atraso não pode exceder MaxDelayMs.
• Os atrasos só são induzidos antes de criar threads. Se os threads já estiverem disponíveis, eles serão liberados sem demora para compensar o bloqueio de itens de trabalho.
• O uso e os limites de memória física também são usados e, além de um limite, o sistema alterna para uma injeção de thread mais lenta.

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
      }
   }
}

Arquivo runtimeconfig.template.json:

{
   "configProperties": {
      "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
   }
}

AutoreleasePool para threads gerenciados

Essa opção configura se cada thread gerenciado recebe um NSAutoreleasePool implícito ao ser executado em uma plataforma macOS com suporte.

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.Thread.EnableAutoreleasePool": true
      }
   }
}

Arquivo runtimeconfig.template.json:

{
   "configProperties": {
      "System.Threading.Thread.EnableAutoreleasePool": true
   }
}

Arquivo de projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <AutoreleasePoolSupport>true</AutoreleasePoolSupport>
  </PropertyGroup>

</Project>