Вопросы и ответы по отладке моментальных снимков в Visual Studio

Когда для выполнения моментальных снимков приложения используется Snapshot Debugger, он блокирует процесс приложения и приостанавливает ответвленную копию. При отладке моментального снимка вы выполняете отладку в ответвленной копии процесса. Это занимает 10–20 мс. Данный процесс не копирует полных сведений о приложении. Вместо этого он копирует только таблицу страниц и присваивает страницам атрибуты копирования при записи. Если некоторые объекты приложения, которые находятся в куче, будут изменены, то будут скопированы те страницы, которые им соответствуют. Таким образом, каждый из моментальных снимков занимает мало места в памяти (для большинства приложений этот размер соответствует порядка сотни килобайт).

При наличии нескольких экземпляров приложения точки моментальных снимков будут применены к каждому из них. А моментальный снимок будет создан только в той точке моментальных снимков, которая первой будет соответствовать всем условиям. Для создания последующих моментальных снимков при наличии нескольких точек моментальных снимков будет использоваться тот же экземпляр, из которого создавался первый моментальный снимок. Точки ведения журнала, отправленные в окно вывода, отобразят сообщения только для одного экземпляра, в то время как точки ведения журнала, отправленные в журналы приложений, отправят сообщения из каждого экземпляра.

Для работы расширения Snapshot Debugger требуются соответствующие символы приложения, которые должны быть развернуты в Службе приложений Azure или находиться на локальном компьютере. (Внедренные PDF-файлы в настоящее время не поддерживаются.) Отладчик моментальных снимков автоматически загружает символы из службы приложений Azure. Начиная с Visual Studio 2017 версии 15.2, при развертывании в Службе приложений Azure также будут развернуты символы вашего приложения.

Да. Snapshot Debugger предназначен для работы в сборках выпуска. Когда точка моментальных снимков помещается в функцию, она перекомпилируется до отладочной версии, что делает ее доступной для отладки. Остановка работы Snapshot Debugger приведет к возвращению функции к версии сборки выпуска.

Нет. Любые сообщения журнала, добавленные в приложение, оцениваются виртуально. Они не создают побочных эффектов в приложении. Тем не менее некоторые из их свойств могут быть недоступны при использовании точек ведения журнала.

Да, он может работать, когда сервер находится под нагрузкой. Snapshot Debugger выполняет проверку, и в ситуации, когда на сервере отсутствует свободная память, он не делает моментальных снимков.

Чтобы удалить расширение сайта Snapshot Debugger в Службе приложений, выполните следующие действия.

1. Отключите Службу приложений с помощью Cloud Explorer в Visual Studio или на портале Azure.
2. Последовательно перейдите к сайту Kudu Службы приложений (то есть yourappservice.scm.azurewebsites.net), а затем к пункту Расширения сайта.
3. Чтобы его удалить, в расширении сайта Snapshot Debugger нажмите кнопку со значком "X".

Чтобы выполнить отладку моментальных снимков, сделанных в Azure, расширению Snapshot Debugger необходимо открыть набор портов. Это те же порты, которые требуются для удаленной отладки. Список портов приведен в этой статье.

Для Служб приложений:

1. Отключите расширение удаленного отладчика с помощью портала Azure для вашей Службы приложений.
2. Портал Azure > ваша колонка ресурсов Службы приложений >Параметры приложения
3. Перейдите в раздел Отладка и нажмите кнопку Off (Выкл.) для удаленной отладки.

Для AKS:

1. Обновите Dockerfile, чтобы удалить разделы, соответствующие Visual Studio Snapshot Debugger в образах Docker.
2. Перестройте и повторно разверните измененный образ Docker.

Для виртуальных машин или масштабируемых наборов виртуальных машин удалите расширение удаленного отладчика, сертификаты, хранилища ключей KeyVault и пулы NAT для входящего трафика, как показано ниже.

1. Удаление расширения удаленного отладчика

   Существует несколько способов отключения удаленного отладчика для виртуальных машин и масштабируемых наборов виртуальных машин.

   • Отключение удаленного отладчика с помощью Cloud Explorer

     • Cloud Explorer > ваш ресурс виртуальных машин > Отключить отладку (отключение отладки для масштабируемого набора виртуальных машин в Cloud Explorer не существует).

   • Отключение удаленного отладчика с помощью скриптов и командлетов PowerShell

     Для виртуальной машины:

     Remove-AzVMExtension -ResourceGroupName $rgName -VMName $vmName -Name Microsoft.VisualStudio.Azure.RemoteDebug.VSRemoteDebugger
     

     Для масштабируемых наборов виртуальных машин:

     $vmss = Get-AzVmss -ResourceGroupName $rgName -VMScaleSetName $vmssName
     $extension = $vmss.VirtualMachineProfile.ExtensionProfile.Extensions | Where {$_.Name.StartsWith('VsDebuggerService')} | Select -ExpandProperty Name
     Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name $extension
     

   • Отключение удаленного отладчика на портале Azure

     • Портал Azure > ваша колонка ресурсов для виртуальных машин или масштабируемых наборов виртуальных машин > Расширения
     • Удаление расширения Microsoft.VisualStudio.Azure.RemoteDebug.VSRemoteDebugger

     Заметка

     Масштабируемые наборы виртуальных машин — на портале не разрешается удаление портов DebuggerListener. Необходимо использовать Azure PowerShell. Подробные сведения см. ниже.

