Siapkan sumber daya Application Insights

Perhatian

Artikel ini berlaku untuk sumber daya Application Insights Classic, yang tidak lagi direkomendasikan.

Informasi dalam artikel ini kedaluarsa dan tidak akan diperbarui.

Transisi ke Application Insights berbasis ruang kerja untuk memanfaatkan kemampuan baru.

Application Insights menampilkan data tentang aplikasi Anda di sumber daya Azure. Membuat sumber daya baru adalah bagian dari menyiapkan Application Insights untuk memantau aplikasi baru. Setelah membuat sumber daya baru, Anda bisa mendapatkan kunci instrumentasinya dan menggunakannya untuk mengonfigurasi SDK Application Insights. Kunci instrumentasi menghubungkan telemetri Anda ke sumber daya.

Penting

Pada 29 Februari 2024,dukungan untuk Application Insights klasik akan berakhir. Transisi ke Application Insights berbasis ruang kerja untuk memanfaatkan kemampuan baru. Wilayah yang lebih baru diperkenalkan setelah Februari 2021 tidak mendukung pembuatan sumber daya Application Insights klasik.

Catatan

Pada tanggal 31 Maret 2025, dukungan untuk penyerapan kunci instrumentasi akan berakhir. Penyerapan kunci instrumentasi akan berjalan terus, namun kami tidak akan lagi menyediakan pembaruan atau dukungan terhadap fitur tersebut. Transisi ke string koneksi untuk memanfaatkan kemampuan baru.

Masuk ke Azure

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

Siapkan sumber daya Application Insights

Masuk ke portal Azure dan buat sumber daya Application Insights.

Pengaturan	Nilai	Deskripsi
Nama	Unique value	Nama yang mengidentifikasi aplikasi yang sedang Anda pantau.
Grup Sumber Daya	myResourceGroup	Nama untuk grup sumber daya baru atau yang sudah ada untuk menghosting data Application Insights.
Wilayah	East US	Pilih lokasi di dekat Anda atau di dekat tempat aplikasi Anda dihosting.
Mode sumber daya	Classic atau Workspace-based	Sumber daya berbasis ruang kerja memungkinkan Anda mengirim telemetri Application Insights ke ruang kerja Analitik Log umum. Untuk informasi selengkapnya, lihat Sumber daya Application Insights berbasis ruang kerja.

Catatan

Anda dapat menggunakan nama sumber daya yang sama di berbagai grup sumber daya, tetapi dapat bermanfaat untuk menggunakan nama yang unik secara global. Jika Anda berencana untuk melakukan kueri lintas sumber daya, menggunakan nama unik global menyederhanakan sintaks yang diperlukan.

Masukkan nilai yang sesuai di bidang yang diperlukan. Pilih Tinjau + buat.

Setelah aplikasi Anda dibuat, panel baru menampilkan data performa dan penggunaan tentang aplikasi yang dipantau.

Menyalin kunci instrumentasi

Kunci instrumentasi mengidentifikasi sumber daya yang ingin Anda kaitkan dengan data telemetri Anda. Anda perlu menyalin kunci instrumentasi dan menambahkannya ke kode aplikasi Anda.

Menginstal SDK di aplikasi Anda

Instal Application Insights SDK di aplikasi Anda. Langkah ini sangat bergantung pada jenis aplikasi Anda.

Gunakan kunci instrumentasi untuk mengonfigurasi SDK yang Anda instal di aplikasi Anda.

SDK mencakup modul standar yang mengirim telemetri, sehingga Anda tidak perlu menulis kode lagi. Untuk melacak tindakan pengguna atau mendiagnosis masalah secara lebih rinci, gunakan API untuk mengirim telemetri Anda sendiri.

Membuat sumber daya secara otomatis

Gunakan PowerShell atau Azure CLI untuk membuat sumber daya secara otomatis.

PowerShell

Membuat sumber daya Application Insights baru.

New-AzApplicationInsights [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Kind <String>]
 [-Tag <Hashtable>] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

Contoh

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus

Hasil

Id                 : /subscriptions/{subid}/resourceGroups/testgroup/providers/microsoft.insights/components/test1027
ResourceGroupName  : testgroup
Name               : test1027
Kind               : web
Location           : eastus
Type               : microsoft.insights/components
AppId              : 8323fb13-32aa-46af-b467-8355cf4f8f98
ApplicationType    : web
Tags               : {}
CreationDate       : 10/27/2017 4:56:40 PM
FlowType           :
HockeyAppId        :
HockeyAppToken     :
InstrumentationKey : 00000000-aaaa-bbbb-cccc-dddddddddddd
ProvisioningState  : Succeeded
RequestSource      : AzurePowerShell
SamplingPercentage :
TenantId           : {subid}

Untuk dokumentasi PowerShell lengkap untuk cmdlet ini, dan untuk mempelajari cara mengambil kunci instrumentasi, lihat dokumentasi Azure PowerShell.

