Application Insights-erőforrás létrehozása

Figyelemfelhívás

Ez a cikk a klasszikus Application Insights-erőforrásokra vonatkozik, amelyek már nem ajánlottak.

A cikkben szereplő információk elavultak, és nem frissülnek.

Váltsa át a munkaterület-alapú Application Insights szolgáltatást , hogy kihasználhassa az új képességek előnyeit.

Az Application Insights egy Azure-erőforrásban jeleníti meg az alkalmazás adatait. Új erőforrás létrehozása az Application Insights új alkalmazás figyelésére való beállításának része. Az új erőforrás létrehozása után lekérheti annak rendszerállapotkulcsát, és konfigurálhatja az Application Insights SDK-t. A kialakítási kulcs összekapcsolja a telemetriát az erőforráshoz.

Fontos

2024. február 29-énmegszűnik a klasszikus Application Insights támogatása. Váltsa át a munkaterület-alapú Application Insights szolgáltatást , hogy kihasználhassa az új képességek előnyeit. A 2021 februárja után bevezetett újabb régiók nem támogatják a klasszikus Application Insights-erőforrások létrehozását.

Megjegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapotkulcs-betöltés továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltsa át a kapcsolati sztringeket az új képességek kihasználásához.

Bejelentkezés az Azure-ba

Ha nem rendelkezik Azure-előfizetéssel, első lépésként mindössze néhány perc alatt létrehozhat egy ingyenes fiókot.

Application Insights-erőforrás létrehozása

Jelentkezzen be a Azure Portal, és hozzon létre egy Application Insights-erőforrást.

Beállítások	Érték	Leírás
Név	Unique value	A figyelt alkalmazást azonosító név.
Erőforráscsoport	myResourceGroup	Az Application Insights-adatok üzemeltetésére szolgáló új vagy meglévő erőforráscsoport neve.
Régió	East US	Válasszon ki egy önhöz közeli vagy az alkalmazás üzemeltetett helyéhez közeli helyet.
Erőforrás mód	Classic vagy Workspace-based	A munkaterület-alapú erőforrások lehetővé teszik, hogy az Application Insights-telemetriát egy közös Log Analytics-munkaterületre küldje. További információ: Munkaterület-alapú Application Insights-erőforrások.

Megjegyzés

Ugyanazt az erőforrásnevet különböző erőforráscsoportokban is használhatja, de hasznos lehet globálisan egyedi nevet használni. Ha erőforrásközi lekérdezéseket tervez végrehajtani, a globálisan egyedi névvel leegyszerűsítheti a szükséges szintaxist.

Adja meg a megfelelő értékeket a szükséges mezőkben. Válassza az Áttekintés + létrehozás lehetőséget.

Az alkalmazás létrehozása után egy új panel jeleníti meg a figyelt alkalmazás teljesítmény- és használati adatait.

Az eszközkulcs másolása

A rendszerállapotkulcs azonosítja a telemetriai adatokhoz társítani kívánt erőforrást. Ki kell másolnia a kialakítási kulcsot, és hozzá kell adnia azt az alkalmazás kódjához.

Az SDK telepítése az alkalmazásban

Telepítse az Application Insights SDK-t az alkalmazásba. Ez a lépés nagymértékben függ az alkalmazás típusától.

Az eszközkulcs használatával konfigurálhatja az alkalmazásban telepített SDK-t.

Az SDK telemetriai adatokat küldő szabványos modulokat tartalmaz, így nem kell több kódot írnia. A felhasználói műveletek nyomon követéséhez vagy a problémák részletesebb diagnosztizálásához használja az API-t a saját telemetriai adatainak elküldéséhez.

Erőforrás automatikus létrehozása

A PowerShell vagy az Azure CLI használatával automatikusan létrehozhat egy erőforrást.

PowerShell

Hozzon létre egy új Application Insights-erőforrást.

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

Példa

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

Results (Eredmények)

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}

A parancsmag teljes PowerShell-dokumentációját és a rendszerállapot-kulcs lekérését a Azure PowerShell dokumentációjában találja.

Azure CLI (előzetes verzió)

Az előzetes verziójú Application Insights Azure CLI-parancsok eléréséhez először futtatnia kell a következőt:

 az extension add -n application-insights

Ha nem futtatja a az extension add parancsot, a következő hibaüzenet jelenik meg: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Futtassa a következő parancsot az Application Insights-erőforrás létrehozásához:

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

