Mengaktifkan Profiler untuk aplikasi web di mesin virtual Azure

Artikel
09/27/2023

Catatan

Sebaiknya Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Lihat Menginstal Azure PowerShell untuk memulai. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.

Dalam artikel ini, Anda mempelajari cara menjalankan Application Insights Profiler di komputer virtual (VM) Azure atau set skala komputer virtual Azure melalui tiga metode berbeda:

Visual Studio dan Azure Resource Manager
PowerShell
Azure Resource Explorer

Dengan salah satu metode ini, Anda:

Mengonfigurasikan ekstensi Azure Diagnostics untuk mengaktifkan Profiler.
Instal Application Insights SDK pada VM.
Sebarkan aplikasi Anda.
Lihat jejak Profiler melalui instans Application Insights di portal Azure.

Prasyarat

Aplikasi ASP.NET Core yang berfungsi.
Sumber daya Application Insights.
Untuk meninjau templat Azure Resource Manager (templat ARM) untuk ekstensi Azure Diagnostics:
- Komputer Virtual
- Set skala mesin virtual

Menambahkan Application Insights SDK ke aplikasi Anda

Buka proyek ASP.NET core Anda di Visual Studio.
Pilih Proyek>Tambahkan Telemetri Application Insights.
Pilih Azure Application Insights>Berikutnya.
Pilih langganan tempat sumber daya Application Insights Anda berada dan pilih Berikutnya.
Pilih tempat untuk menyimpan string koneksi dan pilih Berikutnya.
Pilih Selesai.

Catatan

Untuk petunjuk lengkap, termasuk cara mengaktifkan Application Insights pada aplikasi ASP.NET Core Anda tanpa Visual Studio, lihat Application Insights untuk aplikasi ASP.NET Core.

Mengonfirmasi rilis stabil terbaru dari Application Insights SDK

Masuk ke Proyek>Kelola Paket NuGet.
Pilih Microsoft.ApplicationInsights.AspNetCore.
Di panel samping, pilih versi terbaru SDK dari menu dropdown.
Pilih Perbarui.

Mengaktifkan Profiler

Anda dapat mengaktifkan Profiler dengan salah satu dari tiga cara:

Dalam aplikasi ASP.NET Core Anda dengan menggunakan templat Azure Resource Manager dan Visual Studio. Direkomendasikan.
Dengan menggunakan perintah PowerShell melalui Azure CLI.
Dengan menggunakan Azure Resource Explorer.

Menginstal ekstensi Azure Diagnostics

Pilih templat ARM mana yang akan digunakan:
- Komputer Virtual
- Set skala mesin virtual
Dalam templat, temukan sumber daya dari jenis extension.
Di Visual Studio, buka arm.json file di aplikasi ASP.NET Core yang ditambahkan saat Anda menginstal SDK Application Insights.
Tambahkan jenis sumber daya extension dari templat ke file arm.json untuk menyiapkan mesin virtual atau set skala mesin virtual dengan Azure Diagnostics.

WadCfg Dalam tag , tambahkan kunci instrumentasi Application Insights Anda ke MyApplicationInsightsProfilerSink.

"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}

Sebarkan aplikasi Anda.

Perintah PowerShell berikut adalah pendekatan untuk mesin virtual yang sudah ada yang hanya menyentuh ekstensi Azure Diagnostics.

Catatan

Jika Anda menyebarkan mesin virtual lagi, sink tersebut akan hilang. Anda perlu memperbarui konfigurasi yang Anda gunakan saat menyebarkan VM untuk mempertahankan pengaturan ini.

Menginstal Application Insights melalui konfigurasi Diagnostik Azure

Ekspor konfigurasi Azure Diagnostics yang saat ini disebarkan ke file:
```
$ConfigFilePath = [IO.Path]::GetTempFileName()
```

Tambahkan sink Application Insights Profiler ke konfigurasi yang dikembalikan oleh perintah berikut:

(Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath

Application Insights Profiler WadCfg:

"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}

Jalankan perintah berikut untuk meneruskan konfigurasi yang diperbarui ke perintah Set-AzVMDiagnosticsExtension.
```
Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
```
Catatan

Set-AzVMDiagnosticsExtension mungkin memerlukan argumen -StorageAccountName. Jika konfigurasi diagnostik asli Anda memiliki properti storageAccountName di bagian protectedSettings (yang tidak dapat diunduh), pastikan untuk meneruskan nilai asli yang sama dengan yang Anda miliki dalam panggilan cmdlet ini.

Fitur Pelacakan Http IIS

Jika aplikasi yang dimaksudkan berjalan melalui IIS, maka aktifkan fitur Windows IIS Http Tracing:

Membangun akses jarak jauh ke lingkungan.

Gunakan jendela Tambahkan fitur Windows, atau jalankan perintah berikut ini di PowerShell (sebagai administrator):

Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All

Jika pembuatan akses jarak jauh menjadi masalah, Anda dapat menggunakan Azure CLI untuk menjalankan perintah berikut:

az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"

Sebarkan aplikasi Anda.

Mengatur sink Profiler dengan menggunakan Azure Resource Explorer

Karena portal Azure tidak menyediakan cara untuk mengatur sink Application Insights Profiler, Anda dapat menggunakan Azure Resource Explorer untuk mengatur sink.

Catatan

Jika Anda menyebarkan mesin virtual lagi, sink tersebut akan hilang. Anda perlu memperbarui konfigurasi yang Anda gunakan saat menyebarkan VM untuk mempertahankan pengaturan ini.

Verifikasi bahwa ekstensi Microsoft Azure Diagnostics diinstal dengan melihat ekstensi yang diinstal untuk komputer virtual Anda.
Temukan ekstensi Diagnostik mesin virtual untuk mesin virtual Anda:
1. Buka Azure Resource Explorer.
2. Perluas langganan dan temukan langganan yang menyimpan grup sumber daya dengan VM Anda.
3. Telusuri paling detail ekstensi VM Anda dengan memilih grup sumber daya Anda. Kemudian pilih ekstensi Microsoft.Compute>virtualMachines>[komputer virtual Anda]>.
Tambahkan sink Profiler Application Insights ke simpul di SinksConfig bawah WadCfg. Jika Anda belum memiliki SinksConfig bagian , Anda mungkin perlu menambahkannya. Untuk menambahkan sink:
- Pastikan untuk menentukan iKey Application Insights yang tepat di pengaturan Anda.
- Alihkan mode Explorer ke Baca/Tulis di sudut kanan atas.
- Pilih Edit.
```
"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}        
```
Setelah Anda selesai mengedit konfigurasi, pilih PUT.
put Jika berhasil, tanda centang hijau muncul di tengah layar.