Programkarta: Sortera distribuerade program

Utvecklare använder programkartor för att representera den logiska strukturen för sina distribuerade program. En karta skapas genom att identifiera de enskilda programkomponenterna med deras roleName eller name egenskapen i inspelad telemetri. Cirklar (eller noder) på kartan representerar komponenter och riktningslinjer (anslutningsappar eller kanter) som visar HTTP-anrop från källnoder till målnoder.

Azure Monitor innehåller funktionen Programkarta som hjälper dig att snabbt implementera en karta och upptäcka flaskhalsar i prestanda eller felpunkter för alla komponenter. Varje kartnod är en programkomponent eller dess beroenden och ger hälso-KPI och aviseringsstatus. Du kan välja valfri nod för att se detaljerad diagnostik för komponenten, till exempel Application Insights-händelser. Om din app använder Azure-tjänster kan du också välja Azure-diagnostik, till exempel rekommendationer för SQL Database Advisor.

Programkartan innehåller även en intelligent vy för att underlätta snabba tjänstehälsoanalyser.

Förstå komponenter

Komponenter är oberoende distributionsbara delar av ditt distribuerade program eller mikrotjänstprogram. Utvecklare och driftsteam har synlighet på kodnivå eller åtkomst till telemetri som genereras av dessa programkomponenter.

Några saker att tänka på när det gäller komponenter:

• Komponenter skiljer sig från "observerade" externa beroenden, till exempel Azure SQL och Azure Event Hubs, som ditt team eller din organisation kanske inte har åtkomst till (kod eller telemetri).
• Komponenter körs på valfritt antal server-, roll- eller containerinstanser.
• Komponenter kan vara separata Application Insights-resurser, även om prenumerationerna skiljer sig åt. De kan också vara olika roller som rapporterar till en enda Application Insights-resurs. Förhandsgranskningskartan visar komponenterna oavsett hur de har konfigurerats.

Utforska programkarta

Med programkarta kan du se den fullständiga programtopologin över flera nivåer av relaterade programkomponenter. Som tidigare beskrivits kan komponenter vara olika Application Insights-resurser, beroende komponenter eller olika roller i en enda resurs. Programkartan letar upp komponenter genom att följa HTTP-beroendeanrop som görs mellan servrar med Application Insights SDK installerat.

Mappningsupplevelsen börjar med den progressiva identifieringen av komponenterna i programmet och deras beroenden. När du först läser in programkartan utlöses en frågeuppsättning för att identifiera de komponenter som är relaterade till huvudkomponenten. När komponenter identifieras visar ett statusfält det aktuella antalet identifierade komponenter:

I följande avsnitt beskrivs några av de åtgärder som är tillgängliga för att arbeta med programkartan i Azure Portal.

Uppdatera kartkomponenter

Alternativet Uppdatera kartkomponenter utlöser identifiering av komponenter och uppdaterar kartan för att visa alla aktuella noder. Beroende på programmets komplexitet kan det ta en minut att läsa in uppdateringen:

När alla programkomponenter är roller i en enda Application Insights-resurs krävs inte identifieringssteget. Den inledande belastningen i det här programscenariot identifierar alla komponenter.

Visa komponentinformation

Ett viktigt mål för programkartan är att hjälpa dig att visualisera komplexa topologier som har hundratals komponenter. I det här scenariot är det användbart att förbättra kartvyn med information om en enskild nod med hjälp av alternativet Visa information . Informationspanelen för noden visar relaterade insikter, prestanda och felsökningsupplevelse för den valda komponenten.

Varje avsnitt i fönstret innehåller ett alternativ för att se mer information i en utökad vy, inklusive fel, prestanda och information om misslyckade begäranden och beroenden.

Undersök misslyckanden

I fönstret med nodinformation kan du använda alternativet Undersök fel för att visa alla fel för komponenten:

Med vyn Fel kan du utforska feldata för åtgärder, beroenden, undantag och roller som är relaterade till den valda komponenten:

Undersök prestanda

I fönstret med nodinformation kan du felsöka prestandaproblem med komponenten genom att välja alternativet Undersök prestanda :

Med prestandavyn kan du utforska telemetridata för åtgärder, beroenden och roller som är anslutna till den valda komponenten:

Undersöka virtuell dator

