Batch 풀에서 컴퓨팅 노드 크기를 자동으로 조정하는 수식 만들기

아티클
04/15/2024

Azure Batch는 정의한 매개 변수에 따라 풀을 자동으로 크기 조정하여 시간과 비용을 절약해줍니다. 자동 크기 조정을 사용하면 Batch는 작업 요구가 증가함에 따라 동적으로 풀에 컴퓨팅 노드를 추가하고, 작업 요구가 감소하면 노드를 제거합니다.

컴퓨팅 노드 풀에서 자동 크기 조정을 사용하려면 풀을 사용자가 정의한 '자동 크기 조정 수식'에 연결합니다. Batch 서비스는 자동 크기 조정 수식을 사용하여 워크로드를 실행하는 데 필요한 노드의 수를 결정합니다. 이러한 노드는 전용 노드 또는 Azure 스폿 노드일 수 있습니다. Batch는 정기적으로 서비스 메트릭 데이터를 검토하고 사용하여 사용자가 정의한 수식 및 간격에 따라 풀의 노드 수를 조정합니다.

자동 크기 조정은 풀을 만들 때 사용하도록 설정하거나 기존 풀에 적용할 수 있습니다. Batch를 사용하면 풀에 할당하기 전에 수식을 평가하고 자동 크기 조정 실행 상태를 모니터링할 수 있습니다. 자동 크기 조정을 사용하도록 풀을 구성하면 나중에 수식을 변경할 수 있습니다.

Important

Batch 계정을 만들 때 풀 할당 모델을 지정할 수 있습니다. 이 모델은 풀을 Batch 서비스 구독(기본값)에 할당할지 사용자 구독에 할당할지 결정합니다. 기본 Batch 서비스 구성으로 Batch 계정을 만든 경우 계정이 처리에 사용할 수 있는 코어의 최대 개수가 제한됩니다. Batch 서비스는 컴퓨팅 노드를 해당 코어 제한까지만 확장합니다. 이러한 이유로 Batch 서비스는 자동 크기 조정 수식에 지정된 컴퓨팅 노드의 목표 수에 도달하지 못할 수 있습니다. 계정 할당량을 보고 늘리는 방법을 알아보려면 Azure Batch 서비스에 대한 할당량 및 제한을 참조하세요.

사용자 구독 모드로 계정을 만든 경우 계정은 구독의 코어 할당량을 공유합니다. 자세한 내용은 Azure 구독 및 서비스 제한, 할당량 및 제약 조건에서 Virtual Machines 제한을 참조하세요.

자동 크기 조정 수식

자동 크기 조정 수식은 사용자가 정의하는 하나 이상의 문을 포함하는 문자열 값입니다. 자동 크기 조정 수식은 풀의 autoScaleFormula 요소(Batch REST) 또는 CloudPool.AutoScaleFormula 속성(Batch .NET)에 할당됩니다. Batch 서비스는 처리할 다음 간격을 위해 풀의 대상 컴퓨팅 노드 수를 결정하는 수식을 사용합니다. 수식 문자열은 8KB를 초과할 수 없고, 세미콜론으로 구분된 문을 100개까지 포함할 수 있으며, 줄 바꿈과 주석을 포함할 수 있습니다.

자동 크기 조정 수식은 Batch 자동 크기 조정 "언어"로 고려할 수 있습니다. 수식 문은 Batch 서비스에서 정의한 서비스 정의 변수와 사용자 정의 변수를 모두 포함할 수 있는 자유 형식의 식입니다. 수식은 기본 제공 형식, 연산자 및 함수를 사용하여 이러한 값에 다양한 연산을 수행할 수 있습니다. 예를 들어 문은 다음과 같은 형태일 수 있습니다.

$myNewVariable = function($ServiceDefinedVariable, $myCustomVariable);

수식은 일반적으로 이전 문에서 가져온 값에 대한 작업을 수행하는 여러 문을 포함합니다. 예를 들어 먼저 variable1에 대한 값을 구한 다음, variable2를 채우는 함수로 전달합니다.

$variable1 = function1($ServiceDefinedVariable);
$variable2 = function2($OtherServiceDefinedVariable, $variable1);

자동 크기 조정 수식에 이러한 문을 포함하여 컴퓨팅 노드의 목표 수에 도달합니다. 전용 노드와 스폿 노드에는 각각 고유한 대상 설정이 있습니다. 자동 크기 조정 수식에는 전용 노드의 대상 값, 스폿 노드의 대상 값 또는 둘 다 포함될 수 있습니다.

노드의 대상 수는 풀에 있는 해당 노드 형식의 현재 수보다 높거나, 낮거나, 같을 수 있습니다. Batch는 풀의 자동 크기 조정 수식을 특정 자동 크기 조정 간격으로 평가합니다. Batch는 풀에 있는 각 노드 형식의 목표 수를 크기 조정 수식에서 평가할 때 지정하는 수로 조정합니다.

샘플 자동 크기 조정 수식

다음 예제에서는 대부분의 시나리오에 맞게 작동하도록 조정할 수 있는 두 가지 자동 크기 조정 수식을 보여 줍니다. 예제 수식에서 변수 startingNumberOfVMs 및 maxNumberofVMs는 필요에 따라 조정할 수 있습니다.

작업 보류 중

이 자동 크기 조정 수식을 사용하면 풀은 단일 VM으로 처음에 생성됩니다. $PendingTasks 메트릭은 실행 중이거나 큐에 대기 중인 작업의 수를 정의합니다. 수식은 지난 180초 동안 보류 중인 작업의 평균 수를 찾고 이에 따라 $TargetDedicatedNodes 변수를 설정합니다. 수식은 전용 노드의 목표 수가 25개 VM을 절대로 초과하지 않도록 합니다. 새 작업이 제출되면 풀은 자동으로 증가합니다. 작업이 완료되면 VM이 비워지고 자동 크기 조정 수식이 풀을 축소합니다.

이 수식은 전용 노드를 확장하지만 스폿 노드 확장에도 적용하도록 수정할 수 있습니다.

startingNumberOfVMs = 1;
maxNumberofVMs = 25;
pendingTaskSamplePercent = $PendingTasks.GetSamplePercent(180 * TimeInterval_Second);
pendingTaskSamples = pendingTaskSamplePercent < 70 ? startingNumberOfVMs : avg($PendingTasks.GetSample(180 * TimeInterval_Second));
$TargetDedicatedNodes=min(maxNumberofVMs, pendingTaskSamples);
$NodeDeallocationOption = taskcompletion;

Important

현재 Batch 서비스에는 보류 중인 작업을 해결하는 데 제한이 있습니다. 태스크가 작업에 추가되면 예약을 위해 Batch 서비스에서 사용하는 내부 큐에도 추가됩니다. 작업을 예약하기 전에 삭제하면 작업이 큐 내에 유지되어 $PendingTasks로 계산될 수 있습니다. 이 삭제된 작업은 Batch가 큐에서 태스크를 끌어와 Batch 풀의 유휴 노드로 예약할 기회를 얻게 되면 결국 큐에서 지워집니다.

선점된 노드

이 예에서는 25개의 스폿 노드로 시작하는 풀을 만듭니다. 스폿 노드가 선점될 때마다 전용 노드로 교체됩니다. 첫 번째 예제와 마찬가지로 maxNumberofVMs 변수는 풀이 25개의 VM을 초과하지 않도록 합니다. 이 예제는 스폿 VM을 활용하는 동시에 풀의 수명 동안 고정된 수의 선점만 발생하도록 하는 데 유용합니다.

