Application Insights kaynağı oluşturma

Dikkat

Bu makale, artık önerilmeyen Application Insights Klasik kaynakları için geçerlidir.

Bu makaledeki bilgiler eskidir ve güncelleştirilmeyecektir.

Yeni özelliklerden yararlanmak için çalışma alanı tabanlı Application Insights'a geçiş.

Application Insights, bir Azure kaynağında uygulamanızla ilgili verileri görüntüler. Yeni bir kaynak oluşturmak, Application Insights'ı yeni bir uygulamayı izlemek üzere ayarlamanın bir parçasıdır. Yeni kaynağınızı oluşturduktan sonra izleme anahtarını alabilir ve Application Insights SDK'sını yapılandırmak için kullanabilirsiniz. İzleme anahtarı telemetrinizi kaynağa bağlar.

Önemli

29 Şubat 2024'teklasik Application Insights desteği sona erecektir. Yeni özelliklerden yararlanmak için çalışma alanı tabanlı Application Insights'a geçiş. Şubat 2021'den sonra kullanıma sunulan daha yeni bölgeler klasik Application Insights kaynakları oluşturmayı desteklemez.

Not

31 Mart 2025’te izleme anahtarı alımı desteği sona erecektir. İzleme anahtarı alımı çalışmaya devam edecek, ancak artık özellik için güncelleştirme veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizelerine geçiş.

Azure'da oturum açma

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Application Insights kaynağı oluşturma

Azure portal oturum açın ve bir Application Insights kaynağı oluşturun.

Ayarlar	Değer	Açıklama
Ad	Unique value	İzlediğiniz uygulamayı tanımlayan ad.
Kaynak grubu	myResourceGroup	Application Insights verilerini barındıracak yeni veya mevcut kaynak grubunun adı.
Bölge	East US	Size yakın veya uygulamanızın barındırıldığı konumun yakınında bir konum seçin.
Kaynak modu	Classic veya Workspace-based	Çalışma alanı tabanlı kaynaklar, Application Insights telemetrinizi ortak bir Log Analytics çalışma alanına göndermenize olanak sağlar. Daha fazla bilgi için bkz . Çalışma alanı tabanlı Application Insights kaynakları.

Not

Farklı kaynak gruplarında aynı kaynak adını kullanabilirsiniz, ancak genel olarak benzersiz bir ad kullanmak yararlı olabilir. Kaynaklar arası sorgular gerçekleştirmeyi planlıyorsanız, genel olarak benzersiz bir ad kullanmak gerekli söz dizimini basitleştirir.

Gerekli alanlara uygun değerleri girin. Gözden geçir ve oluştur’u seçin.

Uygulamanız oluşturulduktan sonra yeni bir bölmede izlenen uygulamanızla ilgili performans ve kullanım verileri görüntülenir.

İzleme anahtarını kopyalama

İzleme anahtarı, telemetri verilerinizle ilişkilendirmek istediğiniz kaynağı tanımlar. İzleme anahtarını kopyalayıp uygulamanızın koduna eklemeniz gerekir.

Uygulamanıza SDK'yi yükleme

Uygulamanıza Application Insights SDK'sını yükleyin. Bu adım, uygulamanızın türüne büyük ölçüde bağlıdır.

Uygulamanıza yüklediğiniz SDK'yi yapılandırmak için izleme anahtarını kullanın.

SDK telemetri gönderen standart modüller içerir, bu nedenle daha fazla kod yazmanız gerekmez. Kullanıcı eylemlerini izlemek veya sorunları daha ayrıntılı olarak tanılamak için API'yi kullanarak kendi telemetrinizi gönderin.

Otomatik olarak kaynak oluşturma

Otomatik olarak kaynak oluşturmak için PowerShell'i veya Azure CLI'yi kullanın.

PowerShell

Yeni Application Insights kaynağı oluşturma

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

Örnek

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

Sonuçlar

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}

Bu cmdlet'in tam PowerShell belgeleri için ve izleme anahtarını almayı öğrenmek için Azure PowerShell belgelerine bakın.

Azure CLI (önizleme)

Application Insights Azure CLI komutlarının önizlemesine erişmek için önce şunu çalıştırmanız gerekir:

 az extension add -n application-insights

Komutunu çalıştırmazsanız az extension add şunu belirten bir hata iletisi görürsünüz: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Application Insights kaynağınızı oluşturmak için aşağıdaki komutu çalıştırın:

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

Örnek

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

Sonuçlar

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"
}

Bu komutun tam Azure CLI belgeleri için ve izleme anahtarını almayı öğrenmek için Azure CLI belgelerine bakın.

Varsayılan uç noktaları geçersiz kılma

Uyarı