Om komponenten finns på en virtuell dator kan du visa viktiga egenskaper för den virtuella datorn, inklusive dess namn, prenumeration, resursgrupp och operativsystem. Prestandamått som tillgänglighet, CPU-användning (genomsnitt) och tillgängligt minne (GB) visas också. Om du vill undersöka den virtuella datorns prestanda och hälsa ytterligare väljer du Gå till VM-övervakning för att öppna sidan Övervakning för den virtuella datorn.

Gå till information och stackspårning

Alternativet Gå till information i noddetaljerna visar hela transaktionsupplevelsen för komponenten. I det här fönstret kan du visa information på anropsstackens nivå:

Sidan öppnas för att visa tidslinjevyn för information:

Du kan använda alternativet Visa alla för att se stackinformationen med spårnings- och händelseinformation för komponenten:

Visa i loggar (analys)

I fönstret nodinformation kan du köra frågor mot och ytterligare undersöka programdata med alternativet Visa i loggar (analys).

På sidan Loggar (Analys) finns alternativ för att utforska dina posterna i programtelemetritabeller med inbyggda eller anpassade frågor och funktioner. Du kan arbeta med data genom att justera formatet och spara och exportera din analys:

Visa aviseringar och regler

Med alternativet Visa aviseringar i fönstret med nodinformation kan du se aktiva aviseringar:

Sidan Aviseringar visar kritiska och utlösta aviseringar:

Alternativet Aviseringsregler på sidan Aviseringar visar de underliggande regler som gör att aviseringarna utlöses:

Förstå namn och noder för molnroller

Programkartan använder egenskapen molnrollnamn för att identifiera programkomponenterna på en karta. Om du vill utforska hur molnrollnamn används med komponentnoder kan du titta på en programkarta som har flera molnrollnamn.

I följande exempel visas en karta i hierarkisk vy med fem komponentnoder och kopplingar till nio beroende noder. Varje nod har ett molnrollnamn.

Programkartan använder olika färger, markeringar och storlekar för noder för att visa programkomponentens data och relationer:

• Molnrollnamnen uttrycker de olika aspekterna av det distribuerade programmet. I det här exemplet är några av programrollerna Contoso Retail Check, Fabrikam-App, fabrikam-loadfunc, retailfabrikam-37ha6 och retailapp.

• Den streckade blå cirkeln runt en nod anger den senast valda komponenten. I det här exemplet är den senast valda komponenten Web noden.

• När du väljer en nod för att se informationen markerar en helblå cirkel noden. I exemplet är Contoso Retail Reportsden valda noden .

• Avlägsna eller orelaterade komponentnoder visas mindre jämfört med de andra noderna. Dessa objekt är nedtonade i vyn för att markera prestanda för den aktuella komponenten.

• I det här exemplet representerar varje molnrollnamn också en annan unik Application Insights-resurs med egna instrumentationsnycklar. Eftersom ägaren av det här programmet har åtkomst till var och en av dessa fyra olika Application Insights-resurser kan programkartan sammanfoga en karta över de underliggande relationerna.

Undersöka molnrollinstanser

När ett molnrollnamn avslöjar ett problem någonstans i webbklientdelen och du kör flera belastningsutjämningsservrar i webbklientdelen kan det vara bra att använda en molnrollinstans . Med programkarta kan du visa mer detaljerad information om en komponentnod med hjälp av Kusto-frågor. Du kan undersöka en nod för att visa information om specifika molnrollinstanser. Den här metoden hjälper dig att avgöra om ett problem påverkar alla webbklientdelsservrar eller endast specifika instanser.

Ett scenario där du kanske vill åsidosätta värdet för en molnrollinstans är när appen körs i en containerbaserad miljö. I det här fallet kanske information om den enskilda servern inte räcker för att hitta det specifika problemet.

Mer information om hur du åsidosätter egenskapen för molnrollnamn med telemetriinitierare finns i Lägga till egenskaper: ITelemetryInitializer.

Ange namn på molnroller

Programkartan använder egenskapen för molnrollnamn för att identifiera komponenterna på kartan. Det här avsnittet innehåller exempel för att manuellt ange eller åsidosätta molnrollnamn och ändra vad som visas på programkartan.

Information om hur du ändrar molnrollens namn och molnrollinstans manuellt finns i:

