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

Azure-alkalmazás Insights egy Microsoft Azure-erőforrásban jeleníti meg az alkalmazás adatait. Az új erőforrások létrehozása ezért az Application Insights beállításának része egy új alkalmazás monitorozásához. Az új erőforrás létrehozása után lekérheti annak rendszerállapotkulcsát, és ezzel 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 Microsoft 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:

Kattintson a + jelre a bal felső sarokban. Válassza a Fejlesztői eszközök, majd az Application Insights lehetőséget

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 App Insights-adatok üzemeltetésére szolgáló új vagy meglévő erőforráscsoport neve.
Régió East US Válasszon egy önhöz közeli helyet, vagy az alkalmazás üzemeltetett helyének közelében.
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ót a munkaterület-alapú erőforrásokról szóló cikkben talál.

Megjegyzés

Bár ugyanazt az erőforrásnevet különböző erőforráscsoportokban is használhatja, hasznos lehet globálisan egyedi nevet használni. Ez akkor lehet hasznos, ha erőforrás-alapú lekérdezéseket tervez végrehajtani , mivel ez leegyszerűsíti a szükséges szintaxist.

Írja be a megfelelő értékeket a szükséges mezőkbe, majd válassza az Áttekintés + létrehozás lehetőséget.

Írja be az értékeket a kötelező mezőkbe, majd válassza az

Az alkalmazás létrehozása után megnyílik egy új panel. Ezen a panelen láthatja a figyelt alkalmazás teljesítmény- és használati adatait.

Az eszközkulcs másolása

A rendszerállapotkulcs azonosítja azt az erőforrást, amelyhez a telemetriai adatokat társítani szeretné. Ki kell másolnia a kialakítási kulcsot, é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.

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

Az SDK olyan szabványos modulokat tartalmaz, amelyek telemetriát küldenek anélkül, hogy további kódot kellene írniuk. 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

PowerShell

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

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áért és a kialakítási kulcs lekéréséhez tekintse meg a Azure PowerShell dokumentációját.

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

Most futtassa az alábbi 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áért és a kialakítási kulcs lekéréséhez tekintse meg az Azure CLI dokumentációját.

Az Application Insights felülírja az alapértelmezett végpontokat

Figyelmeztetés

A végpont módosítása nem ajánlott. 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ítani kell a mintakódot, és le kell cserélni 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

Megjegyzés

A applicationinsights.config fájl automatikusan felülíródik, amikor SDK-frissítést hajtanak végre. Az SDK-frissítés végrehajtása 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>

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

Jelenleg az egyetlen olyan 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 "api.applicationinsights.io" keresztül é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