Beheeroplossing voor Application Insights-connector (afgeschaft)
Notitie
Met de ondersteuning van query's voor meerdere resources is de beheeroplossing van de Application Insights-connector niet meer vereist. Het is afgeschaft en verwijderd uit Azure Marketplace, samen met de OMS-portal die op 15 januari 2019 officieel is afgeschaft voor de commerciële Azure-cloud. Deze wordt op 30 maart 2019 buiten gebruik gesteld voor de Azure-cloud van de Amerikaanse overheid.
Bestaande verbindingen blijven werken tot 30 juni 2019. Met het afschaffen van de OMS-portal is het niet mogelijk om bestaande verbindingen uit de portal te configureren en te verwijderen. Zie De connector verwijderen met PowerShell hieronder voor een script over het gebruik van PowerShell om bestaande verbindingen te verwijderen.
Zie Meerdere Azure Monitor Application Insights-resources samenvoegen voor hulp bij het uitvoeren van query's op Application Insights-logboekgegevens voor meerdere toepassingen. Zie OMS-portal verplaatsen naar Azure voor meer informatie over het afschaffen van de OMS-portal.
Met de oplossing Application Insights Connector kunt u prestatieproblemen vaststellen en begrijpen wat gebruikers met uw app doen wanneer deze wordt bewaakt met Application Insights. Weergaven van dezelfde toepassingstelemetrie die ontwikkelaars in Application Insights zien, zijn beschikbaar in Log Analytics. Wanneer u uw Application Insights-apps echter integreert met Log Analytics, wordt de zichtbaarheid van uw toepassingen vergroot door bewerkings- en toepassingsgegevens op één plaats te hebben. Als u dezelfde weergaven hebt, kunt u samenwerken met uw app-ontwikkelaars. Met de algemene weergaven kunt u de tijd verkorten om problemen met toepassingen en platformen op te sporen en op te lossen.
Wanneer u de oplossing gebruikt, kunt u het volgende doen:
- Bekijk al uw Application Insights-apps op één locatie, zelfs wanneer ze zich in verschillende Azure-abonnementen bevinden
- Infrastructuurgegevens correleren met toepassingsgegevens
- Toepassingsgegevens visualiseren met perspectieven in zoeken in logboeken
- Draai vanuit Log Analytics-gegevens naar uw Application Insights-app in de Azure Portal
Notitie
Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.
Verbonden bronnen
In tegenstelling tot de meeste andere Log Analytics-oplossingen worden er geen gegevens verzameld voor de Application Insights-connector door agents. Alle gegevens die door de oplossing worden gebruikt, zijn rechtstreeks afkomstig van Azure.
| Verbonden bron | Ondersteund | Description |
|---|---|---|
| Windows-agents | No | De oplossing verzamelt geen informatie van Windows-agents. |
| Linux-agents | No | De oplossing verzamelt geen gegevens van Linux-agents. |
| SCOM-beheergroep | No | De oplossing verzamelt geen informatie van agents in een verbonden SCOM-beheergroep. |
| Azure Storage-account | No | Met de oplossing worden geen gegevens verzameld uit Azure Storage. |
Vereisten
- Als u toegang wilt krijgen tot application insights-connectorgegevens, moet u een Azure-abonnement hebben
- U moet ten minste één geconfigureerde Application Insights-resource hebben.
- U moet de eigenaar of inzender van de Application Insights-resource zijn.
Configuratie
- Schakel de Azure Web Apps Analytics-oplossing in vanuit de Azure Marketplace of met behulp van het proces dat wordt beschreven in Log Analytics-oplossingen toevoegen vanuit de galerie met oplossingen.
- Blader naar Azure Portal. Selecteer Alle services om Application Insights te openen. Zoek vervolgens naar Application Insights.
- Selecteer onder Abonnementen een abonnement met Application Insights-resources en selecteer vervolgens onder Naam een of meer toepassingen.
- Klik op Opslaan.
In ongeveer 30 minuten zijn gegevens beschikbaar en wordt de tegel Application Insights bijgewerkt met gegevens, zoals in de volgende afbeelding:
Andere punten om rekening mee te houden:
- U kunt Application Insights-apps slechts aan één Log Analytics-werkruimte koppelen.
- U kunt alleen Basic- of Enterprise Application Insights-resources koppelen aan Log Analytics. U kunt echter de gratis laag van Log Analytics gebruiken.
Management packs
Met deze oplossing worden geen management packs in verbonden beheergroepen geïnstalleerd.
De oplossing gebruiken
In de volgende secties wordt beschreven hoe u de secties in het Application Insights-dashboard kunt gebruiken om gegevens van uw apps weer te geven en ermee te werken.
Application Insights-connectorgegevens weergeven
Klik op de tegel Application Insights om het Application Insights-dashboard te openen om de volgende secties weer te geven.
Het dashboard bevat de secties die in de tabel worden weergegeven. Elke sectie bevat maximaal 10 items die overeenkomen met de criteria van die sectie voor het opgegeven bereik en tijdsbereik. U kunt een zoekopdracht in logboeken uitvoeren die alle records retourneert wanneer u klikt op Alles weergeven onderaan de sectie of wanneer u op de sectiekop klikt.
| Kolom | Beschrijving |
|---|---|
| Toepassingen - Aantal toepassingen | Toont het aantal toepassingen in Toepassingsresources. Geeft ook de namen van toepassingen weer en voor elke toepassing het aantal toepassingsrecords. Klik op het nummer om een zoekopdracht in logboeken uit te voeren ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by ApplicationName Klik op een toepassingsnaam om een logboekzoekactie uit te voeren voor de toepassing waarin toepassingsrecords per host, records per telemetrietype en alle gegevens per type (gebaseerd op de laatste dag) worden weergegeven. |
| Gegevensvolume : hosts die gegevens verzenden | Toont het aantal computerhosts dat gegevens verzendt. Geeft ook computerhosts en het aantal records voor elke host weer. Klik op het nummer om een zoekopdracht in logboeken uit te voeren ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by Host Klik op een computernaam om een logboekzoekopdracht uit te voeren voor de host waarin toepassingsrecords per host, records op telemetrietype en alle gegevens per type (op basis van de laatste dag) worden weergegeven. |
| Beschikbaarheid – Webtestresultaten | Hiermee wordt een ringdiagram weergegeven voor webtestresultaten, waarin geslaagd of mislukt wordt aangegeven. Klik op de grafiek om een zoekopdracht in logboeken uit te voeren ApplicationInsights | where TelemetryType == "Availability" | summarize AggregatedValue = sum(SampledCount) by AvailabilityResult Resultaten tonen het aantal geslaagden en fouten voor alle tests. Hier ziet u alle Web Apps met verkeer voor het laatste moment. Klik op de naam van een toepassing om een zoekopdracht in logboeken weer te geven met details van mislukte webtests. |
| Serveraanvragen : aanvragen per uur | Toont een lijndiagram van de serveraanvragen per uur voor verschillende toepassingen. Beweeg de muisaanwijzer over een lijn in de grafiek om de drie belangrijkste toepassingen te zien die aanvragen voor een bepaald tijdstip ontvangen. Geeft ook een lijst weer van de toepassingen die aanvragen ontvangen en het aantal aanvragen voor de geselecteerde periode. Klik op de grafiek om een logboekzoekopdracht ApplicationInsights | where TelemetryType == "Request" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) uit te voeren waarin een gedetailleerder lijndiagram wordt weergegeven van de serveraanvragen per uur voor verschillende toepassingen. Klik op een toepassing in de lijst om een logboekzoekactie ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true uit te voeren die een lijst met aanvragen, grafieken voor aanvragen gedurende een bepaalde periode en aanvraagduur en een lijst met antwoordcodes voor aanvragen weergeeft. |
| Fouten: mislukte aanvragen per uur | Toont een lijndiagram van mislukte toepassingsaanvragen per uur. Beweeg de muisaanwijzer over de grafiek om de drie belangrijkste toepassingen met mislukte aanvragen voor een bepaald tijdstip te zien. Toont ook een lijst met toepassingen met het aantal mislukte aanvragen voor elk. Klik op de grafiek om een logboekzoekactie uit te voeren die ApplicationInsights | where TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) een gedetailleerder lijndiagram met mislukte toepassingsaanvragen weergeeft. Klik op een item in de lijst om een logboekzoekactie ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true uit te voeren waarin mislukte aanvragen, grafieken voor mislukte aanvragen in de loop van de tijd en de duur van de aanvraag en een lijst met antwoordcodes voor mislukte aanvragen worden weergegeven. |
| Uitzonderingen : uitzonderingen per uur | Toont een lijndiagram met uitzonderingen per uur. Beweeg de muisaanwijzer over de grafiek om de 3 beste toepassingen met uitzonderingen voor een bepaald tijdstip weer te geven. Toont ook een lijst met toepassingen met het aantal uitzonderingen voor elke toepassing. Klik op de grafiek om een zoekopdracht ApplicationInsights | where TelemetryType == "Exception" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) in logboeken uit te voeren waarin een gedetailleerdere koppelingsgrafiek met uitzonderingen wordt weergegeven. Klik op een item in de lijst om een logboekzoekactie ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Exception" uit te voeren die een lijst met uitzonderingen, grafieken voor uitzonderingen in de loop van de tijd en mislukte aanvragen en een lijst met uitzonderingstypen weergeeft. |
Het Application Insights-perspectief weergeven met zoeken in logboeken
Wanneer u op een item in het dashboard klikt, ziet u een Application Insights-perspectief dat wordt weergegeven in de zoekfunctie. Het perspectief biedt een uitgebreide visualisatie, op basis van het geselecteerde telemetrietype. Visualisatie-inhoud wordt dus gewijzigd voor verschillende telemetrietypen.
Wanneer u ergens in de sectie Toepassingen klikt, ziet u het standaardperspectief Toepassingen .
Het perspectief toont een overzicht van de toepassing die u hebt geselecteerd.
In de sectie Beschikbaarheid ziet u een andere perspectiefweergave waarin u webtestresultaten en gerelateerde mislukte aanvragen kunt zien.
Wanneer u ergens in de sectie Serveraanvragen of -fouten klikt, worden de perspectiefonderdelen gewijzigd om u een visualisatie te geven die betrekking heeft op aanvragen.
Wanneer u ergens in de sectie Uitzonderingen klikt, ziet u een visualisatie die is afgestemd op uitzonderingen.
Ongeacht of u op iets klikt op het Dashboard van de Application Insights-connector , op de pagina Zoeken zelf, geeft elke query die Application Insights-gegevens retourneert, het Application Insights-perspectief weer. Als u bijvoorbeeld Application Insights-gegevens bekijkt, wordt in een * query ook het tabblad Perspectief weergegeven, zoals in de volgende afbeelding:
Perspectiefonderdelen worden bijgewerkt, afhankelijk van de zoekquery. Dit betekent dat u de resultaten kunt filteren met behulp van een zoekveld waarmee u de gegevens kunt bekijken van:
- Al uw toepassingen
- Eén geselecteerde toepassing
- Een groep toepassingen
Draai naar een app in de Azure Portal
Application Insights Connector-secties zijn ontworpen om u in staat te stellen naar de geselecteerde Application Insights-app te draaien wanneer u de Azure Portal gebruikt. U kunt de oplossing gebruiken als een bewakingsplatform op hoog niveau waarmee u problemen met een app kunt oplossen. Wanneer u een mogelijk probleem ziet in een van uw verbonden toepassingen, kunt u hierop inzoomen in Log Analytics-zoekopdracht of u kunt rechtstreeks naar de Application Insights-app draaien.
Als u wilt draaien, klikt u op het beletselteken (...) dat aan het einde van elke regel wordt weergegeven en selecteert u Openen in Application Insights.
Notitie
Openen in Application Insights is niet beschikbaar in de Azure Portal.
Voorbeeldgegevens gecorrigeerd
Application Insights biedt correctie van steekproeven om telemetrieverkeer te verminderen. Wanneer u steekproeven inschakelt in uw Application Insights-app, krijgt u een verminderd aantal vermeldingen opgeslagen, zowel in Application Insights als in Log Analytics. Hoewel gegevensconsistentie behouden blijft op de pagina Application Insights Connector en perspectieven, moet u de steekproefgegevens voor uw aangepaste query's handmatig corrigeren.
Hier volgt een voorbeeld van steekproefcorrectie in een logboekzoekquery:
ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by TelemetryType
Het veld Sampled Count is aanwezig in alle vermeldingen en geeft het aantal gegevenspunten weer dat de vermelding vertegenwoordigt. Als u steekproeven inschakelt voor uw Application Insights-app, is het aantal voorbeelden groter dan 1. Als u het werkelijke aantal vermeldingen wilt tellen dat door uw toepassing wordt gegenereerd, telt u de velden Sampled Count op.
Steekproeven zijn alleen van invloed op het totale aantal vermeldingen dat door uw toepassing wordt gegenereerd. U hoeft steekproeven niet te corrigeren voor metrische velden zoals RequestDuration of AvailabilityDuration , omdat deze velden het gemiddelde voor weergegeven vermeldingen weergeven.
Invoergegevens
De oplossing ontvangt de volgende telemetrietypen van uw verbonden Application Insights-apps:
- Beschikbaarheid
- Uitzonderingen
- Aanvragen
- Paginaweergaven: als u wilt dat uw werkruimte paginaweergaven ontvangt, moet u uw apps configureren om die gegevens te verzamelen. Zie PageViews voor meer informatie.
- Aangepaste gebeurtenissen: als u wilt dat uw werkruimte aangepaste gebeurtenissen ontvangt, moet u uw apps configureren om die gegevens te verzamelen. Zie TrackEvent voor meer informatie.
Gegevens worden door Log Analytics ontvangen van Application Insights zodra deze beschikbaar zijn.
Uitvoergegevens
Voor elk type invoergegevens wordt een record met een typeApplicationInsights gemaakt. ApplicationInsights-records hebben eigenschappen die worden weergegeven in de volgende secties:
Algemene velden
| Eigenschap | Beschrijving |
|---|---|
| Type | ApplicationInsights |
| ClientIP | |
| TimeGenerated | Tijd van de record |
| ApplicationID | Instrumentatiesleutel van de Application Insights-app |
| ApplicationName | Naam van de Application Insights-app |
| RoleInstance | Id van serverhost |
| DeviceType | Clientapparaat |
| ScreenResolution | |
| Continent | Continent waarvan de aanvraag afkomstig is |
| Land/regio | Land/regio waar de aanvraag afkomstig is |
| Provincie | Provincie, staat of land waar de aanvraag afkomstig is |
| Plaats | Plaats of plaats waar de aanvraag afkomstig is |
| isSynthetic | Hiermee wordt aangegeven of de aanvraag is gemaakt door een gebruiker of door een geautomatiseerde methode. True = geautomatiseerde methode of onwaar = door gebruiker gegenereerd |
| SamplingRate | Percentage telemetrie dat wordt gegenereerd door de SDK dat naar de portal wordt verzonden. Bereik 0.0-100.0. |
| SampledCount | 100/(SamplingRate). Bijvoorbeeld: 4 => 25% |
| IsAuthenticated | Waar of onwaar |
| OperationID | Items met dezelfde bewerkings-id worden weergegeven als Gerelateerde items in de portal. Meestal de aanvraag-id |
| ParentOperationID | Id van de bovenliggende bewerking |
| OperationName | |
| Sessionid | GUID voor unieke identificatie van de sessie waarin de aanvraag is gemaakt |
| SourceSystem | ApplicationInsights |
Beschikbaarheidsspecifieke velden
| Eigenschap | Beschrijving |
|---|---|
| TelemetryType | Beschikbaarheid |
| AvailabilityTestName | Naam van de webtest |
| AvailabilityRunLocation | Geografische bron van HTTP-aanvraag |
| AvailabilityResult | Geeft het succesresultaat van de webtest aan |
| AvailabilityMessage | Het bericht dat is gekoppeld aan de webtest |
| AvailabilityCount | 100/(Steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| DataSizeMetricValue | 1.0 of 0.0 |
| DataSizeMetricCount | 100/(Steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| AvailabilityDuration | Tijd, in milliseconden, van de duur van de webtest |
| AvailabilityDurationCount | 100/(Steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| AvailabilityValue | |
| AvailabilityMetricCount | |
| AvailabilityTestId | Unieke GUID voor het webtest |
| AvailabilityTimestamp | Exacte tijdstempel van de beschikbaarheidstest |
| AvailabilityDurationMin | Voor records met steekproef toont dit veld de minimale webtestduur (milliseconden) voor de weergegeven gegevenspunten |
| AvailabilityDurationMax | Voor records met steekproef toont dit veld de maximale webtestduur (milliseconden) voor de weergegeven gegevenspunten |
| AvailabilityDurationStdDev | Voor steekproefrecords toont dit veld de standaarddeviatie tussen alle webtestduur (milliseconden) voor de weergegeven gegevenspunten |
| AvailabilityMin | |
| Beschikbaarheidmax | |
| AvailabilityStdDev |
Uitzonderingsspecifieke velden
| Type | ApplicationInsights |
|---|---|
| TelemetryType | Uitzondering |
| ExceptionType | Type uitzondering |
| ExceptionMethod | De methode waarmee de uitzondering wordt gemaakt |
| ExceptionAssembly | Assembly bevat het framework en de versie, evenals het token voor de openbare sleutel |
| ExceptionGroup | Type uitzondering |
| ExceptionHandledAt | Geeft het niveau aan dat de uitzondering heeft verwerkt |
| ExceptionCount | 100/(Steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| ExceptionMessage | Bericht van de uitzondering |
| ExceptionStack | Volledige stack van de uitzondering |
| ExceptionHasStack | Waar, als de uitzondering een stack heeft |
Aanvraagspecifieke velden
| Eigenschap | Beschrijving |
|---|---|
| Type | ApplicationInsights |
| TelemetryType | Aanvraag |
| ResponseCode | HTTP-antwoord verzonden naar client |
| RequestSuccess | Geeft aan dat het wel of niet lukt. Waar of onwaar. |
| RequestID | Id om de aanvraag uniek te identificeren |
| RequestName | GET/POST + URL-basis |
| RequestDuration | Tijd, in seconden, van de aanvraagduur |
| URL | URL van de aanvraag zonder host |
| Host | Webserverhost |
| URLBase | Volledige URL van de aanvraag |
| ApplicationProtocol | Type protocol dat door de toepassing wordt gebruikt |
| RequestCount | 100/(Steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| RequestDurationCount | 100/(steekproeffrequentie). Bijvoorbeeld: 4 => 25% |
| RequestDurationMin | Voor steekproefrecords toont dit veld de minimale aanvraagduur (milliseconden) voor de weergegeven gegevenspunten. |
| RequestDurationMax | Voor steekproefrecords toont dit veld de maximale aanvraagduur (milliseconden) voor de weergegeven gegevenspunten |
| RequestDurationStdDev | Voor steekproefrecords toont dit veld de standaarddeviatie tussen alle aanvraagduur (milliseconden) voor de weergegeven gegevenspunten |
Voorbeeldzoekopdrachten in logboeken
Deze oplossing heeft geen set voorbeeldzoekopdrachten in logboeken die op het dashboard worden weergegeven. Voorbeeldquery's voor zoeken in logboeken met beschrijvingen worden echter weergegeven in de sectie Application Insights Connector-gegevens weergeven .
De connector verwijderen met PowerShell
Met het afschaffen van de OMS-portal is het niet mogelijk om bestaande verbindingen uit de portal te configureren en te verwijderen. U kunt bestaande verbindingen verwijderen met het volgende PowerShell-script. U moet de eigenaar of inzender zijn van de werkruimte en de lezer van de Application Insights-resource om deze bewerking uit te voeren.
$Subscription_app = "App Subscription Name"
$ResourceGroup_app = "App ResourceGroup"
$Application = "Application Name"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
Connect-AzAccount
Set-AzContext -SubscriptionId $Subscription_app
$AIApp = Get-AzApplicationInsights -ResourceGroupName $ResourceGroup_app -Name $Application
Set-AzContext -SubscriptionId $Subscription_workspace
Remove-AzOperationalInsightsDataSource -WorkspaceName $Workspace -ResourceGroupName $ResourceGroup_workspace -Name $AIApp.Id
U kunt een lijst met toepassingen ophalen met behulp van het volgende PowerShell-script waarmee een REST API-aanroep wordt aangeroepen.
Connect-AzAccount
$Tenant = "TenantId"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
$AccessToken = "AAD Authentication Token"
Set-AzContext -SubscriptionId $Subscription_workspace
$LAWorkspace = Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup_workspace -Name $Workspace
$Headers = @{
"Authorization" = "Bearer $($AccessToken)"
"x-ms-client-tenant-id" = $Tenant
}
$Connections = Invoke-RestMethod -Method "GET" -Uri "https://management.azure.com$($LAWorkspace.ResourceId)/dataSources/?%24filter=kind%20eq%20'ApplicationInsights'&api-version=2015-11-01-preview" -Headers $Headers
$ConnectionsJson = $Connections | ConvertTo-Json
Voor dit script is een Bearer-verificatietoken vereist voor verificatie met Azure Active Directory. Een manier om dit token op te halen is met behulp van een artikel op de REST API-documentatiesite. Klik op Uitproberen en meld u aan bij uw Azure-abonnement. U kunt het bearer-token kopiëren uit de aanvraagvoorbeeld , zoals wordt weergegeven in de volgende afbeelding.
U kunt ook een lijst met toepassingen ophalen met een logboekquery:
ApplicationInsights | summarize by ApplicationName
Volgende stappen
- Gebruik Zoeken in logboeken om gedetailleerde informatie voor uw Application Insights-apps weer te geven.