• OpenTelemetry Distro: Konfigurera Azure Monitor OpenTelemetry.
• JavaScript SDK på klientsidan: Konfigurera JavaScript SDK
• Application Insights SDK (klassiskt API): .NET och Node.js

Använd filter för applikationskarta

Med filter för programkarta kan du minska antalet synliga noder och kanter på kartan. Dessa filter kan användas för att minska kartans omfattning och visa en mindre och mer fokuserad vy.

Ett snabbt sätt att filtrera är att använda alternativet Filter på den här noden på snabbmenyn för valfri nod på kartan:

Du kan också skapa ett filter med alternativet Lägg till filter :

Välj din filtertyp (nod eller anslutningsapp) och önskade inställningar och granska sedan dina val och tillämpa dem på den aktuella kartan.

Skapa nodfilter

Med nodfilter kan du bara se vissa noder i programkartan och dölja alla andra noder. Du konfigurerar parametrar för att söka efter värden som matchar ett villkor för nodernas egenskaper på kartan. När ett nodfilter tar bort en nod tar filtret även bort alla anslutningar och kanter för noden.

Ett nodfilter har tre parametrar att konfigurera:

• Inkluderade noder: De typer av noder som ska granskas på programkartan för matchande egenskaper. Det finns fyra alternativ:

  • Noder, källor och mål: Alla noder som matchar sökvillkoren ingår i resultatkartan. Alla käll- och målnoder för matchande noder inkluderas också automatiskt i resultatkartan, även om källorna eller målen inte uppfyller sökvillkoren. Käll- och målnoderna kallas tillsammans för anslutna noder.

  • Noder och källor: Samma beteende som noder, källor och mål, men målnoder ingår inte automatiskt i resultatkartan.

  • Noder och mål: Samma beteende som noder, källor och mål, men källnoder ingår inte automatiskt i resultatkartan.

  • Endast noder: Alla noder i resultatkartan måste ha ett egenskapsvärde som matchar sökkriterierna.

• Operator: Typen av villkorstest som ska utföras på varje nods egenskapsvärden. Det finns fyra alternativ:

  • contains: Nodegenskapsvärdet innehåller det värde som anges i parametern Sökvärde .
  • !contains Nodegenskapsvärdet innehåller inte det värde som anges i parametern Sökvärde .
  • ==: Värdet för nodegenskapen är lika med det värde som anges i parametern Sökvärde .
  • !=: Värdet för nodegenskapen är inte lika med det värde som anges i parametern Sökvärde .

• Sökvärde: Textsträngen som ska användas för villkorstestet för egenskapsvärdet. Listrutan för parametern visar värden för befintliga noder i programkartan. Du kan välja ett värde i listan eller skapa ett eget värde. Ange ditt anpassade värde i parameterfältet och sedan välj Skapa alternativ ... i listan. Du kan till exempel ange test och sedan välja Skapa alternativet "test" i listan.

Följande bild visar ett exempel på ett filter som tillämpas på en programkarta som visar 30 dagars data. Filtret instruerar programkartan att söka efter noder och anslutna mål som har egenskaper som innehåller texten "retailapp":

Matchande noder och deras anslutna målnoder ingår i resultatkartan:

Skapa anslutningsfilter (edge)

Anslutningsfilter gör att du kan se enbart vissa noder med specifika anslutningar på programkarta och dölja alla andra noder och anslutningar. Du konfigurerar parametrar för att söka i kartans anslutningsegenskaper efter värden som matchar ett villkor. När en nod inte har några matchande anslutningar tar filtret bort noden från kartan.

Ett anslutningsfilter har tre parametrar att konfigurera:

• Filtrera anslutningsappar efter: De typer av anslutningsappar som ska granskas på programkartan för matchande egenskaper. Det finns fyra alternativ. Ditt val styr de tillgängliga alternativen för de andra två parametrarna.

• Operator: Typen av villkorstest som ska utföras på varje anslutnings värde.

• Värde: Jämförelsevärdet som ska användas för villkorstestet för egenskapsvärdet. Listrutan för parametern innehåller värden som är relevanta för den aktuella programkartan. Du kan välja ett värde i listan eller skapa ett eget värde. Du kan till exempel ange 16 och sedan välja Skapa alternativ "16" i listan.

