V tomto článku se dozvíte, jak spustit Profiler Application Insights pro .NET na virtuálním počítači Azure nebo škálovací sadě virtuálních počítačů Azure pomocí tří různých metod:
- Visual Studio a Azure Resource Manager
- PowerShell
- Azure Resource Explorer
Vyberte kartu upřednostňované metody pro:
V této příručce se naučíte:
- Přidejte do své aplikace sadu Application Insights SDK.
- Potvrďte nejnovější stabilní verzi sady Application Insights SDK.
- Povolte profiler .NET.
Poznámka:
V současné době není Profiler pro .NET v rámci Application Insights podporován pro lokální (on-premises) servery.
Požadavky
Funkční aplikace ASP.NET Core.
Služba Application Insights.
Pokud chcete zkontrolovat šablony Azure Resource Manageru (šablony ARM) pro rozšíření Azure Diagnostics:
Přidání sady Application Insights SDK do aplikace
Otevřete základní projekt ASP.NET v sadě Visual Studio.
Vyberte Project>Add Application Insights Telemetry.
Vyberte Azure Application Insights a pak vyberte Další.
Vyberte předplatné, ve kterém se nachází váš prostředek Application Insights, a pak vyberte Další.
Vyberte, kam chcete připojovací řetězec uložit, a pak vyberte Další.
Vyberte Dokončit.
Potvrzení nejnovější stabilní verze sady Application Insights SDK
Přejděte do Projekt>Spravovat balíčky NuGet.
Vyberte Microsoft.ApplicationInsights.AspNetCore.
V bočním podokně vyberte v rozevíracím seznamu nejnovější verzi sady SDK.
Vyberte Aktualizovat.
Povolení profileru .NET
Profiler můžete povolit těmito způsoby:
- V rámci aplikace ASP.NET Core pomocí šablony Azure Resource Manageru a sady Visual Studio.
Doporučený.
- Pomocí příkazu PowerShellu.
- Pomocí Azure Resource Exploreru.
Instalace rozšíření Azure Diagnostics
Vyberte šablonu ARM, kterou chcete použít:
V šabloně vyhledejte prostředek typu extension.
Ve Visual Studiu přejděte k souboru arm.json ve vaší aplikaci ASP.NET Core, který byl přidán při instalaci sady Application Insights SDK.
Přidejte typ extension prostředku ze šablony do arm.json souboru pro nastavení virtuálního počítače nebo škálovací sady virtuálních počítačů s Azure Diagnostics.
Do značky WadCfg přidejte připojovací řetězec Application Insights.MyApplicationInsightsProfilerSink
"WadCfg": {
"SinksConfig": {
"Sink": [
{
"name": "MyApplicationInsightsProfilerSink",
"ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
}
]
}
}
Nasaďte aplikaci.
Následující příkazy PowerShellu představují přístup pro stávající virtuální počítače, které se dotknou jenom rozšíření Azure Diagnostics.
Poznámka:
Pokud virtuální počítač nasadíte znovu, jímka se ztratí. Abyste toto nastavení zachovali, musíte aktualizovat konfiguraci, kterou používáte při nasazování virtuálního počítače.
Instalace Application Insights pomocí konfigurace Azure Diagnostics
Export aktuálně nasazené konfigurace diagnostiky Azure do souboru:
$ConfigFilePath = [IO.Path]::GetTempFileName()
Do konfigurace vrácené následujícím příkazem přidejte jímku profileru Application Insights:
(Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath
Profiler Application Insights WadCfg:
"WadCfg": {
"SinksConfig": {
"Sink": [
{
"name": "MyApplicationInsightsProfilerSink",
"ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
}
]
}
}
Spuštěním následujícího příkazu předejte aktualizované konfiguraci příkazu Set-AzVMDiagnosticsExtension .
Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
Poznámka:
Set-AzVMDiagnosticsExtension může argument -StorageAccountName vyžadovat. Pokud původní konfigurace diagnostiky měla storageAccountName vlastnost v protectedSettings části, která není ke stažení, nezapomeňte předat stejnou původní hodnotu, kterou jste měli v tomto volání rutiny.
Funkce trasování HTTP služby IIS
Pokud je zamýšlená aplikace spuštěná prostřednictvím služby IIS, povolte IIS Http Tracing funkci Windows:
Vytvořte vzdálený přístup k prostředí.
Použijte okno Přidat funkce systému Windows nebo jako správce spusťte v PowerShellu následující příkaz:
Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
Pokud je navazování vzdáleného přístupu problém, můžete pomocí Azure CLI spustit následující příkaz:
az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
Nasaďte aplikaci.
Nastavení jímky profileru pomocí Azure Resource Exploreru
Vzhledem k tomu, že Azure Portal neposkytuje způsob, jak nastavit profiler Application Insights pro jímku .NET, můžete k nastavení jímky použít Azure Resource Explorer .
Poznámka:
Pokud virtuální počítač nasadíte znovu, jímka se ztratí. Abyste toto nastavení zachovali, musíte aktualizovat konfiguraci, kterou používáte při nasazování virtuálního počítače.
Ověřte, že je nainstalované rozšíření Microsoft Azure Diagnostics. Zobrazí se rozšíření nainstalovaná pro váš virtuální počítač.
Vyhledejte rozšíření Diagnostiky virtuálních počítačů pro váš virtuální počítač:
Přejděte do Azure Resource Exploreru.
Rozbalte předplatná a vyhledejte předplatné, které obsahuje skupinu prostředků s vaším virtuálním počítačem.
Výběrem skupiny prostředků přejděte k podrobnostem rozšíření virtuálních počítačů. Pak vyberte Microsoft.Compute>virtualMachines>[váš virtuální počítač]>rozšíření.
Přidejte profiler Application Insights pro jímku .NET do SinksConfig uzlu v části WadCfg. Pokud ještě SinksConfig oddíl nemáte, možná ho budete muset přidat. Přidání jímky:
Ve svých nastaveních zadejte správný iKey pro Application Insights.
V pravém horním rohu přepněte režim Průzkumníka na čtení a zápis .
Vyberte položku Upravit.
"WadCfg": {
"SinksConfig": {
"Sink": [
{
"name": "MyApplicationInsightsProfilerSink",
"ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
}
]
}
}
Po dokončení úprav konfigurace vyberte PUT.
Pokud put je úspěšné, uprostřed obrazovky se zobrazí zelený symbol zaškrtnutí.
Další krok
