Просмотр журнала развертывания с помощью Azure Resource ManagerView deployment history with Azure Resource Manager

Azure Resource Manager позволяет просматривать историю развертывания и проверки определенных операций в выполнении развертываний в прошлом.Azure Resource Manager enables you to view your deployment history and examine specific operations in past deployments. См. в ресурсах, которые были развернуты и получить сведения об ошибках.You can see the resources that were deployed, and get information about any errors.

Сведения об устранении некоторых ошибок развертывания см. в статье об устранении распространенных ошибок при развертывании ресурсов в Azure с помощью Azure Resource Manager.For help with resolving particular deployment errors, see Resolve common errors when deploying resources to Azure with Azure Resource Manager.

ПорталPortal

Чтобы получить сведения о развертывании из журнала развертывания.To get details about a deployment from the deployment history.

  1. Выберите группу ресурсов, которую вы хотите проанализировать.Select the resource group you want to examine.

  2. Щелкните ссылку под развертываний.Select the link under Deployments.

    Выбор журнала развертывания

  3. Выберите одно из развертываний из журнала развертывания.Select one of the deployments from the deployment history.

    Выберите развертывание

  4. Отображается сводка по развертыванию, включая список развернутых ресурсов.A summary of the deployment is displayed, including a list of the resources that were deployed.

    Сводка по развертыванию

  5. Чтобы просмотреть шаблон, используемый для развертывания, выберите шаблона.To view the template used for the deployment, select Template. Вы можете скачать шаблон для повторного использования.You can download the template to reuse it.

    Отображение шаблона

  6. Если произошел сбой развертывания, вы увидите сообщение об ошибке.If your deployment failed, you see an error message. Выберите сообщение об ошибке для получения дополнительных сведений.Select the error message for more details.

    Просмотр неудачного развертывания

  7. Подробное сообщение об ошибке отображается.The detailed error message is displayed.

    Просмотреть сведения об ошибке

  8. Идентификатор корреляции используется для отслеживания связанных событий и может быть полезным при работе с технической поддержкой для устранения проблемы развертывания.The correlation ID is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.

    Получить идентификатор корреляции

  9. Дополнительные сведения о шагах, в котором произошел сбой, выберите сведения об операции.To learn more about the step that failed, select Operation details.

    Выберите операции развертывания

  10. Отобразятся сведения для этого этапа развертывания.You see the details for that step of the deployment.

    Показать сведения об операции

PowerShellPowerShell

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Дополнительные сведения о совместимости модуля Az с AzureRM см. в статье Introducing the new Azure PowerShell Az module (Знакомство с новым модулем Az для Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Инструкции по установке модуля Az см. в статье об установке Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Общее состояние развернутой службы можно получить с помощью команды Get-AzResourceGroupDeployment.To get the overall status of a deployment, use the Get-AzResourceGroupDeployment command.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Вы можете отфильтровать результаты, чтобы отобразить только те развертывания, которые завершились сбоем.Or, you can filter the results for only those deployments that have failed.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup | Where-Object ProvisioningState -eq Failed

Идентификатор корреляции используется для отслеживания связанных событий и может быть полезным при работе с технической поддержкой для устранения проблемы развертывания.The correlation ID is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment. Чтобы получить идентификатор корреляции, используйте:To get the correlation ID, use:

(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName azuredeploy).CorrelationId

Каждое развертывание включает в себя несколько операций.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. Состояние операций можно просмотреть с помощью команды Get-AzResourceGroupDeploymentOperation.You can see the status of the operations with Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName azuredeploy

Эта команда возвращает несколько операций, каждая из которых представлена в следующем формате: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=2019-05-13T21:42:40.7151512Z;
                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...}

Чтобы получить дополнительные сведения о завершившихся сбоем операциях, получите свойства для операций с состоянием Failed .To get more details about failed operations, retrieve the properties for operations with Failed state.

(Get-AzResourceGroupDeploymentOperation -DeploymentName azuredeploy -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             : 2019-05-13T21:42:40.7151512Z
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}

Обратите внимание на значения serviceRequestId и trackingId операции.Note the serviceRequestId and the trackingId for the operation. serviceRequestId может быть полезным при работе с технической поддержкой для устранения проблемы развертывания.The serviceRequestId can be helpful when working with technical support to troubleshoot a deployment. TrackingId используется на следующем шаге сосредоточиться на конкретной операции.You'll use the trackingId in the next step to focus on a particular operation.

Чтобы получить сообщение о состоянии конкретной завершившейся сбоем операции, используйте следующую команду:To get the status message of a particular failed operation, use the following command:

((Get-AzResourceGroupDeploymentOperation -DeploymentName azuredeploy -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. {}

Каждая операция развертывания в Azure включает в себя содержимое запроса и ответа.Every deployment operation in Azure includes request and response content. Во время развертывания, можно использовать DeploymentDebugLogLevel параметр, чтобы указать, что вошли запроса или ответа.During deployment, you can use DeploymentDebugLogLevel parameter to specify that the request and/or response are logged.

Получить эту информацию из журнала и сохранить ее локально можно с помощью следующих команд PowerShell:You get that information from the log, and save it locally by using the following PowerShell commands:

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

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

Инфраструктура CLI AzureAzure CLI

Чтобы получить общее состояние развертывания, используйте azure группы развертывания show команды.To get the overall status of a deployment, use the azure group deployment show command.

az group deployment show -g ExampleGroup -n ExampleDeployment

Идентификатор корреляции используется для отслеживания связанных событий и может быть полезным при работе с технической поддержкой для устранения проблемы развертывания.The correlation ID is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.

az group deployment show -g ExampleGroup -n ExampleDeployment --query properties.correlationId

Чтобы просмотреть операции развертывания, используйте следующую команду:To see the operations for a deployment, use:

az group deployment operation list -g ExampleGroup -n ExampleDeployment

RESTREST

Чтобы получить сведения о развертывании, используйте получение сведений о шаблоне-развертывании операции.To get information about a deployment, use 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}

В ответе обратите особое внимание на элементы provisioningState, correlationId и error.In the response, note in particular the provisioningState, correlationId, and error elements. correlationId используется для отслеживания связанных событий и может быть полезен при взаимодействии со службой технической поддержки для устранения проблемы развертывания.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 https://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}"}]
   }  
 }
}

Чтобы получить сведения о развертываниях, используйте вывод списка всех операций развертывания шаблона.To get information about deployments, use List all template deployment operations.

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}

Ответ будет содержать сведения о запросе и (или) ответе, в зависимости от того, что было указано в свойстве debugSetting во время развертывания.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