Skip to content

Latest commit

 

History

History
216 lines (163 loc) · 10.5 KB

resource-manager-deployment-operations.md

File metadata and controls

216 lines (163 loc) · 10.5 KB
title description services documentationcenter tags author manager editor ms.assetid ms.service ms.devlang ms.topic ms.tgt_pltfrm ms.workload ms.date ms.author
Deployment operations with Azure Resource Manager | Microsoft Docs
Describes how to view Azure Resource Manager deployment operations with the portal, PowerShell, Azure CLI, and REST API.
azure-resource-manager,virtual-machines
top-support-issue
tfitzmac
timlt
tysonn
azure-resource-manager
na
article
vm-multiple
infrastructure
01/13/2017
tomfitz

View deployment operations with Azure Resource Manager

You can view the operations for a deployment through the Azure portal. You may be most interested in viewing the operations when you have received an error during deployment so this article focuses on viewing operations that have failed. The portal provides an interface that enables you to easily find the errors and determine potential fixes.

[!INCLUDE resource-manager-troubleshoot-introduction]

Portal

To see the deployment operations, use the following steps:

  1. For the resource group involved in the deployment, notice the status of the last deployment. You can select this status to get more details.

    deployment status

  2. You see the recent deployment history. Select the deployment that failed.

    deployment status

  3. Select the link to see a description of why the deployment failed. In the image below, the DNS record is not unique.

    view failed deployment

    This error message should be enough for you to begin troubleshooting. However, if you need more details about which tasks were completed, you can view the operations as shown in the following steps.

  4. You can view all the deployment operations in the Deployment blade. Select any operation to see more details.

    view operations

    In this case, you see that the storage account, virtual network, and availability set were successfully created. The public IP address failed, and other resources were not attempted.

  5. You can view events for the deployment by selecting Events.

    view events

  6. You see all the events for the deployment and select any one for more details. Notice too the correlation IDs. This value can be helpful when working with technical support to troubleshoot a deployment.

    see events

PowerShell

  1. To get the overall status of a deployment, use the Get-AzureRmResourceGroupDeployment command.
Get-AzureRmResourceGroupDeployment -ResourceGroupName ExampleGroup

Or, you can filter the results for only those deployments that have failed.

Get-AzureRmResourceGroupDeployment -ResourceGroupName ExampleGroup | Where-Object ProvisioningState -eq Failed
  1. Each deployment includes multiple operations. Each operation represents a step in the deployment process. To discover what went wrong with a deployment, you usually need to see details about the deployment operations. You can see the status of the operations with Get-AzureRmResourceGroupDeploymentOperation.
Get-AzureRmResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName vmDeployment
Which returns multiple operations with each one in the following format:

Id             : /subscriptions/{guid}/resourceGroups/ExampleGroup/providers/Microsoft.Resources/deployments/Microsoft.Template/operations/A3EB2DA598E0A780
OperationId    : A3EB2DA598E0A780
Properties     : @{provisioningOperation=Create; provisioningState=Succeeded; timestamp=2016-06-14T21:55:15.0156208Z;
                 duration=PT23.0227078S; trackingId=11d376e8-5d6d-4da8-847e-6f23c6443fbf;
                 serviceRequestId=0196828d-8559-4bf6-b6b8-8b9057cb0e23; statusCode=OK; targetResource=}
PropertiesText : {duration:PT23.0227078S, provisioningOperation:Create, provisioningState:Succeeded,
                 serviceRequestId:0196828d-8559-4bf6-b6b8-8b9057cb0e23...}
  1. To get more details about failed operations, retrieve the properties for operations with Failed state.
(Get-AzureRmResourceGroupDeploymentOperation -DeploymentName Microsoft.Template -ResourceGroupName ExampleGroup).Properties | Where-Object ProvisioningState -eq Failed
Which returns all the failed operations with each one in the following format:

provisioningOperation : Create
provisioningState     : Failed
timestamp             : 2016-06-14T21:54:55.1468068Z
duration              : PT3.1449887S
trackingId            : f4ed72f8-4203-43dc-958a-15d041e8c233
serviceRequestId      : a426f689-5d5a-448d-a2f0-9784d14c900a
statusCode            : BadRequest
statusMessage         : @{error=}
targetResource        : @{id=/subscriptions/{guid}/resourceGroups/ExampleGroup/providers/
                        Microsoft.Network/publicIPAddresses/myPublicIP;
                        resourceType=Microsoft.Network/publicIPAddresses; resourceName=myPublicIP}
Note the serviceRequestId and the trackingId for the operation. The serviceRequestId can be helpful when working with technical support to troubleshoot a deployment. You will use the trackingId in the next step to focus on a particular operation.
  1. To get the status message of a particular failed operation, use the following command:
((Get-AzureRmResourceGroupDeploymentOperation -DeploymentName Microsoft.Template -ResourceGroupName ExampleGroup).Properties | Where-Object trackingId -eq f4ed72f8-4203-43dc-958a-15d041e8c233).StatusMessage.error
Which returns:

code           message                                                                        details
----           -------                                                                        -------
DnsRecordInUse DNS record dns.westus.cloudapp.azure.com is already used by another public IP. {}
  1. Every deployment operation in Azure includes request and response content. The request content is what you sent to Azure during deployment (for example, create a VM, OS disk, and other resources). The response content is what Azure sent back from your deployment request. During deployment, you can use DeploymentDebugLogLevel paramenter to specify that the request and/or response are retained in the log.

You get that information from the log, and save it locally by using the following PowerShell commands:

(Get-AzureRmResourceGroupDeploymentOperation -DeploymentName "TestDeployment" -ResourceGroupName "Test-RG").Properties.request | ConvertTo-Json |  Out-File -FilePath <PathToFile>

(Get-AzureRmResourceGroupDeploymentOperation -DeploymentName "TestDeployment" -ResourceGroupName "Test-RG").Properties.response | ConvertTo-Json |  Out-File -FilePath <PathToFile>

Azure CLI

  1. Get the overall status of a deployment with the azure group deployment show command.
azure group deployment show --resource-group ExampleGroup --name ExampleDeployment --json

One of the returned values is the correlationId. This value is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.

"properties": {
  "provisioningState": "Failed",
  "correlationId": "4002062a-a506-4b5e-aaba-4147036b771a",
  1. To see the operations for a deployment, use:
azure group deployment operation list --resource-group ExampleGroup --name ExampleDeployment --json

REST

  1. Get information about a deployment with the Get information about a template deployment operation.
GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}
In the response, note in particular the **provisioningState**, **correlationId**, and **error** elements. The **correlationId** is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.

{ 
  ...
  "properties": {
    "provisioningState":"Failed",
    "correlationId":"d5062e45-6e9f-4fd3-a0a0-6b2c56b15757",
    ...
    "error":{
      "code":"DeploymentFailed","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see http://aka.ms/arm-debug for usage details.",
      "details":[{"code":"Conflict","message":"{\r\n  \"error\": {\r\n    \"message\": \"Conflict\",\r\n    \"code\": \"Conflict\"\r\n  }\r\n}"}]
    }  
  }
}
  1. Get information about deployment operations with the List all template deployment operations operation.
GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}/operations?$skiptoken={skiptoken}&api-version={api-version}
The response includes request and/or response information based on what you specified in the **debugSetting** property during deployment.

{
  ...
  "properties": 
  {
    ...
    "request":{
      "content":{
        "location":"West US",
        "properties":{
          "accountType": "Standard_LRS"
        }
      }
    },
    "response":{
      "content":{
        "error":{
          "message":"Conflict","code":"Conflict"
        }
      }
    }
  }
}

Next steps