Menyebarkan Agen Azure Monitor Application Insights untuk server lokal

  • Artikel

Agen Application Insights (sebelumnya bernama Status Monitor V2) adalah modul PowerShell yang diterbitkan ke Galeri PowerShell. Agen Application Insights menggantikan Status Monitor. Telemetri dikirim ke portal Microsoft Azure, tempat Anda dapat memantau aplikasi.

Untuk daftar lengkap skenario autoinstrumentasi yang didukung, lihat Lingkungan, bahasa, dan penyedia sumber daya yang didukung.

Catatan

Saat ini, modul ini hanya mendukung instrumentasi tanpa kode dari aplikasi web ASP.NET dan ASP.NET Core yang dihosting dengan IIS. Gunakan SDK untuk membuat instrumen aplikasi Java dan Node.js.

Application Insights Agent terletak di Galeri PowerShell.

PowerShell Gallery icon.

Petunjuk

  • Untuk mulai menggunakan sampel kode ringkas, lihat tab Memulai .
  • Untuk penyelaman mendalam tentang cara memulai, lihat tab Instruksi terperinci.
  • Untuk referensi PowerShell API, lihat tab referensi API.
  • Untuk pembaruan catatan rilis, lihat tab Catatan rilis .

Tab ini berisi perintah mulai cepat yang diharapkan berfungsi untuk sebagian besar lingkungan. Instruksi bergantung pada Galeri PowerShell untuk mendistribusikan pembaruan. Perintah ini mendukung parameter -Proxy PowerShell.

Untuk penjelasan tentang perintah ini, instruksi kustomisasi, dan informasi tentang pemecahan masalah, lihat instruksi detail.

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Gunakan Galeri PowerShell untuk mengunduh dan menginstal.

Prasyarat penginstalan

Untuk mengaktifkan pemantauan, Anda harus memiliki string koneksi. string koneksi ditampilkan di panel Gambaran Umum sumber daya Application Insights Anda. Untuk informasi selengkapnya, lihat String koneksi.

Catatan

Mulai bulan April 2020, PowerShell Gallery telah menghentikan TLS 1.1 dan 1.0.

Untuk prasyarat selengkapnya yang mungkin Anda butuhkan, lihat Dukungan PowerShell Gallery TLS.

Jalankan PowerShell sebagai admin.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

Tutup PowerShell.

Menginstal Application Insights Agent

Jalankan PowerShell sebagai admin.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Catatan

Sakelar AllowPrerelease dalam Install-Module cmdlet memungkinkan penginstalan rilis beta.

Untuk informasi selengkapnya, lihat Install-Module.

Mengaktifkan pemantauan

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Mengunduh dan menginstal secara manual (opsi offline)

Anda juga dapat mengunduh dan menginstal secara manual.

Mengunduh modul

Unduh modul versi terbaru secara manual dari PowerShell Gallery.

Mengekstrak dan menginstal Application Insights Agent

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

Mengaktifkan pemantauan

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Apakah Agen Application Insights mendukung penginstalan proksi?

Ya. Ada beberapa cara untuk mengunduh Agen Application Insights:

  • Jika komputer Anda memiliki akses internet, Anda dapat masuk ke Galeri PowerShell dengan menggunakan parameter -Proxy.
  • Anda juga dapat mengunduh modul secara manual dan memasangnya di komputer Anda atau menggunakannya secara langsung.

Masing-masing opsi ini dijelaskan dalam instruksi terperinci.

Apakah Agen Application Insights mendukung aplikasi ASP.NET Core?

Ya. Di Application Insights Agent 2.0.0 dan yang lebih baru, aplikasi ASP.NET Core yang dihosting di IIS didukung.

Bagaimana cara memverifikasi bahwa pengaktifan telah berhasil?

  • Anda dapat menggunakan cmdlet Get-ApplicationInsightsMonitoringStatus untuk memverifikasi bahwa pengaktifan berhasil.

  • Gunakan Metrik Langsung untuk menentukan dengan cepat apakah aplikasi Anda mengirim telemetri.

  • Anda juga dapat menggunakan Analitik Log untuk mencantumkan semua peran cloud yang saat ini mengirimkan telemetri:

    union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Bagaimana cara mencapai passthrough proksi?

Untuk mencapai passthrough proksi, konfigurasikan proksi tingkat mesin atau proksi tingkat aplikasi. Lihat DefaultProxy.

Contoh Web.config:

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

Pemecahan Masalah

Lihat artikel pemecahan masalah khusus.

Menguji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST ke titik akhir penyerapan kami. Anda dapat menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan dengan menggunakan klien REST mentah dari PowerShell atau perintah curl. Lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Langkah berikutnya

Menampilkan telemetri Anda:

Tambahkan lebih banyak telemetri:

Lakukan lebih banyak hal dengan Agen Application Insights: