Habilitar o log de depuração

Para solucionar um erro de implantação, ajuda a coletar mais informações. Use Azure PowerShell para habilitar o log de depuração. Você pode obter dados sobre a solicitação e a resposta de uma implantação para saber a causa do problema. O log de depuração funciona com Azure Resource Manager de dados (modelos ARM) e arquivos Bicep.

Informações de depuração do log

Use New-AzResourceGroupDeployment para definir o DeploymentDebugLogLevelparâmetro para All,ResponseContent ou RequestContent. Quando o log de depuração está habilitado, é exibido um aviso de que segredos como senhas ou listKeys podem ser registrados por comandos como Get-AzResourceGroupDeploymentOperation.

New-AzResourceGroupDeployment `
  -Name exampledeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile azuredeploy.json `
  -DeploymentDebugLogLevel All

A saída mostra o log de depuração:

DeploymentDebugLogLevel : RequestContent, ResponseContent

Para exibir todas as propriedades para operações de implantação:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Você pode especificar uma propriedade, como StatusMessage ou StatusCode, para filtrar a saída.

(Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup).StatusMessage

Modelo aninhado

Para registrar informações de depuração para um modelo do ARM aninhado, use o elemento Microsoft.Resources/deploymentsdebugSetting.

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2020-10-01",
  "name": "nestedTemplate",
  "properties": {
    "mode": "Incremental",
    "templateLink": {
      "uri": "{template-uri}",
      "contentVersion": "1.0.0.0"
    },
    "debugSetting": {
       "detailLevel": "requestContent, responseContent"
    }
  }
}

O Bicep usa módulos em vez de Microsoft.Resources/deployments. Com os módulos, você pode reutilizar seu código para implantar um arquivo Bicep de outro arquivo Bicep.

Próximas etapas