스레딩을 위한 런타임 구성 옵션

이 문서에서는 .NET에서 스레딩을 구성하는 데 사용할 수 있는 설정을 자세히 설명합니다.

Windows에서 모든 CPU 그룹 사용

• CPU 그룹이 여러 개 있는 컴퓨터에서 이 설정은 스레드 풀과 같은 구성 요소가 모든 CPU 그룹을 사용하는지 아니면 프로세스의 기본 CPU 그룹만 사용하는지 여부를 구성합니다. 이 설정은 Environment.ProcessorCount에서 반환하는 항목에도 영향을 줍니다.
• 이 설정을 사용하도록 설정하면 모든 CPU 그룹이 사용되고 스레드도 기본적으로 CPU 그룹에 자동으로 배포됩니다.
• 이 설정은 기본적으로 Windows 11 이상 버전에서 사용하도록 설정되며 Windows 10 및 이전 버전에서는 기본적으로 사용하지 않도록 설정됩니다. 사용하도록 설정된 경우 이 설정을 적용하려면 GC도 모든 CPU 그룹을 사용하도록 구성해야 합니다. 자세한 내용은 GC CPU 그룹을 참조하세요.

Windows의 CPU 그룹에 스레드 할당

• 여러 CPU 그룹이 있고 모든 CPU 그룹이 사용되는 컴퓨터에서 이 설정은 스레드가 CPU 그룹에 자동으로 배포되는지 여부를 구성합니다.
• 이 설정을 사용하도록 설정하면 새 CPU 그룹을 활용하기 전에 이미 사용 중인 CPU 그룹을 완전히 채우는 방식으로 새 스레드가 CPU 그룹에 할당됩니다.
• 이 설정은 기본적으로 사용하도록 설정되어 있습니다.

최소 스레드

• 작업자 스레드 풀의 최소 스레드 개수를 지정합니다.
• ThreadPool.SetMinThreads 메서드에 대응됩니다.

예제

runtimeconfig.json 파일:

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

runtimeconfig.template.json 파일:

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

프로젝트 파일:

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

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

</Project>

최대 스레드

• 작업자 스레드 풀의 최대 스레드 개수를 지정합니다.
• ThreadPool.SetMaxThreads 메서드에 대응됩니다.

예제

runtimeconfig.json 파일:

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

runtimeconfig.template.json 파일:

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

프로젝트 파일:

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

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

</Project>

Windows 스레드 풀

• Windows 프로젝트의 경우 스레드 풀 스레드 관리가 Windows 스레드 풀에 위임되는지 여부를 구성합니다.
• 이 설정을 생략하거나 플랫폼이 Windows가 아닌 경우 .NET 스레드 풀이 대신 사용됩니다.
• Windows에서 Native AOT를 사용하여 게시된 애플리케이션만 기본적으로 Windows 스레드 풀을 사용하며, 이 경우 구성 설정을 사용하지 않도록 설정하여 대신 .NET 스레드 풀을 사용하도록 선택할 수 있습니다.
• Windows 스레드 풀은 최소 스레드 수가 높은 값으로 구성된 경우 또는 Windows 스레드 풀이 이미 앱에서 과도하게 사용되고 있는 경우와 같은 경우에 더 나은 성능을 발휘할 수 있습니다. 더 큰 컴퓨터에서 I/O 처리가 많은 경우와 같이 .NET 스레드 풀이 더 잘 수행되는 경우도 있을 수 있습니다. 이 구성 설정을 변경할 때 성능 메트릭을 검사 것이 좋습니다.
• 일부 API는 Windows 스레드 풀(예: ThreadPool.SetMinThreads, ThreadPool.SetMaxThreads 및 ThreadPool.BindHandle(SafeHandle))을 사용할 때 지원되지 않습니다. 최소 및 최대 스레드에 대한 스레드 풀 구성 설정도 효과적이지 않습니다. ThreadPool.BindHandle(SafeHandle)에 대한 대안은 ThreadPoolBoundHandle 클래스입니다.

예제

runtimeconfig.json 파일:

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

runtimeconfig.template.json 파일:

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

프로젝트 파일:

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

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

</Project>

차단 작업 항목에 대한 응답으로 스레드 삽입

경우에 따라 스레드 풀은 스레드를 차단하는 작업 항목을 검색합니다. 보정하기 위해 더 많은 스레드가 삽입됩니다. .NET 6+에서 다음 런타임 구성 설정을 사용하여 블록 작업 항목에 대한 응답으로 스레드 삽입을 구성할 수 있습니다. 현재 이러한 설정은 일반적인 sync-over-async 사례와 같이 다른 작업이 완료되기를 기다리는 작업 항목에만 유효합니다.

구성 설정이 적용되는 방식

• MinThreads에 기반한 스레드 수에 도달한 후에는 ThreadsToAddWithoutDelay까지 지연 없이 최대 추가 스레드를 만들 수 있습니다.
• 그런 다음 각 추가 스레드를 만들기 전에 DelayStepMs부터 지연이 적용됩니다.
• 지연으로 추가되는 모든 ThreadsPerDelayStep 스레드에 대해 지연에 DelayStepMs가 더 추가됩니다.
• 지연은 MaxDelayMs를 초과할 수 없습니다.
• 지연은 스레드를 만들기 전에만 적용됩니다. 스레드를 이미 사용할 수 있는 경우 차단 작업 항목을 보정하기 위해 지연 없이 릴리스됩니다.
• 실제 메모리 사용량 및 제한도 사용되며, 임계값을 초과하면 시스템이 더 느린 스레드 주입으로 전환됩니다.

예제

runtimeconfig.json 파일:

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

runtimeconfig.template.json 파일:

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

관리형 스레드에 대한 AutoreleasePool

지원되는 macOS 플랫폼에서 실행할 때 각 관리형 스레드가 암시적 NSAutoreleasePool을 수신하는지 여부를 구성합니다.

예제

runtimeconfig.json 파일:

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

runtimeconfig.template.json 파일:

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

프로젝트 파일:

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

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

</Project>