Opciones de configuración de ejecución para subprocesos

En este artículo se detallan los valores que puede usar para configurar el subproceso en .NET.

Uso de todos los grupos de CPU en Windows

• En las máquinas que tienen varios grupos de CPU, esta opción configura si los componentes, como el grupo de subprocesos, usan todos los grupos de CPU o solo el grupo de CPU principal del proceso. Esta opción también afecta a lo que Environment.ProcessorCount devuelve.
• Cuando esta opción está habilitada, todos los grupos de CPU se usan y los subprocesos también se distribuyen automáticamente entre los grupos de CPU de forma predeterminada.
• Esta opción está habilitada de forma predeterminada en Windows 11 y versiones posteriores, y deshabilitada de forma predeterminada en Windows 10 y versiones anteriores. Para que esta opción surta efecto cuando está habilitada, el GC también debe configurarse para usar todos los grupos de CPU; para más información, consulte Grupos de CPU del GC.

Asignación de subprocesos a grupos de CPU en Windows

• En las máquinas que tienen varios grupos de CPU y en las que todos ellos están en uso, esta opción configura si los subprocesos se distribuyen automáticamente entre los grupos de CPU.
• Cuando esta opción está habilitada, los nuevos subprocesos se asignan a un grupo de CPU de forma que intenta rellenar completamente un grupo de CPU que ya está en uso antes de usar un nuevo grupo de CPU.
• Esta opción está habilitada de forma predeterminada.

Mínimo de subprocesos

• Especifica el número mínimo de subprocesos para el grupo de subprocesos de trabajo.
• Corresponde al método ThreadPool.SetMinThreads.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

Archivo del proyecto:

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

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

</Project>

Máximo de subprocesos

• Especifica el número máximo de subprocesos para el grupo de subprocesos de trabajo.
• Corresponde al método ThreadPool.SetMaxThreads.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

Archivo del proyecto:

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

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

</Project>

Grupo de subprocesos de Windows

• Para proyectos en Windows, configura si la administración de subprocesos del grupo de subprocesos se delega al grupo de subprocesos de Windows.
• Si omite esta configuración o la plataforma no es Windows, se usa en su lugar el grupo de subprocesos de .NET.
• Solo las aplicaciones publicadas con AOT nativo en Windows usan el grupo de subprocesos de Windows de forma predeterminada, para lo cual puede optar por usar el grupo de subprocesos de .NET en su lugar deshabilitando la configuración.
• El grupo de subprocesos de Windows puede funcionar mejor en algunos casos, como en los casos en los que el número mínimo de subprocesos está configurado en un valor alto o cuando la aplicación ya usa mucho el grupo de subprocesos de Windows. También puede haber casos en los que el grupo de subprocesos de .NET funcione mejor, como en el control de E/S pesado en máquinas más grandes. Es aconsejable comprobar las métricas de rendimiento al cambiar esta configuración.
• Algunas API no se admiten al usar el grupo de subprocesos de Windows, como ThreadPool.SetMinThreads, ThreadPool.SetMaxThreads y ThreadPool.BindHandle(SafeHandle). Los valores de configuración del grupo de subprocesos para subprocesos mínimos y máximos tampoco son efectivos. Una alternativa a ThreadPool.BindHandle(SafeHandle) es la clase ThreadPoolBoundHandle.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

Archivo del proyecto:

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

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

</Project>

Inserción de subprocesos en respuesta al bloqueo de elementos de trabajo

En algunos casos, el grupo de subprocesos detecta elementos de trabajo que bloquean sus subprocesos. Para compensarlo, inserta más subprocesos. En .NET 6 y versiones posteriores, puede usar las opciones siguientes de configuración del entorno de ejecución para configurar la inserción de subprocesos en respuesta al bloqueo de elementos de trabajo. Actualmente, esta configuración solo surte efecto para los elementos de trabajo que esperan a que se complete otra tarea, como en los casos típicos de sincrónico sobre asincrónico.

Cómo surten efecto las opciones de configuración

• Una vez alcanzado el número de subprocesos basado en MinThreads, se pueden crear hasta ThreadsToAddWithoutDelay subprocesos adicionales sin retraso.
• Después, antes de que se cree cada subproceso adicional, se induce un retraso, empezando por DelayStepMs.
• Por cada ThreadsPerDelayStep subprocesos que se agregan con un retraso, se agrega un DelayStepMs adicional al retraso.
• El retraso no puede superar MaxDelayMs.
• Los retrasos solo se inducen antes de crear subprocesos. Si los subprocesos ya están disponibles, se liberarían sin retraso para compensar el bloqueo de elementos de trabajo.
• También se utiliza el uso y los límites de la memoria física y, más allá de un umbral, el sistema cambia a una inserción de subprocesos más lenta.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

AutoreleasePool para subprocesos administrados

Esta opción configura si cada subproceso administrado recibe un elemento NSAutoreleasePool implícito cuando se ejecuta en una plataforma macOS compatible.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

Archivo del proyecto:

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

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

</Project>