Просмотр журнала развертываний с помощью Azure Resource Manager

Статья
03/20/2024

Azure Resource Manager позволяет просматривать ваш журнал развертывания. Вы можете изучить определенные операции в прошлых развертываниях и просмотреть данные о развернутых ресурсах. Этот журнал также содержит сведения об ошибках.

Журнал развертывания для группы ресурсов ограничен 800 развертываниями. Развертывания автоматически удаляются из журнала, когда вы приближаетесь к ограничению. См. статью Автоматическое удаление из журнала развертывания.

Справку по устранению конкретных ошибок развертывания см. в статье Устранение распространенных ошибок развертывания Azure.

Идентификатор корреляции и поддержка

Каждое развертывание имеет идентификатор корреляции, который используется для отслеживания связанных событий. При создании запроса на поддержку Azureслужба поддержки Azure может запросить идентификатор корреляции. Служба поддержки использует идентификатор корреляции для идентификации операций на предмет неудачного развертывания.

Примеры в этой статье показывают, как получить идентификатор корреляции.

Развертывания групп ресурсов

Вы можете изучить сведения о развертывании группы ресурсов с помощью портала Azure, PowerShell, Azure CLI или REST API.

Выберите группу ресурсов, которую хотите изучить.
Щелкните ссылку в разделе Развертывания.
Выберите нужное развертывание из журнала развертывания.
Отобразится сводка по развертыванию, где есть и идентификатор корреляции.

Список всех развертываний для группы ресурсов можно получить с помощью команды Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Чтобы получить сведения о конкретном развертывании из группы ресурсов, добавьте параметр DeploymentName.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

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

Список всех развертываний для группы ресурсов можно получить с помощью команды az deployment group list.

az deployment group list --resource-group ExampleGroup

Чтобы получить сведения о конкретном развертывании, используйте az deployment group show.

az deployment group show --resource-group ExampleGroup --name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

az deployment group show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId

Список всех развертываний для группы ресурсов можно получить с помощью следующей операции. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Развертывания: вывод списка по группе ресурсов.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}

Чтобы получить конкретное развертывание, используйте приведенную ниже операцию. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Развертывания: получение.

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}

В ответе будет указан идентификатор корреляции.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Развертывания подписок

Вы можете просмотреть журнал развертываний по подписке.

Выберите подписку, которую нужно просмотреть.
В области слева выберите Развертывания.
Выберите нужное развертывание из журнала развертывания.
Отобразится сводка по развертыванию, где есть и идентификатор корреляции.

Чтобы перечислить все развертывания для текущей подписки, воспользуйтесь командой Get-AzSubscriptionDeployment. Эта команда эквивалентна использованию командлета Get-AzDeployment.

Get-AzSubscriptionDeployment

Чтобы получить сведения о конкретном развертывании из подписки, добавьте параметр Name.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Для получения списка всех развертываний для текущей подписки используйте az deployment sub list.

az deployment sub list

Чтобы получить сведения о конкретном развертывании, используйте az deployment sub show.

az deployment sub show --name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

az deployment sub show --name ExampleDeployment --query properties.correlationId

Список всех развертываний для подписки можно получить с помощью приведенной ниже операции. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Развертывания: вывод списка для подписки.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

В ответе будет указан идентификатор корреляции.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Развертывания групп управления

Вы можете просмотреть журнал развертываний для группы управления.

Выберите группу управления, которую нужно изучить. Если у вас недостаточно разрешений для просмотра сведений о группе управления, вы не сможете выбрать ее.
В области слева выберите Развертывания.
Выберите нужное развертывание из журнала развертывания.
Отобразится сводка по развертыванию, где есть и идентификатор корреляции.

Список всех развертываний для группы управления можно получить с помощью командлета Get-AzManagementGroupDeployment. Если у вас недостаточно разрешений для просмотра развертываний для группы управления, вы получите сообщение об ошибке.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Чтобы получить сведения о конкретном развертывании из группы ресурсов, добавьте параметр Name.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

(Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment).CorrelationId

Список всех развертываний для группы управления можно получить с помощью команды az deployment mg list. Если у вас недостаточно разрешений для просмотра развертываний для группы управления, вы получите сообщение об ошибке.

az deployment mg list --management-group-id examplemg

Чтобы получить сведения о конкретном развертывании, используйте az deployment mg show.

az deployment mg show --management-group-id examplemg --name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

az deployment mg show --management-group-id examplemg --name ExampleDeployment --query properties.correlationId

Список всех развертываний для группы управления можно получить с помощью приведенной ниже операции. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Развертывания: вывод списка для группы управления. Если у вас недостаточно разрешений для просмотра развертываний для группы управления, вы получите сообщение об ошибке.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