Uç noktaları değiştirmeyin. Yapılandırmayı basitleştirmek ve uç nokta değişikliği gereksinimini ortadan kaldırmak için bağlantı dizelerine geçiş.

Application Insights'tan belirli bölgelere veri göndermek için varsayılan uç nokta adreslerini geçersiz kılmanız gerekir. Her SDK, tümü bu makalede açıklanan biraz farklı değişiklikler gerektirir.

Bu değişiklikler, örnek kodu ayarlamanızı ve , TelemetryChannel_Endpoint_Addressve Profile_Query_Endpoint_address yer tutucu değerlerini QuickPulse_Endpoint_Addresskendi bölgenizin gerçek uç nokta adresleriyle değiştirmenizi gerektirir. Bu makalenin sonunda, bu yapılandırmanın gerekli olduğu bölgelerin uç nokta adreslerine bağlantılar yer alır.

Not

31 Mart 2025’te izleme anahtarı alımı desteği sona erecektir. İzleme anahtarı alımı çalışmaya devam edecek, ancak artık özellik için güncelleştirme veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizelerine geçiş.

---

SDK kodu değişiklikleri

.NET

Not

SDK yükseltmesi her gerçekleştirildiğinde applicationinsights.config dosyasının üzerine otomatik olarak yazılır. SDK yükseltmesi gerçekleştirdikten sonra bölgeye özgü uç nokta değerlerini yeniden girdiğinizden emin olun.

<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

Ana uç noktayı ayarlamak için projenizdeki appsettings.json dosyasını değiştirin:

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

Canlı Ölçümler ve Profil Sorgusu uç noktası değerleri yalnızca kod aracılığıyla ayarlanabilir. Kod aracılığıyla tüm uç nokta değerlerinin varsayılan değerlerini geçersiz kılmak için dosyasının yönteminde ConfigureServicesStartup.cs aşağıdaki değişiklikleri yapın:

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 İşlevleri

Azure İşlevleri için işlevin Uygulama ayarlarında ayarlanan bağlantı dizelerini kullanmanızı öneririz. İşlevinizin Uygulama ayarlarına işlevler bölmesinden erişmek için Ayarlar>Yapılandırma>Uygulama ayarları'nı seçin.

Ad: APPLICATIONINSIGHTS_CONNECTION_STRING
Değer: Connection String Value

Java

varsayılan uç nokta adresini değiştirmek için applicationinsights.xml dosyasını değiştirin:

<?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

application.properties Dosyayı değiştirin ve ekleyin:

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();

Uç noktalar ortam değişkenleri aracılığıyla da yapılandırılabilir:

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

JavaScript

Burada listelenen geçerli kod parçacığının 5. sürümü. Sürüm kod parçacığında olarak sv:"#"kodlanmıştır. Geçerli sürüm GitHub'da da kullanılabilir.

<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>

Not

Okunabilirlik ve olası JavaScript hatalarını azaltmak için, tüm olası yapılandırma seçenekleri önceki kod parçacığı kodunda yeni bir satırda listelenir. Açıklama satırı değerini değiştirmek istemiyorsanız, kaldırılabilir.

Python

opencensus-python SDK'sı için alım uç noktasını değiştirme yönergeleri için opencensus-python deposuna başvurun.

Uç nokta değişikliği gerektiren bölgeler

Şu anda uç nokta değişiklikleri gerektiren tek bölgeler Azure Kamu ve Azure Çin'dir.

Bölge	Uç nokta adı	Değer
Azure Çin	Telemetri Kanalı	https://dc.applicationinsights.azure.cn/v2/track
Azure Çin	QuickPulse (Canlı Ölçümler)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Çin	Profil Sorgusu	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Kamu	Telemetri Kanalı	https://dc.applicationinsights.us/v2/track
Azure Kamu	QuickPulse (Canlı Ölçümler)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Kamu	Profil Sorgusu	https://dc.applicationinsights.us/api/profiles/{0}/appId

Şu anda normalde aracılığıyla api.applicationinsights.ioerişilen Application Insights REST API'sini kullanıyorsanız bölgenizde yerel olan bir uç nokta kullanmanız gerekir.

Bölge	Uç nokta adı	Değer
Azure Çin	REST API	api.applicationinsights.azure.cn
Azure Kamu	REST API	api.applicationinsights.us

Sonraki adımlar

• Tanılama Arama'yı kullanın.
• Ölçümleri keşfedin.
• Log Analytics sorguları yazın.
• Azure Kamu için özel değişiklikler hakkında daha fazla bilgi edinmek için Bkz. Azure izleme ve yönetimi için ayrıntılı yönergeler.
• Azure Çin hakkında daha fazla bilgi edinmek için bkz. Azure Çin Playbook'u.