Példa

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

Results (Eredmények)

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

A parancs teljes Azure CLI-dokumentációját és a rendszerállapot-kulcs lekérésének módját az Azure CLI dokumentációjában találja.

Alapértelmezett végpontok felülbírálása

Figyelmeztetés

Ne módosítsa a végpontokat. Váltsa át a kapcsolati sztringeket a konfiguráció egyszerűsítése és a végpont módosításának szükségtelenné tétele érdekében.

Ha adatokat szeretne küldeni az Application Insightsból bizonyos régiókba, felül kell bírálnia az alapértelmezett végpontcímeket. Minden SDK némileg eltérő módosításokat igényel, amelyek mindegyikét ebben a cikkben ismertetjük.

Ezekhez a módosításokhoz módosítania kell a mintakódot, és le kell cserélnie a , TelemetryChannel_Endpoint_Addressés Profile_Query_Endpoint_address helyőrző értékeit QuickPulse_Endpoint_Addressaz adott régióhoz tartozó tényleges végpontcímekre. A cikk végén azoknak a régióknak a végpontcímére mutató hivatkozások találhatók, ahol ez a konfiguráció szükséges.

Megjegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapotkulcs-betöltés továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltsa át a kapcsolati sztringeket az új képességek kihasználásához.

---

SDK-kódmódosítások

.NET

Megjegyzés

A applicationinsights.config fájl automatikusan felülíródik az SDK-frissítés végrehajtásakor. Az SDK frissítése után mindenképpen adja meg újra a régióspecifikus végpontértékeket.

<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

Módosítsa az appsettings.json fájlt a projektben a fő végpont módosításához:

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

Az Élő metrikák és a Profillekérdezés végpont értékei csak kóddal állíthatók be. Ha az összes végpontérték alapértelmezett értékeit kóddal szeretné felülbírálni, végezze el a következő módosításokat a ConfigureServicesStartup.cs fájl metódusában:

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

A Azure Functions esetében javasoljuk, hogy a függvény alkalmazásbeállításaiban beállított kapcsolati sztringeket használja. Ha a függvény alkalmazásbeállításaihoz a függvénypanelen szeretne hozzáférni, válassza a Beállítások>Konfigurációs>alkalmazásbeállítások lehetőséget.

Név: APPLICATIONINSIGHTS_CONNECTION_STRING
Érték: Connection String Value

Java

Módosítsa a applicationinsights.xml fájlt az alapértelmezett végpontcím módosításához:

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

Módosítsa a fájlt, és adja hozzá a application.properties következőt:

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

A végpontok környezeti változókkal is konfigurálhatók:

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

JavaScript

Az itt felsorolt aktuális kódrészlet 5-ös verziója. A verzió kódolva van a kódrészletben a következőként sv:"#": . Az aktuális verzió a GitHubon is elérhető.

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

Megjegyzés

Az olvashatóság és a lehetséges JavaScript-hibák csökkentése érdekében az összes lehetséges konfigurációs lehetőség megjelenik egy új sorban az előző kódrészlet kódjában. Ha nem szeretné módosítani egy megjegyzéssel rendelkező sor értékét, eltávolíthatja azt.

Python

Az opencensus-python SDK betöltési végpontjának módosításával kapcsolatos útmutatásért tekintse meg az opencensus-python adattárat.

Végpontmódosítást igénylő régiók

Jelenleg az egyetlen régió, amely végpontmódosítást igényel, az Azure Government és az Azure China.

Régió	Végpont neve	Érték
Azure China	Telemetriai csatorna	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (élő metrikák)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China	Profil lekérdezése	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Telemetriai csatorna	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (élő metrikák)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profil lekérdezése	https://dc.applicationinsights.us/api/profiles/{0}/appId

Ha jelenleg az Application Insights REST API-t használja, amely általában a használatával api.applicationinsights.ioérhető el, a régióban helyi végpontot kell használnia.

Régió	Végpont neve	Érték
Azure China	REST API	api.applicationinsights.azure.cn
Azure Government	REST API	api.applicationinsights.us

Következő lépések

• Használja a Diagnosztikai keresést.
• Metrikák felfedezése.
• Log Analytics-lekérdezések írása.
• A Azure Government egyéni módosításaival kapcsolatos további információkért tekintse meg az Azure monitorozásával és felügyeletével kapcsolatos részletes útmutatót.
• Az Azure China-ról további információt az Azure China forgatókönyvében talál.