Azure CLI (pratinjau)

Untuk mengakses perintah pratinjau Application Insights Azure CLI, Anda harus menjalankan terlebih dahulu:

 az extension add -n application-insights

Jika Anda tidak menjalankan az extension add perintah, Anda akan melihat pesan kesalahan yang menyatakan: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Jalankan perintah berikut untuk membuat sumber daya Application Insights Anda:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--kind]
                                         [--tags]

Contoh

az monitor app-insights component create --app demoApp --location westus2 --kind web --resource-group demoRg --application-type web

Hasil

az monitor app-insights component create --app demoApp --location eastus --kind web --resource-group demoApp --application-type web
{
  "appId": "87ba512c-e8c9-48d7-b6eb-118d4aee2697",
  "applicationId": "demoApp",
  "applicationType": "web",
  "creationDate": "2019-08-16T18:15:59.740014+00:00",
  "etag": "\"0300edb9-0000-0100-0000-5d56f2e00000\"",
  "flowType": "Bluefield",
  "hockeyAppId": null,
  "hockeyAppToken": null,
  "id": "/subscriptions/{subid}/resourceGroups/demoApp/providers/microsoft.insights/components/demoApp",
  "instrumentationKey": "00000000-aaaa-bbbb-cccc-dddddddddddd",
  "kind": "web",
  "location": "eastus",
  "name": "demoApp",
  "provisioningState": "Succeeded",
  "requestSource": "rest",
  "resourceGroup": "demoApp",
  "samplingPercentage": null,
  "tags": {},
  "tenantId": {tenantID},
  "type": "microsoft.insights/components"
}

Untuk dokumentasi Azure CLI lengkap untuk perintah ini, dan untuk mempelajari cara mengambil kunci instrumentasi, lihat dokumentasi Azure CLI.

Mengesampingkan titik akhir default

Peringatan

Jangan ubah titik akhir. Transisi ke string koneksi untuk menyederhanakan konfigurasi dan menghilangkan kebutuhan untuk modifikasi titik akhir.

Untuk mengirim data dari Application Insights ke wilayah tertentu, Anda perlu mengambil alih alamat titik akhir default. Setiap SDK memerlukan modifikasi yang sedikit berbeda, yang semuanya dijelaskan dalam artikel ini.

Perubahan ini mengharuskan Anda menyesuaikan kode sampel dan mengganti nilai tempat penampung untuk QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Address, dan Profile_Query_Endpoint_address dengan alamat titik akhir aktual untuk wilayah tertentu Anda. Akhir artikel ini berisi link ke alamat titik akhir untuk wilayah di mana konfigurasi ini diperlukan.

Catatan

Pada tanggal 31 Maret 2025, dukungan untuk penyerapan kunci instrumentasi akan berakhir. Penyerapan kunci instrumentasi akan berjalan terus, namun kami tidak akan lagi menyediakan pembaruan atau dukungan terhadap fitur tersebut. Transisi ke string koneksi untuk memanfaatkan kemampuan baru.

---

Perubahan kode SDK

.NET

Catatan

File applicationinsights.config secara otomatis ditimpa kapan saja peningkatan SDK dilakukan. Setelah Anda melakukan peningkatan SDK, pastikan untuk masuk kembali ke nilai titik akhir khusus wilayah.

<ApplicationInsights>
  ...
  <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <QuickPulseServiceEndpoint>Custom_QuickPulse_Endpoint_Address</QuickPulseServiceEndpoint>
    </Add>
  </TelemetryModules>
   ...
  <TelemetrySinks>
    <Add Name = "default">
      <TelemetryChannel>
         <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
      </TelemetryChannel>
    </Add>
  </TelemetrySinks>
  ...
  <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
    <ProfileQueryEndpoint>Profile_Query_Endpoint_address</ProfileQueryEndpoint>
  </ApplicationIdProvider>
  ...
</ApplicationInsights>

.NET Core

Ubah file appsettings.json di proyek Anda untuk menyesuaikan titik akhir utama:

"ApplicationInsights": {
    "InstrumentationKey": "instrumentationkey",
    "TelemetryChannel": {
      "EndpointAddress": "TelemetryChannel_Endpoint_Address"
    }
  }

Nilai untuk Metrik Langsung dan titik akhir Kueri Profil hanya dapat diatur melalui kode. Untuk mengganti nilai default untuk semua nilai titik akhir melalui kode, buat perubahan berikut dalam metode ConfigureServices dari file Startup.cs:

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse; //Place at top of Startup.cs file

   services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) => module.QuickPulseServiceEndpoint="QuickPulse_Endpoint_Address");

   services.AddSingleton<IApplicationIdProvider, ApplicationInsightsApplicationIdProvider>(_ => new ApplicationInsightsApplicationIdProvider() { ProfileQueryEndpoint = "Profile_Query_Endpoint_address" });

   services.AddSingleton<ITelemetryChannel>(_ => new ServerTelemetryChannel() { EndpointAddress = "TelemetryChannel_Endpoint_Address" });

    //Place in the ConfigureServices method. Place this before services.AddApplicationInsightsTelemetry("instrumentation key"); if it's present