maxNumberofVMs = 25;
$TargetDedicatedNodes = min(maxNumberofVMs, $PreemptedNodeCount.GetSample(180 * TimeInterval_Second));
$TargetLowPriorityNodes = min(maxNumberofVMs , maxNumberofVMs - $TargetDedicatedNodes);
$NodeDeallocationOption = taskcompletion;

자동 크기 조정 수식을 만드는 방법에 대해 자세히 알아보고 이 문서의 뒷부분에 나오는 추가 자동 크기 조정 수식 예제를 참조하세요.

variables

자동 크기 조정 수식에는 서비스 정의 및 사용자 정의 변수를 모두 사용할 수 있습니다.

서비스 정의 변수는 Batch 서비스에 기본 제공되어 있습니다. 서비스 정의 변수 일부는 읽기-쓰기이고, 일부는 읽기 전용입니다.

사용자 정의 변수는 사용자가 정의한 변수입니다. 이전 예제에서 $TargetDedicatedNodes 및 $PendingTasks는 서비스 정의 변수이고 startingNumberOfVMs 및 maxNumberofVMs는 사용자 정의 변수입니다.

참고 항목

서비스 정의 변수에는 항상 달러($) 기호가 앞에 붙습니다. 사용자 정의 변수의 경우 달러 기호는 선택 사항입니다.

다음 표에서는 Batch 서비스에서 정의하는 읽기-쓰기 및 읽기 전용 변수를 보여 줍니다.

읽기-쓰기 서비스 정의 변수

다음과 같은 서비스 정의 변수의 값을 가져오고 설정하여 풀의 컴퓨팅 노드 수를 관리할 수 있습니다.

변수	설명
$TargetDedicatedNodes	풀에 대한 전용 컴퓨팅 노드의 대상 수입니다. 풀이 항상 원하는 수의 노드에 도달하지 못할 수 있으므로 대상으로 지정합니다. 예를 들어 풀에서 최초 목표에 도달하기 전에 자동 크기 조정 평가에 따라 전용 노드의 목표 수가 수정되는 경우 풀에서 목표에 도달하지 못할 수 있습니다. 목표가 Batch 계정 노드 또는 코어 할당량을 초과하는 경우 Batch 서비스 모드에서 만든 계정의 풀이 해당 목표에 도달하지 못할 수 있습니다. 목표가 구독의 공유 코어 할당량을 초과하는 경우 사용자 구독 모드에서 만든 계정의 풀이 해당 목표에 도달하지 못할 수 있습니다.
$TargetLowPriorityNodes	풀에 대한 스폿 컴퓨팅 노드의 대상 수입니다. 풀이 항상 원하는 수의 노드에 도달하지 못할 수 있으므로 대상으로 지정합니다. 예를 들어 풀에서 최초 목표에 도달하기 전에 자동 크기 조정 평가에 따라 스폿 노드의 목표 수가 수정되는 경우 풀에서 목표에 도달하지 못할 수 있습니다. 목표가 Batch 계정 노드 또는 코어 할당량을 초과하는 경우 풀에서 해당 목표에 도달하지 못할 수도 있습니다. 스폿 컴퓨팅 노드에 대한 자세한 내용은 일괄 처리와 함께 스폿 VM 사용을 참조하세요.
$NodeDeallocationOption	풀에서 컴퓨팅 노드가 제거되는 경우 발생하는 작업입니다. 가능한 값은 다음과 같습니다. - requeue: 기본값입니다. 태스크를 즉시 종료하고 일정을 재조정하도록 작업 큐에 다시 배치합니다. 이 작업을 수행하면 목표 노드 수에 최대한 빠르게 도달할 수 있습니다. 그러나 실행 중인 작업이 중단된 다음, 다시 시작해야 하기 때문에 효율성이 떨어질 수 있습니다. - terminate: 태스크를 즉시 종료하고 작업 큐에서 제거합니다. - taskcompletion: 현재 실행 중인 태스크가 완료되기를 기다린 다음, 풀에서 해당 노드를 제거합니다. 태스크가 중단되고 큐에 대기하여 태스크가 이미 완료한 작업을 낭비하는 것을 방지하려면 이 옵션을 사용합니다. - retaineddata: 노드의 모든 로컬 태스크 보유 데이터가 정리되기를 기다린 다음 풀에서 해당 노드를 제거합니다.

참고 항목

$TargetDedicated 별칭을 사용하여 $TargetDedicatedNodes 변수를 지정할 수도 있습니다. 마찬가지로 $TargetLowPriorityNodes 변수는 $TargetLowPriority 별칭을 사용하여 지정할 수 있습니다. 완전히 명명된 변수와 해당 별칭이 수식에 의해 설정된 경우에는 완전히 명명된 변수에 할당된 값이 우선 적용됩니다.

읽기 전용 서비스 정의 변수

이러한 서비스 정의 변수의 값을 가져와서 Batch 서비스에서 메트릭을 기반으로 조정할 수 있습니다.

Important

작업 릴리스 태스크는 현재 $ActiveTasks 및 $PendingTasks와 같은 태스크 개수를 제공하는 변수에 포함되지 않습니다. 자동 크기 조정 수식에 따라 작업 릴리스 태스크를 실행하는 데 사용할 수 있는 노드가 없어 노드가 제거될 수 있습니다.

팁

이러한 읽기 전용 서비스 정의 변수는 각각에 연결된 데이터에 액세스하는 다양한 메서드를 제공하는 '개체'입니다. 자세한 내용은 이 문서의 뒷부분에 나오는 샘플 데이터 가져오기를 참조하세요.

변수	설명
$CPUPercent	평균 CPU 사용량 비율.
$WallClockSeconds	사용된 시간(초) 수. 2024년 3월 31일 이후 사용 중지.
$MemoryBytes	사용된 평균 메가바이트 수. 2024년 3월 31일 이후 사용 중지.
$DiskBytes	로컬 디스크에서 사용된 평균 기가바이트 수. 2024년 3월 31일 이후 사용 중지.
$DiskReadBytes	읽은 바이트 수입니다. 2024년 3월 31일 이후 사용 중지.
$DiskWriteBytes	쓴 바이트 수. 2024년 3월 31일 이후 사용 중지.
$DiskReadOps	수행된 디스크 읽기 작업 수. 2024년 3월 31일 이후 사용 중지.
$DiskWriteOps	수행된 디스크 쓰기 작업 수. 2024년 3월 31일 이후 사용 중지.
$NetworkInBytes	인바운드 바이트 수. 2024년 3월 31일 이후 사용 중지.
$NetworkOutBytes	아웃바운드 바이트 수. 2024년 3월 31일 이후 사용 중지.
$SampleNodeCount	컴퓨팅 노드 수. 2024년 3월 31일 이후 사용 중지.
$ActiveTasks	실행할 준비가 되었지만 아직 실행되지 않은 작업 수입니다. 여기에는 활성 상태에 있고 종속성이 충족된 태스크가 모두 포함됩니다. 활성 상태이지만 종속성이 충족되지 않은 작업은 모두 `$ActiveTasks` 수에서 제외됩니다. 다중 인스턴스 태스크의 경우 `$ActiveTasks`는 태스크에 설정된 인스턴스 수를 포함합니다.
$RunningTasks	실행 중 상태인 태스크 수.
$PendingTasks	`$ActiveTasks`와 `$RunningTasks`의 합입니다.
$SucceededTasks	성공적으로 완료된 태스크 수.
$FailedTasks	실패한 태스크 수.
$TaskSlotsPerNode	풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다.
$CurrentDedicatedNodes	현재 전용 컴퓨팅 노드 수.
$CurrentLowPriorityNodes	선점된 노드를 포함하여 현재 스폿 컴퓨팅 노드 수입니다.
$UsableNodeCount	사용 가능한 컴퓨팅 노드의 수입니다.
$PreemptedNodeCount	선점 상태에 있는 풀의 노드 수입니다.

