Skip to content

Commit 04d8fb2

Browse files
committed
Update Batch docs
1 parent 8c9f822 commit 04d8fb2

File tree

2 files changed

+9
-4
lines changed

2 files changed

+9
-4
lines changed

articles/batch/batch-automatic-scaling.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Autoscale compute nodes in an Azure Batch pool
33
description: Enable automatic scaling on an Azure Batch cloud pool to dynamically adjust the number of compute nodes in the pool.
44
ms.topic: how-to
5-
ms.date: 02/29/2024
5+
ms.date: 04/02/2024
66
ms.custom: H1Hack27Feb2017, fasttrack-edit, devx-track-csharp
77
---
88

@@ -239,7 +239,7 @@ You can use both resource and task metrics when you define a formula. You adjust
239239

240240
| Metric | Description |
241241
|----------|--------------|
242-
| Resource | Resource metrics are based on the CPU, the bandwidth, the memory usage of compute nodes, and the number of nodes.<br><br>These service-defined variables are useful for making adjustments based on node count:<br>- $TargetDedicatedNodes <br>- $TargetLowPriorityNodes <br>- $CurrentDedicatedNodes <br>- $CurrentLowPriorityNodes <br>- $PreemptedNodeCount <br>- $SampleNodeCount <br><br>These service-defined variables are useful for making adjustments based on node resource usage: <br>- $CPUPercent <br>- $WallClockSeconds <br>- $MemoryBytes <br>- $DiskBytes <br>- $DiskReadBytes <br>- $DiskWriteBytes <br>- $DiskReadOps <br>- $DiskWriteOps <br>- $NetworkInBytes <br>- $NetworkOutBytes |
242+
| Resource | Resource metrics are based on the CPU, the bandwidth, the memory usage of compute nodes, and the number of nodes.<br><br>These service-defined variables are useful for making adjustments based on node count:<br>- $TargetDedicatedNodes <br>- $TargetLowPriorityNodes <br>- $CurrentDedicatedNodes <br>- $CurrentLowPriorityNodes <br>- $PreemptedNodeCount <br>- $UsableNodeCount <br><br>These service-defined variables are useful for making adjustments based on node resource usage: <br>- $CPUPercent <br>- $WallClockSeconds <br>- $MemoryBytes <br>- $DiskBytes <br>- $DiskReadBytes <br>- $DiskWriteBytes <br>- $DiskReadOps <br>- $DiskWriteOps <br>- $NetworkInBytes <br>- $NetworkOutBytes |
243243
| Task | Task metrics are based on the status of tasks, such as Active, Pending, and Completed. The following service-defined variables are useful for making pool-size adjustments based on task metrics: <br>- $ActiveTasks <br>- $RunningTasks <br>- $PendingTasks <br>- $SucceededTasks <br>- $FailedTasks |
244244

245245
## Obtain sample data

articles/batch/best-practices.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Best practices
33
description: Learn best practices and useful tips for developing your Azure Batch solutions.
4-
ms.date: 02/29/2024
4+
ms.date: 04/02/2024
55
ms.topic: conceptual
66
---
77

@@ -144,6 +144,11 @@ A job doesn't automatically move to completed state unless explicitly terminated
144144

145145
There's a default [active job and job schedule quota](batch-quota-limit.md#resource-quotas). Jobs and job schedules in completed state don't count towards this quota.
146146

147+
Delete jobs when they're no longer needed, even if in completed state. Although completed jobs don't count towards
148+
active job quota, it's beneficial to periodically clean up completed jobs. For example,
149+
[listing jobs](/rest/api/batchservice/job/list) will be more efficient when the total number of jobs is a smaller
150+
set (even if proper filters are applied to the request).
151+
147152
## Tasks
148153

149154
[Tasks](jobs-and-tasks.md#tasks) are individual units of work that comprise a job. Tasks are submitted by the user and scheduled by Batch on to compute nodes. The following sections provide suggestions for designing your tasks to handle issues and perform efficiently.
@@ -167,7 +172,7 @@ Deleting tasks accomplishes two things:
167172
> For tasks just submitted to Batch, the DeleteTask API call takes up to 10 minutes to take effect. Before it takes effect,
168173
> other tasks might be prevented from being scheduled. It's because Batch Scheduler still tries to schedule the tasks just
169174
> deleted. If you wanted to delete one task shortly after it's submitted, please terminate the task instead (since the
170-
> terminate task will take effect immediately). And then delete the task 10 minutes later.
175+
> terminate task request will take effect immediately). And then delete the task 10 minutes later.
171176
172177
### Submit large numbers of tasks in collection
173178

0 commit comments

Comments
 (0)