Azure Functions

Untuk Azure Functions, kami sarankan Anda menggunakan string koneksi yang diatur dalam pengaturan Aplikasi fungsi. Untuk mengakses pengaturan Aplikasi untuk fungsi Anda dari dalam panel fungsi, pilih Pengaturan>Pengaturan Pengaturan AplikasiKonfigurasi>.

Nama: APPLICATIONINSIGHTS_CONNECTION_STRING
Nilai: Connection String Value

Java

Ubah file applicationinsights.xml untuk mengubah alamat titik akhir default:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
  <InstrumentationKey>ffffeeee-dddd-cccc-bbbb-aaaa99998888</InstrumentationKey>
  <TelemetryModules>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebRequestTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebSessionTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebUserTrackingTelemetryModule"/>
  </TelemetryModules>
  <TelemetryInitializers>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationIdTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationNameTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebSessionTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserAgentTelemetryInitializer"/>
  </TelemetryInitializers>
  <!--Add the following Channel value to modify the Endpoint address-->
  <Channel type="com.microsoft.applicationinsights.channel.concrete.inprocess.InProcessTelemetryChannel">
  <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
  </Channel>
</ApplicationInsights>

Spring Boot

Ubah file application.properties dan tambahkan:

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

Node.js

var appInsights = require("applicationinsights");
appInsights.setup('INSTRUMENTATION_KEY');
appInsights.defaultClient.config.endpointUrl = "TelemetryChannel_Endpoint_Address"; // ingestion
appInsights.defaultClient.config.profileQueryEndpoint = "Profile_Query_Endpoint_address"; // appid/profile lookup
appInsights.defaultClient.config.quickPulseHost = "QuickPulse_Endpoint_Address"; //live metrics
appInsights.Configuration.start();

Titik akhir juga dapat dikonfigurasi melalui variabel lingkungan:

**Instrumentation Key*: "APPINSIGHTS_INSTRUMENTATIONKEY"
*Profile endpoint*: "Profile_Query_Endpoint_address"
*Live Metrics endpoint*: "QuickPulse_Endpoint_Address"

JavaScript

Cuplikan saat ini tercantum di sini versi 5. Versi dikodekan dalam cuplikan sebagai sv:"#". Versi saat ini juga tersedia di GitHub.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied.
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head (default) = 0ms load after timeout.
// useXhr: 1, // Use XHR instead of fetch to report failures (if available).
crossOrigin: "anonymous", // When supplied, this will add the provided value as the cross origin attribute on the script tag.
// onInit: null, // Once the Application Insights instance has loaded and initialized, this callback function will be called with 1 argument -- the sdk instance. (DO NOT ADD anything to the sdk.queue -- as they won't get called.)
cfg: { // Application Insights Configuration
    instrumentationKey:"INSTRUMENTATION_KEY",
    endpointUrl: "TelemetryChannel_Endpoint_Address"
}});
</script>

Catatan

Untuk keterbacaan dan mengurangi potensi kesalahan JavaScript, semua opsi konfigurasi yang memungkinkan telah dicantumkan pada baris baru dalam kode cuplikan sebelumnya. Jika tidak ingin mengganti nilai baris yang dikomentari, Anda dapat menghapusnya.

Python

Untuk panduan tentang memodifikasi titik akhir penyerapan untuk opencensus-python SDK, lihat repositori opencensus-python.

Wilayah yang memerlukan modifikasi titik akhir

Saat ini, satu-satunya wilayah yang memerlukan modifikasi titik akhir adalah Azure Government dan Azure Tiongkok.

Wilayah	Nama titik akhir 2	Nilai
Azure Tiongkok	Saluran Telemetri	https://dc.applicationinsights.azure.cn/v2/track
Azure Tiongkok	QuickPulse (Metrik Langsung)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Tiongkok	Kueri Profil	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Saluran Telemetri	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (Metrik Langsung)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Kueri Profil	https://dc.applicationinsights.us/api/profiles/{0}/appId

Jika saat ini Anda menggunakan REST API Application Insights, yang biasanya diakses melalui api.applicationinsights.io, Anda perlu menggunakan titik akhir yang lokal ke wilayah Anda.

Wilayah	Nama titik akhir 2	Nilai
Azure Tiongkok	REST API	api.applicationinsights.azure.cn
Azure Government	REST API	api.applicationinsights.us

Langkah berikutnya

• Gunakan Pencarian Diagnostik.
• Jelajahi metrik.
• Menulis kueri Analitik Log.
• Untuk mempelajari selengkapnya tentang modifikasi kustom untuk Azure Government, lihat panduan terperinci untuk pemantauan dan manajemen Azure.
• Untuk mempelajari selengkapnya tentang Azure Tiongkok, lihat Azure China Playbook.