Warning

위의 표에 설명된 대로 일부 서비스 정의 변수는 2024년 3월 31일 이후에 사용 중지됩니다. 사용 중지 날짜 이후에는 이러한 서비스 정의 변수가 더 이상 샘플 데이터로 채워지지 않습니다. 이 날짜 전에 이러한 변수 사용을 중단하세요.

참고 항목

특정 시점에 실행되는 태스크 수를 기준으로 크기를 조정하는 경우 $RunningTasks를 사용하고, 실행을 위해 큐에 대기 중인 작업의 수에 따라 크기를 조정하는 경우 $ActiveTasks를 사용합니다.

유형

자동 크기 조정 수식은 다음 형식을 지원합니다.

double
doubleVec
doubleVecList
string
timestamp - 다음 멤버를 포함하는 복합 구조입니다.
- 연도
- month (1-12)
- day (1-31)
- weekday(숫자 형식, 예: 1은 월요일을 의미함)
- hour(24시간 형식, 예: 13은 오후 1시를 의미함)
- minute (00-59)
- second (00-59)
timeinterval
- TimeInterval_Zero
- TimeInterval_100ns
- TimeInterval_Microsecond
- TimeInterval_Millisecond
- TimeInterval_Second
- TimeInterval_Minute
- TimeInterval_Hour
- TimeInterval_Day
- TimeInterval_Week
- TimeInterval_Year

작업

이전 섹션에서 나열된 형식에서 허용되는 연산은 다음과 같습니다.

연산	지원되는 연산자	결과 형식
double operator double	+, -, *, /	double
double operator timeinterval	*	timeinterval
doubleVec operator double	+, -, *, /	doubleVec
doubleVec operator doubleVec	+, -, *, /	doubleVec
timeinterval operator double	*, /	timeinterval
timeinterval operator timeinterval	+, -	timeinterval
timeinterval operator timestamp	+	timestamp
timestamp operator timeinterval	+	timestamp
timestamp operator timestamp	-	timeinterval
operator double	-, !	double
operator timeinterval	-	timeinterval
double operator double	<, <=, ==, >=, >, !=	double
string operator string	<, <=, ==, >=, >, !=	double
timestamp operator timestamp	<, <=, ==, >=, >, !=	double
timeinterval operator timeinterval	<, <=, ==, >=, >, !=	double
double operator double	&&, \|\|	double

삼항 연산자(double ? statement1 : statement2)를 사용하여 double을 테스트하면 0이 아닌 값이 true로, 0이 false로 반환됩니다.

함수

자동 크기 조정 수식을 정의할 때 이러한 미리 정의된 함수를 사용할 수 있습니다.

