review cost management article

Author: EMaher

articles/lab-services/cost-management-guide.md

@@ -3,7 +3,7 @@ title: Cost management guide for Azure Lab Services
 description: Understand the different ways to view costs for Lab Services.
 author: rbest
 ms.author: rbest
-ms.date: 08/16/2020
+ms.date: 02/03/2022
 ms.topic: how-to
 ---
 
@@ -13,66 +13,68 @@ For Azure Lab Services, cost management can be broken down into two distinct are
 
 ## Estimate the lab costs
 
-Each lab dashboard has a **Costs & Billing** section that lays out a rough estimate of what the lab will cost for the month. The cost estimate summarizes the hour usage with the maximum number of users by the estimated cost per hour. To get the most accurate estimate, set up the lab, including the [schedule](how-to-create-schedules.md). The dashboard will reflect the estimated cost.
+Each lab dashboard has a **Costs & Billing** section that lays out a rough estimate of what the lab will cost for the lab. The estimate uses the number [schedules](classroom-labs-concepts.md#schedules), [quota hours](classroom-labs-concepts.md#quota), [extra quota for individual students](how-to-configure-student-usage.md#set-additional-quotas-for-specific-users), and [lab capacity](how-to-manage-vm-pool.md#set-lab-capacity).  when calculating the cost estimate.  Changing the number of quota hours, schedules or lab capacity will affect the cost estimate value.
 
 This estimate might not show all the possible costs. A few resources aren't included:
 
-- The template preparation cost. It can vary significantly in the amount of time needed to create the template. The cost to run the template is the same as the overall lab cost per hour.
-- Any [compute gallery](how-to-use-shared-image-gallery.md) costs, because a gallery can be shared among multiple labs.
-- Hours incurred when the lab creator starts a virtual machine (VM).
+- The [template VM preparation](how-to-create-manage-template.md#update-a-template-vm) cost. It can vary significantly in the amount of time needed to create the template. The cost to run the template is the same as running any lab VM.
+- Any [compute gallery](how-to-use-shared-image-gallery.md) costs. Compute galleries can be shared among multiple labs.
+- Cost incurred when the lab creator starts a virtual machine (VM).
 - Networking costs if the lab is using [advanced networking](how-to-connect-vnet-injection.md).
 
-> [!div class="mx-imgBorder"]
-> ![Screenshot that shows the dashboard cost estimate.](./media/cost-management-guide/dashboard-cost-estimation.png)
+:::image type="content" source="./media/cost-management-guide/dashboard-cost-estimation.png" alt-text="Screenshot that shows the dashboard cost estimate in Azure Lab Services.":::
 
-## Analyze the previous month's usage
+## Cost analysis
 
-The cost analysis is for reviewing the previous month's usage to help you determine any adjustments for the lab. You can find the breakdown of past costs in the [subscription cost analysis](../cost-management-billing/costs/quick-acm-cost-analysis.md). In the Azure portal, you can enter **Subscriptions** in the search box and then select the **Subscriptions** option.
+The cost analysis is for reviewing the previous month's usage to help you determine any adjustments you need to make for a lab. You can find the breakdown of past costs in the [subscription cost analysis](../cost-management-billing/costs/quick-acm-cost-analysis.md). 
 
-> [!div class="mx-imgBorder"]
-> ![Screenshot that shows the search box and the Subscriptions option.](./media/cost-management-guide/subscription-search.png)
+1. In the [Azure portal](https://portal.azure.com), select **All services**.  Select **Cost management** from the quick access list or select **Cost management + billing** from the **General** category.
 
-Select the specific subscription that you want to review.
+    :::image type="content" source="./media/cost-management-guide/all-services-cost-management.png" alt-text="Screenshot that shows the All services page.  The Cost management icon and Cost manage plus billing icon are highlighted.":::
+1. Select the **Subscription** page and select subscription you wish to analyze.
 
-> [!div class="mx-imgBorder"]
-> ![Screenshot that shows subscription selection.](./media/cost-management-guide/subscription-select.png)
+    :::image type="content" source="./media/cost-management-guide/subscription-select.png" alt-text="Screenshot that shows the Subscriptions page in Cost Management + Billing.  The Subscriptions menu is highlighted.":::
 
-Select **Cost Analysis** in the left pane under **Cost Management**.
+1. Select **Cost analysis** in the left pane under the **Cost management** heading.
 
-> [!div class="mx-imgBorder"]
-> ![Screenshot that shows a subscription cost analysis on a graph.](./media/cost-management-guide/subscription-cost-analysis.png)
+    :::image type="content" source="./media/cost-management-guide/subscription-cost-analysis.png" alt-text="Screenshot that shows a subscription cost analysis on a graph.":::
 
-This dashboard allows in-depth cost analysis, including the ability to export to different file types on a schedule. For more information, see [Cost Management + Billing overview](../cost-management-billing/cost-management-billing-overview.md).
+The Cost analysis dashboard allows in-depth cost analysis, including the ability to export to different file types on a schedule. For more information, see [Cost Management + Billing overview](../cost-management-billing/cost-management-billing-overview.md).
 
-You can filter by resource type. Using `microsoft.labservices/labaccounts` will show only the cost associated with Lab Services.
+You can filter by service or resource type. To see only costs associated with Azure Lab Services, set the add **service name** filter equal to **azure lab services**.  If using filter on resource type, include `Microsoft.Labservices/labaccounts` resource type.  If using the [January 2022 Update (preview)](lab-services-whats-new.md), also include the `Microsoft.LabServices/labs` resource type.
 
-## Understand the usage
+### Understand the entries
 
-The following screenshot is an example of a cost analysis.
+Changing the view on **Cost Analysis** page to **Cost by resource** shows the individual charges.  By default, there are six columns: **Resource**, **Resource type**, **Location**, **Resource group name**, **Tags**, and **Cost**.   The **Resource** column contains the information about the lab plan, lab name, and VM. If the cost is associated with a template VM, the resource will be in the form `{lab account}/{lab name}/default`.  If the cost is associated with a student lab VM, the resource will be in the form `{lab account}/{lab name}/default/{vm name}`.
 
-> [!div class="mx-imgBorder"]
-> ![Screenshot that shows an example cost analysis for a subscription.](./media/cost-management-guide/cost-analysis.png)
+In this example, adding the first and second rows (both start with **aaalab / dockerlab**) will give you the total cost for the lab "dockerlab" in the "aaalab" lab account or lab plan.
 
-By default, there are six columns: **Resource**, **Resource type**, **Location**, **Resource group name**, **Tags**, and **Cost**. The **Resource** column contains the information about the lab plan, lab name, and VM. The rows that show the lab plan, lab name, and default (second and third rows) are the cost for the lab. The used VMs have a cost that you can see for the rows that show the lab plan, lab name, default, and VM name.
+:::image type="content" source="./media/cost-management-guide/cost-analysis.png" alt-text="Screenshot that shows an example cost analysis for a subscription for Azure Lab Services associated costs.":::
 
-In this example, adding the first and second rows (both start with **aaalab / dockerlab**) will give you the total cost for the lab "dockerlab" in the "aaalab" lab account or lab plan.
+If you're using the [January 2022 Update (preview)](lab-services-whats-new.md) namespace, the entries in are formatted differently.  The **Resource** column will show entries in the form `{lab name}/{number}` for Azure Lab Services. Entries are automatically tagged with:
+
+- ms-istemplate.  Set to true if cost associated with a template VM in a lab.  Set to false, otherwise.
+- ms-labname: Name of the lab
+- ms-labplanid: Full resource ID of the lab plan used when creating the lab.
+
+:::image type="content" source="./media/cost-management-guide/cost-analysis-2.png" alt-text="Screenshot that shows an example cost analysis for a subscription using January 2022 Update for Azure Lab Services associated costs.":::
 
-To get the overall cost for the image gallery, change the resource type to `Microsoft.Compute/Galleries`. A compute gallery might not show up in the costs, depending on where the gallery is stored.
+To get the cost for the entire lab, don't forget to include external resources.  Azure Compute Gallery related charges are under the `Microsoft.Compute` namespace.  The advanced networking charges are under the `Microsoft.Network` namespace.
 
 > [!NOTE]
-> An Azure Compute Gallery is connected to the lab plan. That means multiple labs can use the same image.
+> An Azure Compute Gallery and virtual network can be connected to multiple labs.
 
-## Separate the costs
+### Separate the costs
 
 Since cost entries are tied to the lab account, some schools use the lab account and the resource group as ways to separate the classes. Each class has its own lab plan and resource group.
 
-In the cost analysis pane, add a filter based on the resource group name with the appropriate resource group name for the class. Then, only the costs for that class will be visible. This allows a clearer delineation between the classes when you're viewing the costs. You can use the [scheduled export](../cost-management-billing/costs/tutorial-export-acm-data.md) feature of the cost analysis to download the costs of each class in separate files.
+In the cost analysis pane, add a filter based on the resource group name for the class. Then, only the costs for that class will be visible. Grouping by resource group allows a clearer delineation between the classes when you're viewing the costs. You can use the [scheduled export](../cost-management-billing/costs/tutorial-export-acm-data.md) feature of the cost analysis to download the costs of each class in separate files.
 
 In the [January 2022 Update (preview)](lab-services-whats-new.md):
 
 - Cost entries are tied to a lab VM, *not* the lab plan.  
 - Cost entries get tagged with the name of the lab the VM is tied to. You can filter by the lab name tag to view total cost across VM in that lab.
-- Cost entries get tagged with the id of the lab plan used for the creation of the lab tied to the VM. You can filter by the lab plan tag to view total cost across labs created from a lab plan.
+- Cost entries get tagged with the ID of the lab plan when creating the lab. You can filter by the lab plan tag to view total cost across labs created from a lab plan.
 - You can set custom tags on labs or resource groups containing the labs to organize and analyze cost.
 
 ## Manage costs
@@ -87,13 +89,13 @@ Automatic shutdown features enable you to prevent wasted VM usage hours in the l
 
 [Schedules](classroom-labs-concepts.md#schedules) and [Quota](classroom-labs-concepts.md#quota) are two ways of allowing access to the lab VMs.
 
-In the schedule, you can add a stop-only event type that will stop all machines at a specific time. Some lab owners have set a stop-only event for every day at midnight to reduce the cost and quota usage when a student forgets to shut down the VM they're using. The downside to this type of event is that all VMs will be shut down, even if a student is using a VM.
+In the schedule, you can add a stop-only event type that will stop all machines at a specific time. Some lab owners have set a stop-only event for every day at midnight to reduce the cost and quota usage. The downside to this type of event is that all VMs will be shut down, even if a student is using a VM.
 
 ### Other costs related to labs
 
-Some costs aren't rolled into Lab Services but can be tied to a lab service. You can connect a compute gallery to a lab, but it won't show under the Lab Services costs and does have costs. To help keep overall costs down, you should remove any unused images from the gallery because the images have an inherent storage cost.
+Some costs aren't rolled into Lab Services but can be tied to a lab service. You can [connect a compute gallery](how-to-attach-detach-shared-image-gallery.md) to a lab, but it won't show under the Lab Services costs and does have costs. To help keep overall costs down, you should remove any unused images from the gallery because the images have associated storage costs.
 
-Labs can have connections to other Azure resources through a virtual network. When a lab is removed, you should remove the virtual network and the other resources.
+Labs can have connections to other Azure resources through a virtual network is using [advanced networking](how-to-connect-vnet-injection.md). When a lab is removed, you should remove the virtual network and the other resources.
 
 ## Conclusion