I följande tabell sammanfattas konfigurationsalternativen baserat på ditt val för Filteranslutningar efter-parametern.

Percentilindikatorer för värde

När du filtrerar anslutningar efter felfrekvens, genomsnittlig samtalsvaraktighet eller antal anrop innehåller vissa alternativ för parametern Värde(Pxx) beteckningen. Den här indikatorn visar percentilnivån. För ett genomsnittligt anropsvaraktighetsfilter kan du se värdet 200 (P90). Det här alternativet innebär att 90 % av alla kontakter (oavsett hur många samtal de representerar) har mindre än 200 ms samtalstid.

Du kan se de värdealternativ som innehåller percentilnivån genom att ange P i parameterfältet.

Granska dina filter

När du har valt visar avsnittet Granska i popup-fönstret Lägg till filter textbeskrivningar och visuella beskrivningar om filtret. Sammanfattningsvisningen kan hjälpa dig att förstå hur filtret gäller för programkartan.

I följande exempel visas granskningssammanfattningen för ett nodfilter som söker efter noder och mål med egenskaper som har texten "-west":

Det här exemplet visar sammanfattningen för ett anslutningsfilter som söker efter anslutningar (och de noder de ansluter till) med en genomsnittlig samtalslängd som är minst 42 ms lång.

Använda filter för mappning

När du har konfigurerat och granskat filterinställningarna väljer du Använd för att skapa filtret. Du kan använda flera filter på samma programkarta. I Programkarta visas de tillämpade filtren som piller ovanför kartan:

Med åtgärden Ta bort på ett filterpiller kan du ta bort ett filter. När du tar bort ett tillämpat filter uppdateras kartvyn för att subtrahera filterlogik.

Programkartan tillämpar filterlogik på kartan sekventiellt, med början från det vänstra filtret i listan. När filter tillämpas tas noder och kopplingar bort från kartans vy. När en nod eller anslutning har tagits bort från vyn kan ett efterföljande filter inte återställa objektet.

Du kan ändra inställningarna för ett tillämpat filter genom att välja filterelementet. När du ändrar filterinställningarna visar programkartan en förhandsgranskning av kartvyn med den nya filterlogik. Om du bestämmer dig för att inte tillämpa ändringarna kan du använda alternativet Avbryt för den aktuella kartvyn och filtren.

Utforska och spara filter

När du upptäcker ett intressant filter kan du spara filtret för att återanvända det senare med alternativet Kopiera länk eller Fäst på instrumentpanelen :

• Alternativet Kopiera länk kodar alla aktuella filterinställningar i den kopierade URL:en. Du kan spara den här länken i webbläsarens bokmärken eller dela den med andra. Den här funktionen bevarar varaktighetsvärdet i filterinställningarna, men inte den absoluta tiden. När du använder länken senare kan den producerade programkartan skilja sig från den karta som fanns när länken hämtades.

• Alternativet Fäst på instrumentpanelen lägger till den aktuella programkartan på en instrumentpanel, tillsammans med dess aktuella filter. En vanlig diagnostikmetod är att fästa en karta med ett felanslutningsfilter . Du kan övervaka ditt program för noder med fel i deras HTTP-anrop.

I följande avsnitt beskrivs några vanliga filter som gäller för de flesta kartor och kan vara användbara för att fästa på en instrumentpanel.

Sök efter viktiga fel

Skapa en kartvy över endast anslutningar med fel (markerade i rött) under de senaste 24 timmarna. Filtren innehåller parametern Felanslutning kombinerat med intelligent vy:

Funktionen Intelligent vy beskrivs senare i den här artikeln.

Dölj kontakter med låg trafik

Dölj anslutningar med låg trafik och utan fel från kartvyn, så att du snabbt kan fokusera på mer betydande problem. Filtren innehåller anslutningar under de senaste 24 timmarna med ett anropsantal större än 2872 (P20):

Visa anslutningsappar med hög trafik

Visa anslutningsappar med hög trafik som också har en hög genomsnittlig samtalstid. Det här filtret kan hjälpa dig att identifiera potentiella prestandaproblem. Filtren i det här exemplet omfattar anslutningar under de senaste 24 timmarna med ett antalet anrop större än 10 854 (P50) och Genomsnittlig samtalsvaraktighet större än 578 (P80):