함수	반환 형식	설명
avg(doubleVecList)	double	doubleVecList에 있는 모든 값의 평균 값을 반환합니다.
ceil(double)	double	double보다 작지 않은 가장 작은 정수 값을 반환합니다.
ceil(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `ceil`을 반환합니다.
floor(double)	double	double보다 크지 않은 가장 큰 정수 값을 반환합니다.
floor(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `floor`를 반환합니다.
len(doubleVecList)	double	doubleVecList에서 만든 벡터의 길이를 반환합니다.
lg(double)	double	double의 로그 밑 2를 반환합니다.
lg(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `lg`를 반환합니다.
ln(double)	double	double의 자연 로그를 반환합니다.
ln(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `ln`를 반환합니다.
log(double)	double	double의 로그 밑 10을 반환합니다.
log(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `log`를 반환합니다.
max(doubleVecList)	double	doubleVecList의 최대값을 반환합니다.
min(doubleVecList)	double	doubleVecList의 최소값을 반환합니다.
norm(doubleVecList)	double	doubleVecList에서 만든 벡터의 두 기준을 반환합니다.
percentile(doubleVec v, double p)	double	벡터 v의 백분위수 요소를 반환합니다.
rand()	double	0.0에서 1.0 사이의 임의 값을 반환합니다.
range(doubleVecList)	double	doubleVecList에 있는 최소값과 최대값 사이의 차이를 반환합니다.
round(double)	double	0에서 반올림하여 가장 가까운 정수 값을 double(부동 소수점 형식)로 반환합니다.
round(doubleVecList)	doubleVec	doubleVecList의 구성 요소별 `round`를 반환합니다.
std(doubleVecList)	double	doubleVecList에 있는 값의 샘플 표준 편차를 반환합니다.
stop()		자동 크기 조정 식의 평가를 중지합니다.
sum(doubleVecList)	double	doubleVecList에 있는 모든 구성 요소의 합계를 반환합니다.
time(string dateTime="")	timestamp	매개 변수가 전달되지 않는 경우 현재 시간의 타임스탬프 또는 매개 변수가 전달되는 경우 dateTime 문자열의 타임스탬프를 반환합니다. 지원되는 dateTime 형식은 W3C-DTF 및 RFC 1123입니다.
val(doubleVec v, double i)	double	시작 인덱스가 0인 벡터 v의 위치 i 요소 값을 반환합니다.

앞의 표에서 설명하는 함수 중 일부는 목록을 인수로 허용할 수 있습니다. 쉼표로 구분된 목록은 double 및 doubleVec의 조합입니다. 예시:

doubleVecList := ( (double | doubleVec)+(, (double | doubleVec) )* )?

doubleVecList 값은 평가 전 단일 doubleVec으로 변환됩니다. 예를 들어 v = [1,2,3]의 경우 avg(v) 호출은 avg(1,2,3) 호출과 동일합니다. avg(v, 7) 호출은 avg(1,2,3,7) 호출과 동일합니다.

메트릭

수식을 정의할 때 리소스 및 작업 메트릭을 모두 사용할 수 있습니다. 가져오고 평가한 메트릭 데이터를 기반으로 하는 풀의 전용 노드 대상 수를 조정합니다. 각 메트릭에 대한 자세한 내용은 변수 섹션을 참조하세요.

메트릭	설명
리소스	리소스 메트릭은 CPU, 대역폭, 컴퓨팅 노드의 메모리 사용량 및 노드 수를 기반으로 합니다. 이러한 서비스 정의 변수는 노드 수에 기반하여 조정하는 데 유용합니다. - $TargetDedicatedNodes - $TargetLowPriorityNodes - $CurrentDedicatedNodes - $CurrentLowPriorityNodes - $PreemptedNodeCount - $UsableNodeCount 이러한 서비스 정의 변수는 노드 리소스 사용량에 기반하여 조정하는 데 유용합니다. - $CPUPercent - $WallClockSeconds - $MemoryBytes - $DiskBytes - $DiskReadBytes - $DiskWriteBytes - $DiskReadOps - $DiskWriteOps - $NetworkInBytes - $NetworkOutBytes
작업	태스크 메트릭은 활성, 보류 중 및 완료됨과 같은 태스크 상태를 기반으로 합니다. 다음 서비스 정의 변수는 노드 작업 메트릭에 기반하여 풀 크기를 조정하는 데 유용합니다. - $ActiveTasks - $RunningTasks - $PendingTasks - $SucceededTasks - $FailedTasks

메트릭

설명

리소스

리소스 메트릭은 CPU, 대역폭, 컴퓨팅 노드의 메모리 사용량 및 노드 수를 기반으로 합니다.

이러한 서비스 정의 변수는 노드 수에 기반하여 조정하는 데 유용합니다.
- $TargetDedicatedNodes
- $TargetLowPriorityNodes
- $CurrentDedicatedNodes
- $CurrentLowPriorityNodes
- $PreemptedNodeCount
- $UsableNodeCount

이러한 서비스 정의 변수는 노드 리소스 사용량에 기반하여 조정하는 데 유용합니다.
- $CPUPercent
- $WallClockSeconds
- $MemoryBytes
- $DiskBytes
- $DiskReadBytes
- $DiskWriteBytes
- $DiskReadOps
- $DiskWriteOps
- $NetworkInBytes
- $NetworkOutBytes

작업

태스크 메트릭은 활성, 보류 중 및 완료됨과 같은 태스크 상태를 기반으로 합니다. 다음 서비스 정의 변수는 노드 작업 메트릭에 기반하여 풀 크기를 조정하는 데 유용합니다.
- $ActiveTasks
- $RunningTasks
- $PendingTasks
- $SucceededTasks
- $FailedTasks

샘플 데이터 가져오기

자동 크기 조정 수식의 핵심 작업은 작업 및 리소스 메트릭 데이터(샘플)를 가져온 다음, 해당 데이터에 따라 풀 크기를 조정하는 것입니다. 따라서 자동 크기 조정 수식이 샘플과 상호 작용하는 방식을 명확히 이해해야 합니다.

메서드

자동 크기 조정 수식은 Batch 서비스에서 제공하는 메트릭 데이터의 샘플에 대해 작동합니다. 수식은 가져오는 값에 따라 풀 컴퓨팅 노드를 늘리거나 축소합니다. 서비스 정의 변수는 해당 개체에 연결된 데이터에 액세스하는 메서드를 제공하는 개체입니다. 예를 들어, 다음 식은 최근 5분 동안의 CPU 사용률을 얻기 위한 요청을 보여 줍니다.

$CPUPercent.GetSample(TimeInterval_Minute * 5)

다음 메서드를 사용하여 서비스 정의 변수에 대한 샘플 데이터를 가져올 수 있습니다.

메서드	설명
GetSample()	`GetSample()` 메서드는 데이터 샘플의 벡터를 반환합니다. 하나의 샘플은 30초 동안의 메트릭 데이터입니다. 즉 30초마다 샘플을 가져옵니다. 그러나 아래에서 설명하듯이 샘플이 수집된 시간과 해당 샘플을 수식에 사용할 수 있게 되는 시간 사이에 지연이 있습니다. 따라서 지정된 기간 동안 일부 샘플을 수식에 의한 평가에 사용할 수 없을지도 모릅니다. - `doubleVec GetSample(double count)`: 수집한 최근 샘플에서 가져올 샘플 수를 지정합니다. `GetSample(1)`은 사용 가능한 마지막 샘플을 반환합니다. 그러나 `$CPUPercent`와 같은 메트릭의 경우 샘플이 수집된 '시점'을 알 수 없기 때문에 `GetSample(1)`을 사용해서는 안 됩니다. 최근 샘플일 수도 있지만 시스템 문제로 인해 훨씬 오래된 샘플일 수도 있습니다. 그러한 경우 아래에 표시된 것처럼 시간 간격을 사용하는 것이 더 좋습니다. - `doubleVec GetSample((timestamp or timeinterval) startTime [, double samplePercent])`: 샘플 데이터를 수집하기 위한 시간 프레임을 지정합니다. 선택적으로 요청 시간 프레임에 있어야 하는 샘플의 백분율을 지정합니다. 예를 들어 `$CPUPercent.GetSample(TimeInterval_Minute * 10)`은 지난 10분 동안의 모든 샘플이 `CPUPercent` 기록에 있는 경우 20개 샘플을 반환합니다. 기록의 마지막 1분을 사용할 수 없다면 샘플은 18개만 반환될 것입니다. 이 경우 샘플의 90%만 사용할 수 있기 때문에 `$CPUPercent.GetSample(TimeInterval_Minute * 10, 95)`은 실패하지만 `$CPUPercent.GetSample(TimeInterval_Minute * 10, 80)`은 성공합니다. - `doubleVec GetSample((timestamp or timeinterval) startTime, (timestamp or timeinterval) endTime [, double samplePercent])`: 시작 시간과 종료 시간을 사용하여 데이터를 수집하기 위한 시간 프레임을 지정합니다. 위에서 언급했듯이 샘플이 수집된 시간과 해당 샘플을 수식에 사용할 수 있게 되는 시간 사이에 지연이 있습니다. `GetSample` 메서드를 사용할 때 이 지연을 고려해 보세요. 아래 `GetSamplePercent` 참조
GetSamplePeriod()	기록 샘플 데이터 집합에서 가져온 샘플의 기간을 반환합니다.
Count()	메트릭 기록에 있는 총 샘플 수를 반환합니다.
HistoryBeginTime()	메트릭에 대해 사용 가능한 가장 오래된 데이터 샘플의 타임스탬프를 반환합니다.
GetSamplePercent()	지정된 시간 간격에 사용할 수 있는 샘플의 백분율을 반환합니다. 예: `doubleVec GetSamplePercent( (timestamp or timeinterval) startTime [, (timestamp or timeinterval) endTime] )`. 반환된 샘플의 백분율이 지정한 `samplePercent`보다 작은 경우 `GetSample` 메서드가 실패하기 때문에 `GetSamplePercent` 메서드를 사용하여 먼저 확인할 수 있습니다. 그런 다음 비효율적인 샘플이 존재하는 경우 자동 크기 조정 평가를 중단하지 않고 대체 작업을 수행할 수 있습니다.

샘플

Batch 서비스는 정기적으로 작업 및 리소스 메트릭의 샘플을 가져와 자동 크기 조정 수식에 사용할 수 있도록 합니다. 이러한 샘플은 Batch 서비스에서 30초 마다 기록됩니다. 하지만 일반적으로 이러한 샘플을 기록하는 시간과 자동 크기 조정 수식에서 사용할 수 있을 시간(읽는 시간) 사이에 지연이 있습니다. 또한 네트워크 또는 다른 인프라 문제와 같은 요인으로 인해 샘플이 특정 기간에 기록되지 않을 수 있습니다.

샘플 비율

samplePercent를 GetSample() 메서드에 전달하거나 GetSamplePercent() 메서드를 호출하는 경우 percent(비율)는 Batch 서비스에서 기록하는 샘플의 가능한 총 수와 자동 크기 조정 수식에서 사용할 수 있는 샘플 수를 비교한 것입니다.

예를 들어 10분 시간 범위를 살펴보겠습니다. 샘플이 이 10분 시간 범위 내에서 30초마다 기록되므로 Batch에 의해 기록된 샘플의 최대 총 수는 20개 샘플(분당 2개)입니다. 그러나 보고 메커니즘의 고유한 대기 시간 또는 Azure 내의 다른 문제로 인해 자동 크기 조정 수식에서 읽는 데 사용할 수 있는 샘플은 15개뿐일 수 있습니다. 예를 들어 10분 동안 기록하는 샘플의 총 개수 중 75%만 수식에서 사용할 수 있습니다.

GetSample() 및 샘플 범위

자동 크기 조정 수식은 노드를 추가 또는 제거하여 풀을 확장 및 축소합니다. 노드에는 비용이 들기 때문에 수식은 충분한 데이터를 기반으로 지능형 분석 메서드를 사용해야 합니다. 수식에 추세 형식 분석을 사용하는 것이 좋습니다. 이 형식은 수집된 샘플의 범위에 따라 풀을 확장하고 축소합니다.

이렇게 하려면 GetSample(interval look-back start, interval look-back end)를 사용하여 샘플의 벡터를 반환합니다.

$runningTasksSample = $RunningTasks.GetSample(1 * TimeInterval_Minute, 6 * TimeInterval_Minute);

Batch는 위의 줄을 평가할 때 샘플 범위를 값의 벡터로 반환합니다. 예시:

$runningTasksSample=[1,1,1,1,1,1,1,1,1,1];

샘플의 벡터를 수집한 후 min(), max() 및 avg()와 같은 함수를 사용하여 수집된 범위에서 의미 있는 값을 파생시킬 수 있습니다.

특정 기간 동안 특정 샘플 비율 미만을 사용할 수 있는 경우 수식 평가가 실패하도록 강제할 수 있습니다. 수식 평가가 실패하도록 강제하면 지정된 샘플 비율을 사용할 수 없는 경우 Batch에 수식의 추가 평가를 중단하도록 지시합니다. 이 경우 풀 크기가 변경되지 않습니다. 평가가 성공하기 위해 샘플의 필요한 백분율을 지정하려면 GetSample()에 대한 세 번째 매개 변수로 지정합니다. 여기에서는 샘플의 75% 요구 사항이 지정됩니다.

$runningTasksSample = $RunningTasks.GetSample(60 * TimeInterval_Second, 120 * TimeInterval_Second, 75);

또한 샘플 가용성에 지연 시간이 있을 수 있으므로 시간 범위를 1분 이상인 돌아보기 시작 시간으로 지정해야 합니다. 샘플이 시스템을 통해 전파되는 데 약 1분 정도가 걸리므로 (0 * TimeInterval_Second, 60 * TimeInterval_Second) 범위에 있는 샘플은 사용하지 못할 수도 있습니다. 다시 GetSample()라는 백분율 매개 변수를 사용하여 특정 샘플 비율 요구 사항을 강제할 수 있습니다.

Important

자동 크기 조정 수식에만 의존하지 GetSample(1)않는 것이 좋습니다. GetSample(1)은 기본적으로 Batch 서비스에 “경과한 시간에 관계 없이 마지막 샘플을 제공하도록” 요구하기 때문입니다. 이 샘플은 단일 샘플이고 오래된 샘플이기 때문에 최근 작업 또는 리소스 상태의 큰 그림을 나타내지 않을 수 있습니다. GetSample(1)을 사용하는 경우 큰 문의 일부이며 수식이 사용하는 유일한 데이터 지점이 아니도록 주의합니다.

자동 크기 조정 수식 작성

위의 구성 요소를 사용하는 구문을 구성하여 자동 크기 조정 수식을 작성한 다음 해당 구문을 완전한 수식으로 결합합니다. 이 섹션에서는 실제 크기 조정 결정 및 조정을 수행할 수 있는 자동 크기 조정 수식 예제를 만듭니다.

먼저 새 자동 크기 조정 수식에 대한 요구 사항을 정의합니다. 수식은 다음과 같아야 합니다.

CPU 사용량이 많은 경우 풀에 있는 전용 컴퓨팅 노드의 목표 수를 늘립니다.
CPU 사용량이 적은 경우 풀에 있는 전용 컴퓨팅 노드의 목표 수를 줄입니다.
전용 노드의 최대 수는 항상 400으로 제한합니다.
노드 수를 줄이는 경우 태스크를 실행 중인 노드를 제거하지 마세요. 필요한 경우 태스크가 완료될 때까지 기다렸다 노드를 제거합니다.

수식의 첫 번째 문은 CPU 사용량이 많은 동안 노드 수를 늘립니다. 지난 10분 동안 CPU 최소 평균 사용량이 70%를 초과한 경우에만 사용자 정의 변수($totalDedicatedNodes)를 전용 노드의 현재 목표 수의 110%인 값으로 채우는 문을 정의합니다. 그렇지 않으면 전용 노드의 현재 수에 대한 값을 사용합니다.

$totalDedicatedNodes =
    (min($CPUPercent.GetSample(TimeInterval_Minute * 10)) > 0.7) ?
    ($CurrentDedicatedNodes * 1.1) : $CurrentDedicatedNodes;

CPU 사용량이 적은 동안 전용 노드 수를 줄이려면, 지난 60분 동안 CPU 평균 사용량이 20% 미만인 경우 수식의 다음 문에서 동일한 $totalDedicatedNodes 변수를 전용 노드의 현재 목표 수의 90%로 설정합니다. 그렇지 않으면 위 문에 채워진 $totalDedicatedNodes의 현재 값을 사용합니다.

$totalDedicatedNodes =
    (avg($CPUPercent.GetSample(TimeInterval_Minute * 60)) < 0.2) ?
    ($CurrentDedicatedNodes * 0.9) : $totalDedicatedNodes;

이제 전용 컴퓨팅 노드의 대상 수를 최대 400개로 제한합니다.

$TargetDedicatedNodes = min(400, $totalDedicatedNodes);

마지막으로 태스크가 완료될 때까지 노드가 제거되지 않도록 해야 합니다.

$NodeDeallocationOption = taskcompletion;

완성된 수식은 다음과 같습니다.

$totalDedicatedNodes =
    (min($CPUPercent.GetSample(TimeInterval_Minute * 10)) > 0.7) ?
    ($CurrentDedicatedNodes * 1.1) : $CurrentDedicatedNodes;
$totalDedicatedNodes =
    (avg($CPUPercent.GetSample(TimeInterval_Minute * 60)) < 0.2) ?
    ($CurrentDedicatedNodes * 0.9) : $totalDedicatedNodes;
$TargetDedicatedNodes = min(400, $totalDedicatedNodes);
$NodeDeallocationOption = taskcompletion;

참고 항목

원하는 경우 수식 문자열에 주석과 줄 바꿈을 모두 포함할 수 있습니다. 또한 세미콜론을 생략하면 평가 오류가 발생할 수 있습니다.

자동 크기 조정 간격

기본적으로 Batch 서비스는 15분마다 자동 크기 조정 수식에 따라 풀의 크기를 조정합니다. 이 간격은 다음 풀 속성을 사용하여 구성할 수 있습니다.

CloudPool.AutoScaleEvaluationInterval(Batch .NET)
autoScaleEvaluationInterval(REST API)

최소 간격은 5분이고 최대 간격은 168시간입니다. 이 범위를 벗어나는 간격을 지정하면 Batch 서비스에서 잘못된 요청(400) 오류를 반환합니다.

참고 항목

자동 크기 조정은 현재 1분 미만의 변경 내용에 응답하지 않지만 워크로드를 실행하면 점차적으로 풀의 크기를 조정합니다.

Batch SDK로 자동 크기 조정 가능한 풀 만들기

풀 자동 크기 조정은 Batch SDK, Batch REST API Batch PowerShell cmdlet 및 Batch CLI 중 하나를 사용하여 구성할 수 있습니다. 이 섹션에서는 .NET 및 Python에 대한 예제를 볼 수 있습니다.

.NET

.NET에서 자동 크기 조정 가능한 풀을 만들려면 다음 단계를 수행합니다.

BatchClient.PoolOperations.CreatePool을 사용하여 풀을 만듭니다.
CloudPool.AutoScaleEnabled 속성을 true로 설정합니다.
자동 크기 조정 수식을 사용하여 CloudPool.AutoScaleFormula 속성을 설정합니다.
(선택 사항) CloudPool.AutoScaleEvaluationInterval 속성을 설정합니다(기본값: 15 분).
CloudPool.Commit 또는 CommitAsync로 풀을 커밋합니다.

다음 예제에서는 .NET에서 자동 크기 조정 가능한 풀을 만듭니다. 풀의 자동 크기 조정 수식에서 전용 노드의 목표 수를 월요일에는 5로, 나머지 요일에는 1로 설정합니다. 자동 크기 조정 간격은 30분으로 설정됩니다. 이 코드 조각과 이 문서의 다른 C# 코드 조각에서 myBatchClient는 BatchClient 클래스의 올바르게 초기화된 인스턴스입니다.

CloudPool pool = myBatchClient.PoolOperations.CreatePool(
                    poolId: "mypool",
                    virtualMachineSize: "standard_d1_v2",
                    VirtualMachineConfiguration: new VirtualMachineConfiguration(
                        imageReference: new ImageReference(
                                            publisher: "MicrosoftWindowsServer",
                                            offer: "WindowsServer",
                                            sku: "2019-datacenter-core",
                                            version: "latest"),
                        nodeAgentSkuId: "batch.node.windows amd64");
pool.AutoScaleEnabled = true;
pool.AutoScaleFormula = "$TargetDedicatedNodes = (time().weekday == 1 ? 5:1);";
pool.AutoScaleEvaluationInterval = TimeSpan.FromMinutes(30);
await pool.CommitAsync();

Important

자동 크기 조정 가능한 풀을 만들 때는 CreatePool 호출에서 targetDedicatedNodes 매개 변수 또는 targetLowPriorityNodes 매개 변수를 지정하지 마세요. 대신 풀에 AutoScaleEnabled 및 AutoScaleFormula 속성을 지정합니다. 이러한 속성의 값은 각 노드 형식의 목표 수를 결정합니다.

자동 크기 조정 가능한 풀의 크기를 수동으로 조정하려는 경우(예: BatchClient.PoolOperations.ResizePoolAsync 사용) 먼저 풀에서 자동 크기 조정을 사용하지 않도록 설정한 다음 풀의 크기를 조정해야 합니다.

팁

.NET SDK 사용에 대한 자세한 예제는 GitHub의 Batch .NET 빠른 시작 리포지토리를 참조하세요.

Python

Python SDK를 사용하여 자동 크기 조정 가능한 풀을 만들려면 다음을 수행합니다.

풀을 만들고 해당 구성을 지정합니다.
서비스 클라이언트에 풀을 추가합니다.
작성하는 수식을 사용하여 풀에서 자동 크기 조정을 사용하도록 설정합니다.

다음 예제에서는 이러한 단계를 보여줍니다.

# Create a pool; specify configuration
new_pool = batch.models.PoolAddParameter(
    id="autoscale-enabled-pool",
    virtual_machine_configuration=batchmodels.VirtualMachineConfiguration(
        image_reference=batchmodels.ImageReference(
          publisher="Canonical",
          offer="UbuntuServer",
          sku="20.04-LTS",
          version="latest"
            ),
        node_agent_sku_id="batch.node.ubuntu 20.04"),
    vm_size="STANDARD_D1_v2",
    target_dedicated_nodes=0,
    target_low_priority_nodes=0
)
batch_service_client.pool.add(new_pool) # Add the pool to the service client

formula = """$curTime = time();
             $workHours = $curTime.hour >= 8 && $curTime.hour < 18;
             $isWeekday = $curTime.weekday >= 1 && $curTime.weekday <= 5;
             $isWorkingWeekdayHour = $workHours && $isWeekday;
             $TargetDedicated = $isWorkingWeekdayHour ? 20:10;""";

# Enable autoscale; specify the formula
response = batch_service_client.pool.enable_auto_scale(pool_id, auto_scale_formula=formula,
                                            auto_scale_evaluation_interval=datetime.timedelta(minutes=10),
                                            pool_enable_auto_scale_options=None,
                                            custom_headers=None, raw=False)

팁

Python SDK 사용에 대한 자세한 예제는 GitHub의 Batch Python 빠른 시작 리포지토리를 참조하세요.

기존 풀에서 자동 크기 조정 사용

각 Batch SDK는 자동 크기 조정을 사용하도록 설정하는 방법을 제공합니다. 예시:

BatchClient.PoolOperations.EnableAutoScaleAsync(Batch .NET)
풀에서 자동 크기 조정 사용(REST API)

기존 풀에서 자동 크기 조정을 사용하도록 설정하는 경우 다음에 유의하세요.

현재 풀에서 자동 크기 조정이 사용하지 않도록 설정된 경우 요청을 발급할 때 유효한 자동 크기 조정 수식을 지정해야 합니다. 선택적으로 자동 크기 조정 간격을 지정할 수 있습니다. 간격을 지정하지 않으면 기본값 15분이 사용됩니다.
현재 풀에서 자동 크기 조정이 사용하도록 설정된 경우 새 수식, 새 간격 또는 둘 다를 지정할 수 있습니다. 이러한 속성 중 하나 이상을 지정해야 합니다.
- 새 자동 크기 조정 간격을 지정하는 경우 기존 일정이 중지되고 새 일정이 시작됩니다. 새 일정의 시작 시간은 자동 크기 조정을 사용하기 위한 요청이 발급된 시간입니다.
- 자동 크기 조정 수식 또는 간격을 생략하면 Batch 서비스에서 해당 설정의 현재 값을 계속 사용합니다.

참고 항목

.NET에서 풀을 만들 때 CreatePool 메서드의 targetDedicatedNodes 또는 targetLowPriorityNodes 매개 변수에 대한 값을 지정했거나 다른 언어의 비교 가능한 매개 변수에 대한 값을 지정한 경우, 자동 크기 조정 수식을 평가할 때 해당 값이 무시됩니다.

이 C# 예제에서는 Batch .NET 라이브러리를 사용하여 기존 풀에서 자동 크기 조정을 사용하도록 설정합니다.

// Define the autoscaling formula. This formula sets the target number of nodes
// to 5 on Mondays, and 1 on every other day of the week
string myAutoScaleFormula = "$TargetDedicatedNodes = (time().weekday == 1 ? 5:1);";

// Set the autoscale formula on the existing pool
await myBatchClient.PoolOperations.EnableAutoScaleAsync(
    "myexistingpool",
    autoscaleFormula: myAutoScaleFormula);

자동 크기 조정 수식 업데이트

기존의 자동 크기 조정 가능한 풀에서 수식을 업데이트하려면 새 수식을 사용하여 자동 크기 조정을 사용하도록 다시 설정하는 작업을 호출합니다. 예를 들어 다음 .NET 코드가 실행될 때 myexistingpool에서 자동 크기 조정을 사용하도록 이미 설정되어 있으면 자동 크기 조정 수식이 myNewFormula의 내용으로 바뀝니다.

await myBatchClient.PoolOperations.EnableAutoScaleAsync(
    "myexistingpool",
    autoscaleFormula: myNewFormula);

자동 크기 조정 간격 업데이트

기존의 자동 크기 조정 가능한 풀의 자동 크기 조정 평가 간격을 업데이트하려면 새 간격으로 자동 크기 조정을 사용하도록 다시 설정하는 작업을 호출합니다. 예를 들어 .NET에서 이미 자동 크기 조정 가능한 풀에 대해 자동 크기 조정 평가 간격을 60분으로 설정하려면 다음을 수행합니다.

await myBatchClient.PoolOperations.EnableAutoScaleAsync(
    "myexistingpool",
    autoscaleEvaluationInterval: TimeSpan.FromMinutes(60));

자동 크기 조정 수식 평가

수식은 풀에 적용하기 전에 평가할 수 있습니다. 이렇게 하면 프로덕션 환경에 배치하기 전에 수식의 결과를 테스트할 수 있습니다.

자동 크기 조정 수식을 평가하려면 먼저 한 줄 수식 $TargetDedicatedNodes = 0과 같은 유효한 수식으로 풀에서 자동 크기 조정을 사용하도록 설정해야 합니다. 그런 후에 다음 중 하나를 사용하여 테스트할 수식을 평가합니다.

BatchClient.PoolOperations.EvaluateAutoScale 또는 EvaluateAutoScaleAsync

이러한 Batch .NET 메서드를 사용하려면 기존 풀의 ID와 평가할 자동 크기 조정 수식이 포함된 문자열이 필요합니다.
자동 크기 조정 수식 평가

이 REST API 요청에서 풀 ID는 URI에 지정하고, 자동 크기 조정 수식은 요청 본문의 autoScaleFormula 요소에 지정합니다. 작업 응답에는 수식과 관련이 있을 수 있는 오류 정보가 포함됩니다.

다음 Batch .NET 예제에서는 자동 크기 조정 수식을 평가합니다. 풀에서 자동 크기 조정을 아직 사용하지 않는 경우 먼저 사용하도록 설정합니다.

// First obtain a reference to an existing pool
CloudPool pool = await batchClient.PoolOperations.GetPoolAsync("myExistingPool");

// If autoscaling isn't already enabled on the pool, enable it.
// You can't evaluate an autoscale formula on a non-autoscale-enabled pool.
if (pool.AutoScaleEnabled == false)
{
    // You need a valid autoscale formula to enable autoscaling on the
    // pool. This formula is valid, but won't resize the pool:
    await pool.EnableAutoScaleAsync(
        autoscaleFormula: "$TargetDedicatedNodes = $CurrentDedicatedNodes;",
        autoscaleEvaluationInterval: TimeSpan.FromMinutes(5));

    // Batch limits EnableAutoScaleAsync calls to once every 30 seconds.
    // Because you want to apply our new autoscale formula below if it
    // evaluates successfully, and you *just* enabled autoscaling on
    // this pool, pause here to ensure you pass that threshold.
    Thread.Sleep(TimeSpan.FromSeconds(31));

    // Refresh the properties of the pool so that we've got the
    // latest value for AutoScaleEnabled
    await pool.RefreshAsync();
}

// You must ensure that autoscaling is enabled on the pool prior to
// evaluating a formula
if (pool.AutoScaleEnabled == true)
{
    // The formula to evaluate - adjusts target number of nodes based on
    // day of week and time of day
    string myFormula = @"
        $curTime = time();
        $workHours = $curTime.hour >= 8 && $curTime.hour < 18;
        $isWeekday = $curTime.weekday >= 1 && $curTime.weekday <= 5;
        $isWorkingWeekdayHour = $workHours && $isWeekday;
        $TargetDedicatedNodes = $isWorkingWeekdayHour ? 20:10;
    ";

    // Perform the autoscale formula evaluation. Note that this code does not
    // actually apply the formula to the pool.
    AutoScaleRun eval =
        await batchClient.PoolOperations.EvaluateAutoScaleAsync(pool.Id, myFormula);

    if (eval.Error == null)
    {
        // Evaluation success - print the results of the AutoScaleRun.
        // This will display the values of each variable as evaluated by the
        // autoscale formula.
        Console.WriteLine("AutoScaleRun.Results: " +
            eval.Results.Replace("$", "\n    $"));

        // Apply the formula to the pool since it evaluated successfully
        await batchClient.PoolOperations.EnableAutoScaleAsync(pool.Id, myFormula);
    }
    else
    {
        // Evaluation failed, output the message associated with the error
        Console.WriteLine("AutoScaleRun.Error.Message: " +
            eval.Error.Message);
    }
}

이 코드 조각에 표시된 수식을 성공적으로 평가하면 다음과 비슷한 결과가 생성됩니다.

AutoScaleRun.Results:
    $TargetDedicatedNodes=10;
    $NodeDeallocationOption=requeue;
    $curTime=2016-10-13T19:18:47.805Z;
    $isWeekday=1;
    $isWorkingWeekdayHour=0;
    $workHours=0

자동 크기 조정 실행에 대한 정보 가져오기

자동 크기 조정 수식에 대한 Batch 서비스의 평가를 주기적으로 확인하는 것이 좋습니다. 이렇게 하려면 풀에 대한 참조를 가져오고(또는 새로 고침) 마지막 자동 크기 조정 실행의 속성을 검사합니다.

Batch .NET에서 CloudPool.AutoScaleRun 속성에는 풀에서 수행된 마지막 자동 크기 조정 실행에 대한 정보를 제공하는 몇 가지 속성이 있습니다.

REST API에서 풀에 대한 정보 가져오기 요청은 autoScaleRun 속성에 마지막 자동 크기 조정 실행 정보가 포함된 풀 관련 정보를 반환합니다.

다음 C# 예제에서는 Batch .NET 라이브러리를 사용하여 myPool 풀에서 마지막으로 실행된 자동 크기 조정에 대한 정보를 출력합니다.

await Cloud pool = myBatchClient.PoolOperations.GetPoolAsync("myPool");
Console.WriteLine("Last execution: " + pool.AutoScaleRun.Timestamp);
Console.WriteLine("Result:" + pool.AutoScaleRun.Results.Replace("$", "\n  $"));
Console.WriteLine("Error: " + pool.AutoScaleRun.Error);

위 예제의 샘플 출력은 다음과 같습니다.

Last execution: 10/14/2016 18:36:43
Result:
  $TargetDedicatedNodes=10;
  $NodeDeallocationOption=requeue;
  $curTime=2016-10-14T18:36:43.282Z;
  $isWeekday=1;
  $isWorkingWeekdayHour=0;
  $workHours=0
Error:

풀 자동 크기 조정 이벤트를 사용하여 자동 크기 조정 실행 기록 가져오기

PoolAutoScaleEvent를 쿼리하여 자동 크기 조정 기록을 확인할 수도 있습니다. Batch는 자동 크기 조정 수식 평가 및 실행이 발생할 때마다 기록하기 위해 이 이벤트를 내보냅니다. 이는 잠재적인 문제를 해결하는 데 도움이 될 수 있습니다.

PoolAutoScaleEvent 샘플 이벤트:

{
    "id": "poolId",
    "timestamp": "2020-09-21T23:41:36.750Z",
    "formula": "...",
    "results": "$TargetDedicatedNodes=10;$NodeDeallocationOption=requeue;$curTime=2016-10-14T18:36:43.282Z;$isWeekday=1;$isWorkingWeekdayHour=0;$workHours=0",
    "error": {
        "code": "",
        "message": "",
        "values": []
    }
}

자동 크기 조정 수식 예제

풀의 컴퓨팅 리소스 양을 조정하는 여러 가지 방법을 보여 주는 몇 가지 수식을 살펴보겠습니다.

예제1: 시간 기반 조정

요일과 시간에 따라 풀 크기를 조정한다고 가정합니다. 이 예제에서는 풀의 노드 수를 적절히 늘리거나 줄이는 방법을 보여 줍니다.

먼저 수식에서 현재 시간을 가져옵니다. 평일(1-5)에 근무 시간(오전 8시-오후 6시)인 경우, 대상 풀 크기는 20개의 노드로 설정됩니다. 그렇지 않으면 10개 노드로 설정됩니다.

$curTime = time();
$workHours = $curTime.hour >= 8 && $curTime.hour < 18;
$isWeekday = $curTime.weekday >= 1 && $curTime.weekday <= 5;
$isWorkingWeekdayHour = $workHours && $isWeekday;
$TargetDedicatedNodes = $isWorkingWeekdayHour ? 20:10;
$NodeDeallocationOption = taskcompletion;

$curTime은 TimeZoneInterval_Hour의 제품에 time() 및 UTC 오프셋을 추가하여 현지 표준 시간대를 반영하도록 조정할 수 있습니다. 예를 들어 MDT(산지 일광 절약 시간제)에 $curTime = time() + (-6 * TimeInterval_Hour);를 사용합니다. 일광 절약 시간(해당 하는 경우)의 시작과 끝에 오프셋을 조정해야 합니다.

예제2: 작업 기반 조정

이 C# 예제에서 풀 크기는 큐에 있는 작업의 수에 따라 조정됩니다. 주석과 줄 바꿈은 모두 수식 문자열에 포함됩니다.

// Get pending tasks for the past 15 minutes.
$samples = $PendingTasks.GetSamplePercent(TimeInterval_Minute * 15);
// If you have fewer than 70 percent data points, use the last sample point,
// otherwise use the maximum of last sample point and the history average.
$tasks = $samples < 70 ? max(0,$PendingTasks.GetSample(1)) : max( $PendingTasks.GetSample(1), avg($PendingTasks.GetSample(TimeInterval_Minute * 15)));
// If number of pending tasks is not 0, set targetVM to pending tasks, otherwise
// half of current dedicated.
$targetVMs = $tasks > 0? $tasks:max(0, $TargetDedicatedNodes/2);
// The pool size is capped at 20, if target VM value is more than that, set it
// to 20. This value should be adjusted according to your use case.
$TargetDedicatedNodes = max(0, min($targetVMs, 20));
// Set node deallocation mode - let running tasks finish before removing a node
$NodeDeallocationOption = taskcompletion;

예제3: 병렬 작업에 대한 회계

이 C# 예제에서는 태스크 수에 따라 풀 크기를 조정합니다. 이 수식은 또한 풀에 설정된 TaskSlotsPerNode 값을 고려합니다. 이 방법은 병렬 작업 실행이 풀에서 사용된 경우에 특히 유용합니다.

// Determine whether 70 percent of the samples have been recorded in the past
// 15 minutes; if not, use last sample
$samples = $ActiveTasks.GetSamplePercent(TimeInterval_Minute * 15);
$tasks = $samples < 70 ? max(0,$ActiveTasks.GetSample(1)) : max( $ActiveTasks.GetSample(1),avg($ActiveTasks.GetSample(TimeInterval_Minute * 15)));
// Set the number of nodes to add to one-fourth the number of active tasks
// (the TaskSlotsPerNode property on this pool is set to 4, adjust
// this number for your use case)
$cores = $TargetDedicatedNodes * 4;
$extraVMs = (($tasks - $cores) + 3) / 4;
$targetVMs = ($TargetDedicatedNodes + $extraVMs);
// Attempt to grow the number of compute nodes to match the number of active
// tasks, with a maximum of 3
$TargetDedicatedNodes = max(0,min($targetVMs,3));
// Keep the nodes active until the tasks finish
$NodeDeallocationOption = taskcompletion;

예제4: 초기 풀 크기 설정

이 예제에서는 초기 기간 동안 풀 크기를 지정된 노드 수로 설정하는 자동 크기 조정 수식이 있는 C# 예제를 보여 줍니다. 그런 다음 실행 중인 태스크 수와 활성 태스크 수에 따라 풀 크기를 조정합니다.

특히 이 수식은 다음 작업을 수행합니다.

초기 풀 크기를 4 노드로 설정합니다.
풀의 수명 주기의 처음 10분 이내에는 풀 크기를 조정하지 않습니다.
10분 후 지난 60분 이내에 실행 중이고 활성화된 작업 수의 최대값을 가져옵니다.
- 마지막 60분 동안 실행 중이거나 활성화된 작업이 없었음을 나타내는 두 값이 모두 0이면 풀 크기가 0으로 설정됩니다.
- 값 중 하나가 0보다 큰 경우 변경되지 않습니다.

string now = DateTime.UtcNow.ToString("r");
string formula = string.Format(@"
    $TargetDedicatedNodes = {1};
    lifespan         = time() - time(""{0}"");
    span             = TimeInterval_Minute * 60;
    startup          = TimeInterval_Minute * 10;
    ratio            = 50;

    $TargetDedicatedNodes = (lifespan > startup ? (max($RunningTasks.GetSample(span, ratio), $ActiveTasks.GetSample(span, ratio)) == 0 ? 0 : $TargetDedicatedNodes) : {1});
    ", now, 4);

다음 단계

풀의 컴퓨팅 노드에서 여러 태스크를 동시에 실행하는 방법을 알아봅니다. 자동 크기 조정과 함께 이 기능은 일부 워크로드에 대한 작업 기간을 줄여서 비용을 절약하는 데 도움이 될 수 있습니다.
Azure Batch 서비스를 효율적으로 쿼리하는 방법을 알아봅니다.

Batch 풀에서 컴퓨팅 노드 크기를 자동으로 조정하는 수식 만들기

자동 크기 조정 수식

샘플 자동 크기 조정 수식

작업 보류 중

선점된 노드

variables

읽기-쓰기 서비스 정의 변수

읽기 전용 서비스 정의 변수

유형

작업

함수

메트릭

샘플 데이터 가져오기

메서드

샘플

샘플 비율

GetSample() 및 샘플 범위

자동 크기 조정 수식 작성

자동 크기 조정 간격

Batch SDK로 자동 크기 조정 가능한 풀 만들기

.NET

Python

기존 풀에서 자동 크기 조정 사용

자동 크기 조정 수식 업데이트

자동 크기 조정 간격 업데이트

자동 크기 조정 수식 평가

자동 크기 조정 실행에 대한 정보 가져오기

풀 자동 크기 조정 이벤트를 사용하여 자동 크기 조정 실행 기록 가져오기

자동 크기 조정 수식 예제

예제1: 시간 기반 조정

예제2: 작업 기반 조정

예제3: 병렬 작업에 대한 회계

예제4: 초기 풀 크기 설정

다음 단계

추가 리소스