Hanteringslösning för Application Insights-anslutningsappen (inaktuell)
Anteckning
Med stöd för frågor mellan resurser krävs inte längre hanteringslösningen för Application Insights Connector. Det har blivit inaktuellt och tagits bort från Azure Marketplace, tillsammans med OMS-portalen som officiellt blev inaktuell den 15 januari 2019 för det kommersiella Azure-molnet. Den dras tillbaka den 30 mars 2019 för Azure US Government-molnet.
Befintliga anslutningar fortsätter att fungera fram till den 30 juni 2019. Med utfasning av OMS-portalen finns det inget sätt att konfigurera och ta bort befintliga anslutningar från portalen. Se Ta bort anslutningsappen med PowerShell nedan för ett skript om hur du använder PowerShell för att ta bort befintliga anslutningar.
Vägledning om hur du kör frågor mot Application Insights-loggdata för flera program finns i Förena flera Azure Monitor Application Insights-resurser. Mer information om utfasningen av OMS-portalen finns i FLYTTA OMS-portalen till Azure.
Lösningen för Application Insights Connector hjälper dig att diagnostisera prestandaproblem och förstå vad användare gör med din app när den övervakas med Application Insights. Vyer av samma programtelemetri som utvecklare ser i Application Insights är tillgängliga i Log Analytics. Men när du integrerar Dina Application Insights-appar med Log Analytics ökar synligheten för dina program genom att du har åtgärds- och programdata på ett och samma ställe. Med samma vyer kan du samarbeta med dina apputvecklare. De gemensamma vyerna kan hjälpa till att minska tiden för att identifiera och lösa både program- och plattformsproblem.
När du använder lösningen kan du:
- Visa alla dina Application Insights-appar på ett och samma ställe, även om de finns i olika Azure-prenumerationer
- Korrelera infrastrukturdata med programdata
- Visualisera programdata med perspektiv i loggsökning
- Pivotera från Log Analytics-data till din Application Insights-app i Azure Portal
Anteckning
Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Se Installera Azure PowerShell för att komma igång. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.
Anslutna källor
Till skillnad från de flesta andra Log Analytics-lösningar samlas inte data in för Application Insights Connector av agenter. Alla data som används av lösningen kommer direkt från Azure.
| Ansluten källa | Stöds | Description |
|---|---|---|
| Windows-agenter | No | Lösningen samlar inte in information från Windows-agenter. |
| Linux-agenter | No | Lösningen samlar inte in information från Linux-agenter. |
| SCOM-hanteringsgrupp | No | Lösningen samlar inte in information från agenter i en ansluten SCOM-hanteringsgrupp. |
| Azure Storage-konto | No | Lösningen samlingar inte information från Azure Storage. |
Förutsättningar
- Om du vill komma åt information om Application Insights Connector måste du ha en Azure-prenumeration
- Du måste ha minst en konfigurerad Application Insights-resurs.
- Du måste vara ägare eller deltagare i Application Insights-resursen.
Konfiguration
- Aktivera Azure Web Apps Analytics-lösningen från Azure Marketplace eller med hjälp av processen som beskrivs i Lägg till Log Analytics-lösningar från lösningsgalleriet.
- Bläddra till Azure Portal. Välj Alla tjänster för att öppna Application Insights. Sök sedan efter Application Insights.
- Under Prenumerationer väljer du en prenumeration som har Application Insights-resurser och väljer sedan ett eller flera program under Namn.
- Klicka på Spara.
Om cirka 30 minuter blir data tillgängliga och Application Insights-panelen uppdateras med data, till exempel följande bild:
Andra saker att tänka på:
- Du kan bara länka Application Insights-appar till en Log Analytics-arbetsyta.
- Du kan bara länka Basic- eller Enterprise Application Insights-resurser till Log Analytics. Du kan dock använda den kostnadsfria nivån för Log Analytics.
Hanteringspaket
Den här lösningen installerar inga hanteringspaket i anslutna hanteringsgrupper.
Använda lösningen
I följande avsnitt beskrivs hur du kan använda avsnitten som visas på Application Insights-instrumentpanelen för att visa och interagera med data från dina appar.
Visa information om Application Insights Connector
Klicka på Application Insights-panelen för att öppna Application Insights-instrumentpanelen för att se följande avsnitt.
Instrumentpanelen innehåller de avsnitt som visas i tabellen. Varje avsnitt listar upp till 10 objekt som matchar avsnittets villkor för det angivna omfånget och tidsintervallet. Du kan köra en loggsökning som returnerar alla poster när du klickar på Visa alla längst ned i avsnittet eller när du klickar på avsnittsrubriken.
| Kolumn | Beskrivning |
|---|---|
| Program – Antal program | Visar antalet program i programresurser. Visar även programnamn och för varje, antalet programposter. Klicka på numret för att köra en loggsökning efter ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by ApplicationName Klicka på ett programnamn om du vill köra en loggsökning för programmet som visar programposter per värd, poster efter telemetrityp och alla data efter typ (baserat på den senaste dagen). |
| Datavolym – värdar som skickar data | Visar antalet datorvärdar som skickar data. Visar även datorvärdar och antal poster för varje värd. Klicka på numret för att köra en loggsökning efter ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by Host Klicka på ett datornamn för att köra en loggsökning efter värden som visar programposter per värd, poster efter telemetrityp och alla data efter typ (baserat på den senaste dagen). |
| Tillgänglighet – Webbtestresultat | Visar ett ringdiagram för webbtestresultat, vilket indikerar att det har godkänts eller misslyckats. Klicka på diagrammet för att köra en loggsökning efter ApplicationInsights | where TelemetryType == "Availability" | summarize AggregatedValue = sum(SampledCount) by AvailabilityResult Resultaten visar antalet pass och fel för alla tester. Den visar alla Web Apps med trafik för den sista minuten. Klicka på ett programnamn om du vill visa en loggsökning som visar information om misslyckade webbtester. |
| Serverbegäranden – begäranden per timme | Visar ett linjediagram över serverbegäranden per timme för olika program. Hovra över en linje i diagrammet för att se de tre främsta programmen som tar emot begäranden för en tidpunkt. Visar också en lista över de program som tar emot begäranden och antalet begäranden för den valda perioden. Klicka på diagrammet för att köra en loggsökning för ApplicationInsights | where TelemetryType == "Request" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) som visar ett mer detaljerat linjediagram över serverbegäranden per timme för olika program. Klicka på ett program i listan för att köra en loggsökning för som visar en lista över begäranden, diagram för begäranden över tid och varaktighet för begäranden samt en lista över svarskoder för ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true begäranden. |
| Fel – Misslyckade begäranden per timme | Visar ett linjediagram över misslyckade programbegäranden per timme. Hovra över diagrammet för att se de tre främsta programmen med misslyckade begäranden för en viss tidpunkt. Visar också en lista över program med antalet misslyckade begäranden för var och en. Klicka på diagrammet för att köra en loggsökning för ApplicationInsights | where TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) som visar ett mer detaljerat linjediagram över misslyckade programbegäranden. Klicka på ett objekt i listan för att köra en loggsökning för som visar misslyckade begäranden, diagram för misslyckade begäranden över tid och varaktighet för begäran och en lista över misslyckade svarskoder för ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true begäranden. |
| Undantag – undantag per timme | Visar ett linjediagram över undantag per timme. Hovra över diagrammet för att se de tre främsta programmen med undantag för en viss tidpunkt. Visar också en lista över program med antalet undantag för var och en. Klicka på diagrammet för att köra en loggsökning för ApplicationInsights | where TelemetryType == "Exception" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) som visar ett mer detaljerat länkdiagram över undantag. Klicka på ett objekt i listan för att köra en loggsökning för ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Exception" som visar en lista över undantag, diagram för undantag över tid och misslyckade begäranden och en lista över undantagstyper. |
Visa Application Insights-perspektivet med loggsökning
När du klickar på ett objekt på instrumentpanelen visas ett Application Insights-perspektiv i sökningen. Perspektivet ger en utökad visualisering baserat på den telemetrityp som valts. Därför ändras visualiseringsinnehållet för olika telemetrityper.
När du klickar någonstans i avsnittet Program visas standardprogramperspektivet.
Perspektivet visar en översikt över det program som du har valt.
Avsnittet Tillgänglighet visar en annan perspektivvy där du kan se webbtestresultat och relaterade misslyckade begäranden.
När du klickar någonstans i avsnitten Serverbegäranden eller Fel ändras perspektivkomponenterna så att du får en visualisering som är relaterad till begäranden.
När du klickar någonstans i avsnittet Undantag visas en visualisering som är anpassad efter undantag.
Oavsett om du klickar på något på Application Insights Connector-instrumentpanelen , på själva söksidan , visar alla frågor som returnerar Application Insights-data Application Insights-perspektivet. Om du till exempel visar Application Insights-data visar en * fråga även perspektivfliken som i följande bild:
Perspektivkomponenter uppdateras beroende på sökfrågan. Det innebär att du kan filtrera resultaten genom att använda valfritt sökfält som ger dig möjlighet att se data från:
- Alla dina program
- Ett enskilt valt program
- En grupp program
Pivotering till en app i Azure Portal
Avsnitten i Application Insights Connector är utformade så att du kan pivotera till den valda Application Insights-appen när du använder Azure Portal. Du kan använda lösningen som en övervakningsplattform på hög nivå som hjälper dig att felsöka en app. När du ser ett potentiellt problem i något av dina anslutna program kan du antingen öka detaljnivån i Log Analytics-sökningen eller så kan du pivotera direkt till Application Insights-appen.
Om du vill pivotleda klickar du på de ellipser (...) som visas i slutet av varje rad och väljer Öppna i Application Insights.
Anteckning
Öppna i Application Insights är inte tillgängligt i Azure Portal.
Exempel på korrigerade data
Application Insights tillhandahåller samplingskorrigering för att minska telemetritrafiken. När du aktiverar sampling i din Application Insights-app får du ett minskat antal poster lagrade både i Application Insights och i Log Analytics. Datakonsekvens bevaras på sidan och perspektiven för Application Insights Connector , men du bör korrigera samplade data manuellt för dina anpassade frågor.
Här är ett exempel på samplingskorrigering i en loggsökningsfråga:
ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by TelemetryType
Fältet Antal sampel finns i alla poster och visar antalet datapunkter som posten representerar. Om du aktiverar sampling för din Application Insights-app är samplingsantalet större än 1. Om du vill räkna det faktiska antalet poster som ditt program genererar summerar du fälten Antal exempel .
Sampling påverkar endast det totala antalet poster som ditt program genererar. Du behöver inte korrigera sampling för måttfält som RequestDuration eller AvailabilityDuration eftersom dessa fält visar medelvärdet för representerade poster.
Indata
Lösningen tar emot följande telemetrityper av data från dina anslutna Application Insights-appar:
- Tillgänglighet
- Undantag
- Begäranden
- Sidvisningar – För att arbetsytan ska kunna ta emot sidvisningar måste du konfigurera dina appar för att samla in den informationen. Mer information finns i PageViews.
- Anpassade händelser – För att arbetsytan ska kunna ta emot anpassade händelser måste du konfigurera dina appar för att samla in den informationen. Mer information finns i TrackEvent.
Data tas emot av Log Analytics från Application Insights när de blir tillgängliga.
Utdata
En post med en typ av ApplicationInsights skapas för varje typ av indata. ApplicationInsights-poster har egenskaper som visas i följande avsnitt:
Allmänna fält
| Egenskap | Beskrivning |
|---|---|
| Typ | ApplicationInsights |
| ClientIP | |
| TimeGenerated | Tid för posten |
| ApplicationId | Instrumenteringsnyckel för Application Insights-appen |
| ApplicationName | Namnet på Application Insights-appen |
| RoleInstance | ID för servervärd |
| DeviceType | Klientenhet |
| ScreenResolution | |
| Kontinent | Kontinent där begäran kom från |
| Land | Land/region där begäran kom från |
| Provinsen | Provins, delstat eller nationella inställningar där begäran har sitt ursprung |
| City | Ort där begäran kom från |
| isSynthetic | Anger om begäran skapades av en användare eller med automatiserad metod. True = automated method or false = user generated |
| SamplingRate | Procentandel telemetri som genereras av SDK:t som skickas till portalen. Intervall 0.0-100.0. |
| SampledCount | 100/(SamplingRate). Till exempel 4 => 25 % |
| IsAuthenticated | Sant eller falskt |
| OperationID | Objekt som har samma åtgärds-ID visas som relaterade objekt i portalen. Vanligtvis begärande-ID |
| ParentOperationID | ID för den överordnade åtgärden |
| OperationName | |
| Sessionid | GUID för att unikt identifiera sessionen där begäran skapades |
| SourceSystem | ApplicationInsights |
Tillgänglighetsspecifika fält
| Egenskap | Beskrivning |
|---|---|
| Telemetrityp | Tillgänglighet |
| AvailabilityTestName | Namnet på webbtestet |
| AvailabilityRunLocation | Geografisk källa för http-begäran |
| AvailabilityResult | Anger resultatet av webbtestet |
| AvailabilityMessage | Meddelandet som är kopplat till webbtestet |
| AvailabilityCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| DataSizeMetricValue | 1.0 eller 0.0 |
| DataSizeMetricCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| AvailabilityDuration | Tid, i millisekunder, för webbtestets varaktighet |
| AvailabilityDurationCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| AvailabilityValue | |
| AvailabilityMetricCount | |
| AvailabilityTestId | Unikt GUID för webbtestet |
| AvailabilityTimestamp | Exakt tidsstämpel för tillgänglighetstestet |
| AvailabilityDurationMin | För exempelposter visar det här fältet den minsta webbtestvaraktigheten (millisekunder) för de representerade datapunkterna |
| AvailabilityDurationMax | För exempelposter visar det här fältet den maximala webbtestvaraktigheten (millisekunder) för de representerade datapunkterna |
| AvailabilityDurationStdDev | För exempelposter visar det här fältet standardavvikelsen mellan alla webbtestvaraktighet (millisekunder) för de representerade datapunkterna |
| AvailabilityMin | |
| AvailabilityMax | |
| AvailabilityStdDev |
Undantagsspecifika fält
| Typ | ApplicationInsights |
|---|---|
| Telemetrityp | Undantag |
| ExceptionType | Typ av undantag |
| ExceptionMethod | Metoden som skapar undantaget |
| ExceptionAssembly | Sammansättning innehåller ramverket och versionen samt den offentliga nyckeltoken |
| ExceptionGroup | Typ av undantag |
| ExceptionHandledAt | Anger den nivå som hanterade undantaget |
| ExceptionCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| ExceptionMessage | Meddelande om undantaget |
| ExceptionStack | Fullständig stack för undantaget |
| ExceptionHasStack | Sant, om undantaget har en stack |
Fält som är specifika för begäran
| Egenskap | Beskrivning |
|---|---|
| Typ | ApplicationInsights |
| Telemetrityp | Förfrågan |
| ResponseCode | HTTP-svar skickas till klienten |
| RequestSuccess | Anger lyckad eller misslyckad. Sant eller falskt. |
| RequestID | ID för att unikt identifiera begäran |
| RequestName | GET/POST + URL-bas |
| RequestDuration | Tid, i sekunder, för begärandevaraktighet |
| URL | URL för begäran som inte inkluderar värden |
| Värd | Webbservervärd |
| URLBase | Fullständig URL för begäran |
| ApplicationProtocol | Typ av protokoll som används av programmet |
| RequestCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| RequestDurationCount | 100/(Samplingsfrekvens). Till exempel 4 => 25 % |
| RequestDurationMin | För exempelposter visar det här fältet den minsta varaktigheten för begäran (millisekunder) för de representerade datapunkterna. |
| RequestDurationMax | För exempelposter visar det här fältet den maximala varaktigheten för begäran (millisekunder) för de representerade datapunkterna |
| RequestDurationStdDev | För exempelposter visar det här fältet standardavvikelsen mellan alla varaktigheter för begäran (millisekunder) för de representerade datapunkterna |
Exempel på loggsökningar
Den här lösningen har ingen uppsättning exempelloggsökningar som visas på instrumentpanelen. Exempel på loggsökningsfrågor med beskrivningar visas dock i avsnittet Visa Application Insights Connector-information .
Ta bort anslutningsappen med PowerShell
Med utfasning av OMS-portalen finns det inget sätt att konfigurera och ta bort befintliga anslutningar från portalen. Du kan ta bort befintliga anslutningar med följande PowerShell-skript. Du måste vara ägare eller deltagare i arbetsytan och läsaren av Application Insights-resursen för att utföra den här åtgärden.
$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
Du kan hämta en lista över program med hjälp av följande PowerShell-skript som anropar ett REST API-anrop.
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
Det här skriptet kräver en ägarautentiseringstoken för autentisering mot Azure Active Directory. Ett sätt att hämta den här token är att använda en artikel på REST API-dokumentationswebbplatsen. Klicka på Prova och logga in på din Azure-prenumeration. Du kan kopiera ägartoken från förhandsversionen av begäran enligt följande bild.
Du kan också hämta en lista över program med hjälp av en loggfråga:
ApplicationInsights | summarize by ApplicationName
Nästa steg
- Använd Loggsökning för att visa detaljerad information för dina Application Insights-appar.