Leta upp komponenter efter namn

Leta upp komponenter (noder och anslutningsappar) i ditt program efter namn enligt din implementering av namngivningskonventionen för komponentegenskap roleName . Du kan använda den här metoden för att se den specifika delen av ett distribuerat program. Filtret söker efter noder, källor och mål under de senaste 24 timmarna som innehåller det angivna värdet. I det här exemplet är sökvärdet "west":

Ta bort bullriga komponenter

Definiera filter för att dölja bullriga komponenter genom att ta bort dem från kartan. Ibland kan programkomponenter ha aktiva beroende noder som producerar data som inte är nödvändiga för kartvyn. I det här exemplet söker filtret efter noder, källor och mål under de senaste 24 timmarna som inte innehåller det angivna värdet "retail":

Leta efter felbenägna anslutningsappar

Visa endast anslutningsappar som har högre felfrekvens än ett visst värde. Filtret i det här exemplet söker efter anslutningsappar under de senaste 24 timmarna som har en felfrekvens som är större än 3 %:

Utforska intelligenta vyn

Funktionen Intelligent vy för programkartan är utformad för att underlätta hälsoundersökningar av tjänster. Den använder maskininlärning för att snabbt identifiera potentiella grundorsaker till problem genom att filtrera bort brus. Maskininlärningsmodellen lär sig från programkartans historiska beteende för att identifiera dominerande mönster och avvikelser som indikerar potentiella orsaker till en incident.

I stora distribuerade program finns det alltid en viss grad av brus som kommer från "godartade" fel, vilket kan orsaka att programkartan blir bullrig genom att visa många röda kanter. Intelligent vy visar endast de mest sannolika orsakerna till tjänstfel och tar bort nod-till-nod-röda kanter (tjänst-till-tjänst-kommunikation) i felfria tjänster. Intelligent vy markerar kanterna i rött som ska undersökas. Det ger också användbara insikter för den markerade aspekten.

Det finns många fördelar med att använda intelligent vy:

• Minskar tiden till lösning genom att endast markera fel som behöver undersökas
• Ger användbara insikter om varför en viss röd kant har markerats
• Gör att programkartan kan användas för stora distribuerade program sömlöst (genom att endast fokusera på kanter markerade i rött)

Intelligent vy har vissa begränsningar:

• Stora distribuerade program kan ta en minut att läsa in.
• Tidsramar på upp till sju dagar stöds.

Arbeta med den intelligenta vyn

Med en växlingsknapp ovanför programkartan kan du aktivera Intelligent vy och styra känsligheten för problemidentifiering:

Intelligent vy använder den patenterade AIOps-maskininlärningsmodellen för att markera (röd) viktiga och viktiga data i en programkarta. Olika programdata används för att avgöra vilka data som ska markeras på kartan, inklusive felfrekvenser, antal begäranden, varaktigheter, avvikelser och beroendetyp. Som jämförelse använder standardkartvyn endast råfelfrekvensen .

Programkartan markerar kanterna i rött enligt känslighetsinställningen. Du kan justera känsligheten för att uppnå önskad konfidensnivå i de markerade kanterna.

Kontrollera användbara insikter

När du har aktiverat intelligent vy väljer du en markerad kant (röd) på kartan för att se "användbara insikter" för komponenten. Insikterna visas i ett fönster till höger och förklarar varför gränsen är markerad.

Om du vill börja felsöka ett problem väljer du Undersök fel. Du kan granska informationen om komponenten i felfönstret Fel för att avgöra om det upptäckta problemet är grundorsaken.

När intelligent vy inte markerar några kanter på programkartan hittade maskininlärningsmodellen inte potentiella incidenter i programmets beroenden.

Nästa steg

• Mer information om vår dedikerade felsökningsguide finns i Felsökning av programkarta.
• Lär dig hur korrelation fungerar i Application Insights med telemetrikorrelation.
• Utforska den transaktionsdiagnostikupplevelse från slutpunkt till slutpunkt som korrelerar telemetri på serversidan från alla dina Application Insights-övervakade komponenter till en enda vy.
• Stöd för avancerade korrelationsscenarier i ASP.NET Core och ASP.NET med Spåra anpassade åtgärder.