Skip to content

Commit aa57f14

Browse files
authored
Merge pull request #188555 from Heidilohr/work-autoscale-glossary
Work autoscale glossary
2 parents 582869d + 71b12b4 commit aa57f14

File tree

6 files changed

+120
-2
lines changed

6 files changed

+120
-2
lines changed

articles/virtual-desktop/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -201,6 +201,8 @@
201201
href: autoscale-new-existing-host-pool.md
202202
- name: Autoscale diagnostics (preview)
203203
href: autoscale-diagnostics.md
204+
- name: Autoscale glossary (preview)
205+
href: autoscale-glossary.md
204206
- name: Autoscale feature FAQ (preview)
205207
href: autoscale-faq.yml
206208
- name: Customize feed

articles/virtual-desktop/autoscale-diagnostics.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,3 +84,5 @@ The following JSON file is an example of what you'll see when you open a report:
8484

8585
- Review how to create a scaling plan at [Autoscale for Azure Virtual Desktop session hosts](autoscale-scaling-plan.md).
8686
- [Assign your scaling plan to new or existing host pools](autoscale-new-existing-host-pool.md).
87+
- Learn more about terms used in this article at our [autoscale glossary](autoscale-glossary.md).
88+
- View our [autoscale FAQ](autoscale-faq.yml) to answer commonly asked questions.