2. Удаление сертификатов и Azure KeyVault

   При установке расширения удаленного отладчика для виртуальных машин или масштабируемых наборов виртуальных машин создаются сертификаты клиента и сервера для проверки подлинности клиента Visual Studio с помощью ресурсов виртуальных машин или масштабируемых наборов виртуальных машин Azure.

   • Сертификат клиента

     Это самозаверяющий сертификат, который находится в Cert:/CurrentUser/My/

     Thumbprint                                Subject
     ----------                                -------
     
     1234123412341234123412341234123412341234  CN=ResourceName
     

     Один из способов удаления этого сертификата с компьютера заключается в использовании PowerShell

     $ResourceName = 'ResourceName' # from above
     Get-ChildItem -Path Cert:\CurrentUser\My | Where-Object {$_.Subject -match $ResourceName} | Remove-Item
     

   • Сертификат сервера

     • Соответствующий отпечаток сертификата сервера развертывается в качестве секрета в Azure KeyVault. Visual Studio попытается найти или создать KeyVault с префиксом MSVSAZ* в регионе, соответствующем ресурсу виртуальной машины или масштабируемого набора виртуальных машин. Все ресурсы виртуальных машин или масштабируемых наборов виртуальных машин, развернутых в этом регионе, будут совместно использовать одно и то же хранилище KeyVault.
     • Чтобы удалить секрет отпечатка сертификата сервера, перейдите на портал Azure и найдите MSVSAZ* KeyVault в том регионе, в котором размещен ваш ресурс. Удалите секрет, который должен иметь метку remotedebugcert<<ResourceName>>
     • Кроме того, необходимо будет удалить секрет сервера из вашего ресурса с помощью PowerShell.

     Для виртуальных машин:

     $vm.OSProfile.Secrets[0].VaultCertificates.Clear()
     Update-AzVM -ResourceGroupName $rgName -VM $vm
     

     Для масштабируемых наборов виртуальных машин:

     $vmss.VirtualMachineProfile.OsProfile.Secrets[0].VaultCertificates.Clear()
     Update-AzVmss -ResourceGroupName $rgName -VMScaleSetName $vmssName -VirtualMachineScaleSet $vmss
     

3. Удаление всех пулов NAT для входящего трафика DebuggerListener (только для масштабируемых наборов виртуальных машин)

   Удаленный отладчик вводит пулы NAT для входящего трафика DebuggerListener, которые относятся к подсистеме балансировки нагрузки вашего масштабируемого набора.

   $inboundNatPools = $vmss.VirtualMachineProfile.NetworkProfile.NetworkInterfaceConfigurations.IpConfigurations.LoadBalancerInboundNatPools
   $inboundNatPools.RemoveAll({ param($pool) $pool.Id.Contains('inboundNatPools/DebuggerListenerNatPool-') }) | Out-Null
   
   if ($LoadBalancerName)
   {
      $lb = Get-AzLoadBalancer -ResourceGroupName $ResourceGroup -name $LoadBalancerName
      $lb.FrontendIpConfigurations[0].InboundNatPools.RemoveAll({ param($pool) $pool.Id.Contains('inboundNatPools/DebuggerListenerNatPool-') }) | Out-Null
      Set-AzLoadBalancer -LoadBalancer $lb
   }
   

Для Службы приложений:

1. Отключите Snapshot Debugger с помощью портала Azure для вашей Службы приложений.

2. Портал Azure > ваша колонка ресурсов Службы приложений >Параметры приложения

3. Удалите следующие параметры приложения на портале Azure и сохраните изменения.

   • INSTRUMENTATIONENGINE_EXTENSION_VERSION
   • SNAPSHOTDEBUGGER_EXTENSION_VERSION

   Предупреждение

   Любые изменения параметров приложения приведут к перезапуску приложения. Дополнительные сведения о параметрах приложения см. в разделе Настройка приложения Службы приложений на портале Azure.

Для AKS:

1. Обновите Dockerfile, чтобы удалить разделы, соответствующие Visual Studio Snapshot Debugger в образах Docker.
2. Перестройте и повторно разверните измененный образ Docker.

Для виртуальных машин и масштабируемых наборов виртуальных машин:

Существует несколько способов отключения Snapshot Debugger.

• Cloud Explorer > ваш ресурс виртуальной машины или масштабируемого набора виртуальных машин > Отключить диагностику

• Портал Azure > ваша колонка ресурсов виртуальной машины или масштабируемого набора виртуальных машин > Расширения > Удалить расширение Microsoft.Insights.VMDiagnosticsSettings

• Командлеты PowerShell из AZ PowerShell

  Виртуальная машина:

      Remove-AzVMExtension -ResourceGroupName $rgName -VMName $vmName -Name Microsoft.Insights.VMDiagnosticsSettings
  

  Масштабируемые наборы виртуальных машин:

      $vmss = Get-AzVmss -ResourceGroupName $rgName -VMScaleSetName $vmssName
      Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name Microsoft.Insights.VMDiagnosticsSettings
  

См. также

• Отладка в Visual Studio
• Отладка работающих приложений ASP.NET Azure с помощью Snapshot Debugger
• Отладка работающих приложений ASP.NET на Виртуальных машинах Azure и в Масштабируемых наборах виртуальных машин Azure с помощью Snapshot Debugger
• Отладка работающей службы Azure Kubernetes ASP.NET с помощью Snapshot Debugger
• Устранение неполадок и известные проблемы отладки моментальных снимков