Een Application Insights-resource maken
Waarschuwing
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.
Stap over naar Application Insights op basis van werkruimte om te profiteren van nieuwe mogelijkheden.
Application Insights geeft gegevens over uw toepassing weer 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 bijbehorende instrumentatiesleutel ophalen en deze gebruiken om de Application Insights SDK te configureren. De instrumentatiesleutel koppelt uw telemetrie aan de resource.
Belangrijk
Op 29 februari 2024eindigt de ondersteuning voor klassieke Application Insights. Stap over naar Application Insights op basis van 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 verbindingsreeksen om te profiteren van nieuwe mogelijkheden.
Aanmelden bij Azure
Als u nog geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Een Application Insights-resource maken
Meld u aan bij de Azure Portal en maak een Application Insights-resource.
Instellingen | Waarde | 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 werkruimteresources 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 het gebruik van een wereldwijd unieke naam de vereiste syntaxis.
Voer de juiste waarden in de vereiste velden in. Selecteer Controleren + 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 wilt koppelen aan uw telemetriegegevens. 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>]
Voorbeeld
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 over de 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-preview-opdrachten van Application Insights, 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 tekst: 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]
Voorbeeld
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"
}
Zie de Azure CLI-documentatie voor de volledige Azure CLI-documentatie voor deze opdracht en voor meer informatie over het ophalen van de instrumentatiesleutel.
Standaardeindpunten overschrijven
Waarschuwing
Wijzig eindpunten niet. Overgang naar verbindingsreeksen om de configuratie te vereenvoudigen en de noodzaak voor eindpuntwijziging te elimineren.
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_Address
en Profile_Query_Endpoint_address
vervangen door de werkelijke eindpuntadressen voor uw specifieke regio. Het einde van dit artikel bevat koppelingen naar de eindpuntadressen voor regio's waar 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 verbindingsreeksen om te profiteren van nieuwe mogelijkheden.
Wijzigingen in SDK-code
Notitie
Het applicationinsights.config-bestand wordt automatisch overschreven wanneer er 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
Op dit moment zijn de enige regio's waarvoor eindpuntwijzigingen zijn vereist Azure Government en Azure China.
Regio | Eindpuntnaam | Waarde |
---|---|---|
Azure China | Telemetriekanaal | https://dc.applicationinsights.azure.cn/v2/track |
Azure China | QuickPulse (live metrische gegevens) | 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 metrische gegevens) | https://quickpulse.applicationinsights.us/QuickPulseService.svc |
Azure Government | Profielquery | https://dc.applicationinsights.us/api/profiles/{0}/appId |
Als u momenteel de Application Insights REST API gebruikt, die normaal gesproken toegankelijk is via api.applicationinsights.io
, moet u een eindpunt gebruiken dat lokaal is in uw regio.
Regio | Eindpuntnaam | Waarde |
---|---|---|
Azure China | REST-API | api.applicationinsights.azure.cn |
Azure Government | REST-API | api.applicationinsights.us |
Volgende stappen
- Diagnostische zoekopdrachten gebruiken.
- Metrische gegevens verkennen.
- Log Analytics-query's schrijven.
- Zie de gedetailleerde richtlijnen voor azure-bewaking en -beheer voor meer informatie over de aangepaste wijzigingen voor Azure Government.
- Zie het Azure China Playbook voor meer informatie over Azure China.