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.

Áttérhet a munkaterület-alapú Application Insightsra , 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 beállításának része egy új alkalmazás figyeléséhez. 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 rendszerállapot-kulcs összekapcsolja a telemetriát az erőforráshoz.

Fontos

2024. február 29-én megszűnik a klasszikus Application Insights támogatása. Áttérhet a munkaterület-alapú Application Insightsra , 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.

Feljegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése 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áltás kapcsolati sztring az új képességek kihasználásához.

Bejelentkezés az Azure-ba

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

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

Jelentkezzen be az Azure Portalra , é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 tárolására 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áját egy közös Log Analytics-munkaterületre küldje. További információ: Munkaterület-alapú Application Insights-erőforrások.

Feljegyzé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ás-alapú lekérdezéseket tervez végrehajtani, a globálisan egyedi név használata leegyszerűsíti 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 megjeleníti a figyelt alkalmazás teljesítmény- és használati adatait.

A rendszerállapot-kulcs 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 rendszerállapotkulcsot, és hozzá kell adnia 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.

A rendszerállapot-kulcs használatával konfigurálhatja az alkalmazásban telepített SDK-t.

Az SDK telemetriát 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 adatok küldéséhez.

Erőforrás automatikus létrehozása

Erőforrás automatikus létrehozásához használja a PowerShellt vagy az Azure CLI-t.

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 az Azure PowerShell dokumentációjában találja.

Azure CLI (előzetes verzió)

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

 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, valamint 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áltás kapcsolati sztring a konfiguráció egyszerűsítése és a végpontmódosítás szükségességének kiküszöbölése é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. Az egyes SDK-k némileg eltérő módosításokat igényelnek, 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 helyőrző értékeitQuickPulse_Endpoint_AddressTelemetryChannel_Endpoint_Address, valamint Profile_Query_Endpoint_address az adott régió tényleges végpontcímeit. 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.

Feljegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése 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áltás kapcsolati sztring az új képességek kihasználásához.

---

SDK-kód módosítása

.NET

Feljegyzés

Az applicationinsights.config fájl automatikusan felülíródik az SDK-frissítés végrehajtásakor. Az SDK-frissítés végrehajtása után mindenképpen újra meg kell adnia 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 a projekt appsettings.json fájlját 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, hajtsa végre a következő módosításokat a ConfigureServices Startup.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

Az Azure Functions esetében a függvény alkalmazásbeállításaiban beállított kapcsolati sztring használatát javasoljuk. Ha a függvény alkalmazásbeállításait a függvénypanelen szeretné elérni, válassza a Beállítások>konfigurációs>alkalmazás beállításai 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, application.properties és adja hozzá a 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 kódrészlet 5-ös verziója. A verzió kódolva van a kódrészletben.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>

Feljegyzé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 az előző kódrészlet új sorában jelenik meg. Ha nem szeretné módosítani egy megjegyzésbefűzött sor értékét, az eltávolítható.

Python

Az opencensus-python SDK betöltési végpontjának módosításáról az opencensus-python adattárban talál útmutatást.

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

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

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 normál esetben elérhető api.applicationinsights.io, 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.
• Az Azure Government egyéni módosításaival kapcsolatos további információkért tekintse meg az Azure monitorozásához és felügyeletéhez szükséges részletes útmutatót.
• Az Azure China-ról az Azure China forgatókönyvében olvashat bővebben.