articles/virtual-desktop/autoscale-faq.yml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ metadata:
44
description: Frequently asked questions and best practices for Azure Virtual Desktop.
55
author: Heidilohr
66
ms.topic: faq
7-
ms.date: 12/03/2021
7+
ms.date: 02/25/2022
88
ms.author: helohr
99
ms.custom: devx-track-azurepowershell
1010
manager: femila
@@ -79,3 +79,8 @@ sections:
7979
How many VMs need to be in a host pool for the autoscale feature to work properly?
8080
answer: |
8181
At least one.
82+
83+
- question: |
84+
Why would I want to configure the load balancing algorithm differently during different phases of the scaling plan schedule?
85+
answer: |
86+
When you set up your scaling plan schedule, you can specify different load balancing algorithms for different phases of the day. For example, during the ramp-up and peak phases, you can use the breadth-first load balancing algorithm. This algorithm will ensure you have an even distribution of user sessions during the first two phases of the day, which will optimize performance. Likewise, during the ramp-down and off-peak phases, you can use the depth-first load balancing algorithm to help the autsocale feature consolidate user sessions until it reaches the minimal possible number of session hosts in the host pool.
Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
---
2+
title: Azure Virtual Desktop autoscale (preview) glossary - Azure
3+
description: A glossary of terms and concepts for the Azure Virtual Desktop autoscale (preview) feature.
4+
services: virtual-desktop
5+
author: Heidilohr
6+
7+
ms.service: virtual-desktop
8+
ms.topic: conceptual
9+
ms.date: 02/25/2022
10+
ms.author: helohr
11+
manager: femila
12+
---
13+
# Autoscale (preview) glossary
14+
15+
This article is a list of definitions for key terms and concepts related to the autoscale (preview) feature for Azure Virtual Desktop.
16+
17+
## Autoscale
18+
19+
The autoscale feature is Azure Virtual Desktop’s native scaling service that turns VMs on and off based on the number of sessions on the session hosts in the host pool and which phase of the [scaling plan](#scaling-plan) [schedule](#schedule) the workday is in.
20+
21+
## Scaling tool
22+
23+
Azure Virtual Desktop’s scaling tool uses Azure Automation and Azure Logic Apps to scale the VMs in a host pool based on how many user sessions per CPU core there are during peak and off-peak hours.
24+
25+
## Scaling plan
26+
27+
A scaling plan is an Azure Virtual Desktop Azure Resource Manager object that defines the schedules for scaling session hosts in a host pool. You can assign one scaling plan to multiple host pools. Each host pool can only have one scaling plan assigned to it.
28+
29+
## Schedule
30+
31+
Schedules are sub-resources of [scaling plans](#scaling-plan) that specify the start time, capacity threshold, minimum percentage of hosts, load-balancing algorithm, and other configuration settings for the different phases of the day.
32+
33+
## Ramp up
34+
35+
The ramp-up phase of a [scaling plan](#scaling-plan) [schedule](#schedule) is usually at the beginning of the work day, when users start to sign in and start their sessions. In this phase, the number of [active user sessions](#active-user-session) usually increases at a rapid pace without reaching the maximum number of active sessions for the day yet.
36+
37+
## Peak
38+
39+
The peak phase of a [scaling plan](#scaling-plan) [schedule](#schedule) is when your host pool reaches the maximum number of [active user sessions](#active-user-session) for the day. In this phase, the number of active sessions usually holds steady until the peak phase ends. New active user sessions can be established during this phase, but usually at a slower rate than the ramp-up phase.
40+
41+
## Ramp down
42+
43+
The ramp-down phase of a [scaling plan](#scaling-plan) [schedule](#schedule) is usually at the end of the work day, when users start to sign out and end their sessions for the evening. In this phase, the number of [active user sessions](#active-user-session) usually decreases rapidly.
44+
45+
## Off-peak
46+
47+
The off-peak phase of the [scaling plan](#scaling-plan) [schedule](#schedule) is when the host pool usually reaches the minimum number of [active user sessions](#active-user-session) for the day. During this phase, there aren't usually many active users, but you can keep a small amount of resources on to accommodate users who work after the peak and ramp-down phases.
48+
49+
## Available session host
50+
51+
Available session hosts are session hosts that have passed all Azure Virtual Desktop agent health checks and have VM objects that are powered on, making them available for users to start their user sessions on.
52+
53+
## Capacity threshold
54+
55+
The capacity threshold is the percentage of a [host pool's capacity](#available-host-pool-capacity) that, when reached, triggers a [scaling action](#scaling-action) to happen.
56+
57+
For example:
58+
59+
- If the [used host pool capacity](#used-host-pool-capacity) is below the capacity threshold and the autoscale feature can turn off virtual machines (VMs) without going over the capacity threshold, then the feature will turn the VMs off.
60+
- If the used host pool capacity goes over the capacity threshold, then the autoscale feature will turn more VMs on until the used host pool capacity goes below the capacity threshold.
61+
62+
## Available host pool capacity
63+
64+
Available host pool capacity is how many user sessions a host pool can host based on the number of [available session hosts](#available-session-host). The available host pool capacity is the host pool's maximum session limit multiplied by the number of [available session hosts](#available-session-host) in the host pool.
65+
66+
In other words:
67+
68+
Host pool maximum session limit × number of available session hosts = available host pool capacity.
69+
70+
## Used host pool capacity
71+
72+
The used host pool capacity is the amount of [host pool capacity](#available-host-pool-capacity) that's currently taken up by active and disconnected user sessions.
73+
74+
In other words:
75+
76+
The number of [active](#active-user-session) and [disconnected user sessions](#disconnected-user-session) ÷ [the host pool capacity](#available-host-pool-capacity) = used host pool capacity.
77+
78+
## Scaling action
79+
80+
Scaling actions are when [the autoscale feature](#autoscale) turns VMs on or off.
81+
82+
## Minimum percentage of hosts
83+
84+
The minimum percentage of hosts is the lowest percentage of all session hosts in the host pool that must be turned on for each phase of the [scaling plan](#scaling-plan) [schedule](#schedule).
85+
86+
## Active user session
87+
88+
A user session is considered "active" when the user signs in and connects to their remote app or desktop resource.
89+
90+
## Disconnected user session
91+
92+
A disconnected user session is an inactive session that the user hasn't signed out of yet. When a user closes the remote session window without signing out, the session becomes disconnected. When a user reconnects to their remote resources, they'll be redirected to their disconnected session on the session host they were working on. At this point, the disconnected session becomes an [active session](#active-user-session) again.
93+
94+
## Force logoff
95+
96+
A force logoff, or forced sign-out, is when the service ends an [active user session](#active-user-session) or a [disconnected user session](#disconnected-user-session) without the user's consent.
97+
98+
## Exclusion tag
99+
100+
An exclusion tag is a property of a [scaling plan](#scaling-plan) that's a tag name you can apply to VMs that you want to exclude from [scaling actions](#scaling-action). [The autoscale feature](#autoscale) only performs scaling actions on VMs without tag names that match the exclusion tag.
101+
102+
## Next steps
103+
104+
- For more information about the autoscale feature, see the [autoscale feature document](autoscale-scaling-plan.md).
105+
- For more information about the scaling script, see the [scaling script document](set-up-scaling-script.md).

articles/virtual-desktop/autoscale-new-existing-host-pool.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,6 @@ To edit an existing scaling plan:
5454
## Next steps
5555

5656
- Review how to create a scaling plan at [Autoscale (preview) for Azure Virtual Desktop session hosts](autoscale-new-existing-host-pool.md).
57-
- Learn how to troubleshoot your scaling plan at [Enable diagnostics for your scaling plan](autoscale-diagnostics.md).
57+
- Learn how to troubleshoot your scaling plan at [Enable diagnostics for your scaling plan](autoscale-diagnostics.md).
58+
- Learn more about terms used in this article at our [autoscale glossary](autoscale-glossary.md).
59+
- View our [autoscale FAQ](autoscale-faq.yml) to answer commonly asked questions.

articles/virtual-desktop/autoscale-scaling-plan.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -263,3 +263,5 @@ Now that you've created your scaling plan, here are some things you can do:
263263
264264
- [Assign your scaling plan to new and existing host pools](autoscale-new-existing-host-pool.md)
265265
- [Enable diagnostics for your scaling plan](autoscale-diagnostics.md)
266+
267+
If you'd like to learn more about terms used in this article, check out our [autoscale glossary](autoscale-glossary.md). You can also look at our [autoscale FAQ](autoscale-faq.yml) if you have additional questions.

0 commit comments

Comments
 (0)