В ответе будет указан идентификатор корреляции.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Развертывания клиентов

Вы можете просмотреть журнал развертываний по арендатору.

В настоящее время на портале нельзя просмотреть развертывания арендаторов.

Чтобы перечислить все развертывания для текущего арендатора, воспользуйтесь командлетом Get-AzTenantDeployment. Если у вас недостаточно разрешений для просмотра развертываний для арендатора, вы получите сообщение об ошибке.

Get-AzTenantDeployment

Чтобы получить сведения о текущем арендаторе из группы ресурсов, добавьте параметр Name.

Get-AzTenantDeployment -Name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Для получения списка всех развертываний для текущего арендатора используйте az deployment tenant list. Если у вас недостаточно разрешений для просмотра развертываний для арендатора, вы получите сообщение об ошибке.

az deployment tenant list

Чтобы получить сведения о конкретном развертывании, используйте az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Чтобы получить идентификатор корреляции, используйте:

az deployment tenant show --name ExampleDeployment --query properties.correlationId

Чтобы перечислить развертывания для текущего арендатора, используйте указанную ниже операцию. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Развертывания: вывод списка на уровне арендатора. Если у вас недостаточно разрешений для просмотра развертываний для арендатора, вы получите сообщение об ошибке.

GET https://management.azure.com/providers/Microsoft.Resources/deployments/?api-version={api-version}

GET https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

В ответе будет указан идентификатор корреляции.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Операции развертывания и сообщения об ошибке

Каждое развертывание может включать несколько операций. Чтобы больше узнать о развертывании, изучите его операции. При сбое развертывания в его операции будут включено сообщение об ошибке.

На странице сводных данных по развертыванию выберите Сведения об операции.
Вы увидите подробные сведения об этом шаге развертывания. Если возникла ошибка, сведения о ней будут включены в это сообщение.

Чтобы просмотреть сведения об операциях развертывания в группе ресурсов, используйте команду Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Для просмотра сведений о невыполненных операциях примените фильтр по состоянию Failed (Сбой).

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }

Чтобы получить сообщение о состоянии операций, завершившихся сбоем, используйте следующую команду:

(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }).StatusMessage

Чтобы просмотреть операции развертывания для других областей, используйте:

Чтобы просмотреть сведения об операциях для развертывания в группе ресурсов, используйте команду az deployment operation group list. Для этого нужно иметь Azure CLI 2.6.0 или более поздней версии.

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment

Для просмотра сведений о невыполненных операциях примените фильтр по состоянию Failed (Сбой).

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed']"

Чтобы получить сообщение о состоянии операций, завершившихся сбоем, используйте следующую команду:

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"

Чтобы просмотреть операции развертывания для других областей, используйте:

Для получения сведений об операциях развертывания выполните приведенную ниже операцию. Номер последней версии API, который нужно указать в запросе, можно узнать в статье Операции развертывания: список.

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}

Ответ содержит сообщение об ошибке.

{
  "value": [
    {
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/examplegroup/providers/Microsoft.Resources/deployments/exampledeployment/operations/1234567890ABCDEF",
      "operationId": "1234567890ABCDEF",
      "properties": {
        "provisioningOperation": "Create",
        "provisioningState": "Failed",
        "timestamp": "2019-11-26T14:18:36.3177613Z",
        "duration": "PT21.0580179S",
        "trackingId": "11111111-1111-1111-1111-111111111111",
        "serviceRequestId": "11111111-1111-1111-1111-111111111111",
        "statusCode": "BadRequest",
        "statusMessage": {
          "error": {
            "code": "InvalidAccountType",
            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
          }
        },
        "targetResource": {
          "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
          "resourceType": "Microsoft.Storage/storageAccounts",
          "resourceName": "storage"
        }
      }
    },
    ...
  ]
}

Чтобы просмотреть операции развертывания для других областей, используйте:

Дальнейшие действия

Справку по устранению конкретных ошибок развертывания см. в статье Устранение распространенных ошибок развертывания Azure.
Сведения о том, как управление развертываниями осуществляется в журнале, см. в разделе Автоматическое удаление из журнала развертывания.
Сведения о предварительном просмотре изменений перед развертыванием шаблона см. в статье Операция "что если" для развертывания шаблонов ARM.

Просмотр журнала развертываний с помощью Azure Resource Manager

Идентификатор корреляции и поддержка

Развертывания групп ресурсов

Развертывания подписок

Развертывания групп управления

Развертывания клиентов

Операции развертывания и сообщения об ошибке

Дальнейшие действия

Дополнительные ресурсы