Delen via


Create an Application Insights resource (Een Application Insights-resource maken)

Let op

Dit artikel is van toepassing op klassieke Application Insights-resources, die niet meer worden aanbevolen.

De informatie in dit artikel is verouderd en wordt niet bijgewerkt.

Overstappen op Application Insights op basis van een werkruimte om te profiteren van nieuwe mogelijkheden.

Application Insights geeft gegevens weer over uw toepassing in een Azure-resource. Het maken van een nieuwe resource maakt deel uit van het instellen van Application Insights om een nieuwe toepassing te bewaken. Nadat u de nieuwe resource hebt gemaakt, kunt u de instrumentatiesleutel ophalen en deze gebruiken om de Application Insights SDK te configureren. De instrumentatiesleutel koppelt uw telemetrie aan de resource.

Belangrijk

Op 29 februari 2024 wordt de ondersteuning voor klassieke Application Insights beëindigd. Overstappen op Application Insights op basis van een werkruimte om te profiteren van nieuwe mogelijkheden. Nieuwere regio's die na februari 2021 zijn geïntroduceerd, bieden geen ondersteuning voor het maken van klassieke Application Insights-resources.

Notitie

Op 31 maart 2025 eindigt de ondersteuning voor opname van instrumentatiesleutels. Opname van instrumentatiesleutels blijft werken, maar we bieden geen updates of ondersteuning meer voor de functie. Overgang naar verbindingsreeks s om te profiteren van nieuwe mogelijkheden.

Aanmelden bij Azure

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Create an Application Insights resource (Een Application Insights-resource maken)

Meld u aan bij Azure Portal en maak een Application Insights-resource.

Schermopname van het selecteren van het plusteken in de linkerbovenhoek, Ontwikkelhulpprogramma's en Application Insights.

Instellingen Weergegeven als Beschrijving
Naam Unique value Naam die de app identificeert die u bewaakt.
Resourcegroep myResourceGroup Naam voor de nieuwe of bestaande resourcegroep voor het hosten van Application Insights-gegevens.
Regio East US Selecteer een locatie bij u in de buurt of in de buurt waar uw app wordt gehost.
Resourcemodus Classic of Workspace-based Met op werkruimte gebaseerde resources kunt u uw Application Insights-telemetrie verzenden naar een algemene Log Analytics-werkruimte. Zie Application Insights-resources op basis van werkruimten voor meer informatie.

Notitie

U kunt dezelfde resourcenaam gebruiken in verschillende resourcegroepen, maar het kan nuttig zijn om een wereldwijd unieke naam te gebruiken. Als u van plan bent om query's voor meerdere resources uit te voeren, vereenvoudigt u de vereiste syntaxis met behulp van een wereldwijd unieke naam.

Voer de juiste waarden in de vereiste velden in. Selecteer Controleren + maken.

Schermopname van het invoeren van waarden in de vereiste velden en de knop Beoordelen en maken.

Nadat uw app is gemaakt, worden in een nieuw deelvenster prestatie- en gebruiksgegevens over uw bewaakte toepassing weergegeven.

De instrumentatiesleutel kopiëren

De instrumentatiesleutel identificeert de resource die u aan uw telemetriegegevens wilt koppelen. U moet de instrumentatiesleutel kopiëren en toevoegen aan de code van uw toepassing.

De SDK installeren in uw app

Installeer de Application Insights SDK in uw app. Deze stap is sterk afhankelijk van het type toepassing.

Gebruik de instrumentatiesleutel om de SDK te configureren die u in uw toepassing installeert.

De SDK bevat standaardmodules die telemetrie verzenden, zodat u geen code meer hoeft te schrijven. Als u gebruikersacties wilt bijhouden of problemen in meer detail wilt diagnosticeren, gebruikt u de API om uw eigen telemetrie te verzenden.

Automatisch een resource maken

Gebruik PowerShell of de Azure CLI om automatisch een resource te maken.

Powershell

Maak een nieuwe Application Insights-resource.

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

Opmerking

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

Resultaten

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}

Zie de Documentatie voor Azure PowerShell voor de volledige PowerShell-documentatie voor deze cmdlet en voor meer informatie over het ophalen van de instrumentatiesleutel.

Azure CLI (preview)

Als u toegang wilt krijgen tot de Azure CLI-opdrachten van Preview, moet u eerst het volgende uitvoeren:

 az extension add -n application-insights

Als u de az extension add opdracht niet uitvoert, ziet u een foutbericht met de volgende status: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Voer de volgende opdracht uit om uw Application Insights-resource te maken:

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

Opmerking

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

Resultaten

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

Voor de volledige Documentatie van Azure CLI voor deze opdracht en voor meer informatie over het ophalen van de instrumentatiesleutel, raadpleegt u de Azure CLI-documentatie.

Standaardeindpunten overschrijven

Als u gegevens van Application Insights naar bepaalde regio's wilt verzenden, moet u de standaardeindpuntadressen overschrijven. Elke SDK vereist iets andere wijzigingen, die allemaal in dit artikel worden beschreven.

Voor deze wijzigingen moet u de voorbeeldcode aanpassen en de tijdelijke aanduidingen voor QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addressen Profile_Query_Endpoint_address door de werkelijke eindpuntadressen voor uw specifieke regio vervangen. Het einde van dit artikel bevat koppelingen naar de eindpuntadressen voor regio's waarvoor deze configuratie is vereist.

Notitie

Op 31 maart 2025 eindigt de ondersteuning voor opname van instrumentatiesleutels. Opname van instrumentatiesleutels blijft werken, maar we bieden geen updates of ondersteuning meer voor de functie. Overgang naar verbindingsreeks s om te profiteren van nieuwe mogelijkheden.


SDK-codewijzigingen

Notitie

Het bestand applicationinsights.config wordt automatisch overschreven wanneer een SDK-upgrade wordt uitgevoerd. Nadat u een SDK-upgrade hebt uitgevoerd, moet u de regiospecifieke eindpuntwaarden opnieuw invoeren.

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

Regio's waarvoor eindpuntwijziging is vereist

Momenteel zijn de enige regio's die eindpuntwijzigingen vereisen Azure Government en Azure China.

Regio Naam Eeindpunt Weergegeven als
Azure China Telemetriekanaal https://dc.applicationinsights.azure.cn/v2/track
Azure China QuickPulse (Live Metrics) https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China Profielquery https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government Telemetriekanaal https://dc.applicationinsights.us/v2/track
Azure Government QuickPulse (Live Metrics) https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government Profielquery https://dc.applicationinsights.us/api/profiles/{0}/appId

Als u momenteel de Rest API van Application Insights gebruikt, die normaal gesproken toegankelijk is via api.applicationinsights.io, moet u een eindpunt gebruiken dat lokaal is in uw regio.

Regio Naam Eeindpunt Weergegeven als
Azure China REST-API api.applicationinsights.azure.cn
Azure Government REST-API api.applicationinsights.us

Volgende stappen