Application Insights-telemetridatamodell

Application Insights skickar telemetri från webbprogrammet till Azure Portal så att du kan analysera programmets prestanda och användning. Telemetrimodellen är standardiserad, så det är möjligt att skapa plattforms- och språkoberoende övervakning.

Data som samlas in av Application Insights modellerar det här typiska programkörningsmönstret.

Följande typer av telemetri används för att övervaka körningen av din app. Application Insights SDK från webbprogramramverket samlar automatiskt in följande tre typer:

• Begäran: Genereras för att logga en begäran som tas emot av din app. Application Insights webb-SDK genererar till exempel automatiskt ett telemetriobjekt för begäranden för varje HTTP-begäran som din webbapp tar emot.

  En åtgärd består av de körningstrådar som bearbetar en begäran. Du kan också skriva kod för att övervaka andra typer av åtgärder, till exempel en "aktivering" i ett webbjobb eller en funktion som regelbundet bearbetar data. Varje åtgärd har ett ID. ID:t kan användas för att gruppera all telemetri som genereras medan din app bearbetar begäran. Varje åtgärd lyckas eller misslyckas och har en varaktighet.

• Undantag: Representerar vanligtvis ett undantag som gör att en åtgärd misslyckas.

• Beroende: Representerar ett anrop från din app till en extern tjänst eller lagring, till exempel ett REST API eller SQL. I ASP.NET definieras beroendeanrop till SQL av System.Data. Anrop till HTTP-slutpunkter definieras av System.Net.

Application Insights innehåller tre datatyper för anpassad telemetri:

• Spårning: Används antingen direkt eller via ett kort för att implementera diagnostikloggning med hjälp av ett instrumentationsramverk som är bekant för dig, till exempel Log4Net eller System.Diagnostics.
• Händelse: Används vanligtvis för att samla in användarinteraktion med din tjänst för att analysera användningsmönster.
• Mått: Används för att rapportera periodiska skalärmått.

Varje telemetriobjekt kan definiera kontextinformation som programversion eller användarsessions-ID. Kontext är en uppsättning starkt inskrivna fält som avblockera vissa scenarier. När programversionen initieras korrekt kan Application Insights identifiera nya mönster i programbeteende som är korrelerade med omdistribution.

Du kan använda sessions-ID för att beräkna ett avbrott eller ett problem som påverkar användarna. När du beräknar det distinkta antalet sessions-ID-värden för ett specifikt misslyckat beroende, felspårning eller kritiskt undantag får du en god förståelse för effekten.

Application Insights-telemetrimodellen definierar ett sätt att korrelera telemetri med den åtgärd som den är en del av. En begäran kan till exempel göra ett SQL Database-anrop och registrera diagnostikinformation. Du kan ange korrelationskontexten för de telemetriobjekt som kopplar tillbaka den till telemetrin för begäran.

Schemaförbättringar

Application Insights-datamodellen är ett grundläggande men kraftfullt sätt att modellera din programtelemetri. Vi strävar efter att hålla modellen enkel och smal för att stödja viktiga scenarier och tillåta att schemat utökas för avancerad användning.

Om du vill rapportera datamodell- eller schemaproblem och förslag använder du vår GitHub-lagringsplats.

Förfrågan

Ett telemetriobjekt för begäran i Application Insights representerar den logiska körningssekvensen som utlöses av en extern begäran till ditt program. Varje körning av begäranden identifieras av en unik id och url som innehåller alla körningsparametrar.

Du kan gruppera begäranden efter logiska name och definiera den source här begäran. Kodkörning kan resultera i success eller fail och har en viss duration. Du kan ytterligare gruppera lyckade och misslyckade körningar med hjälp resultCodeav . Starttiden för telemetrin för begäran definieras på kuvertnivå.

Telemetri för begäran stöder standardmodellen för utökningsbarhet med hjälp av anpassade properties och measurements.

Anteckning

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträng för att dra nytta av nya funktioner.

Name

Det här fältet är namnet på begäran och representerar den kodsökväg som används för att bearbeta begäran. Ett lågt kardinalitetsvärde ger bättre gruppering av begäranden. För HTTP-begäranden representerar den mallen HTTP-metod och URL-sökväg som GET /values/{id} utan det faktiska id värdet.

Application Insights webb-SDK skickar ett begärandenamn "som det är" om brevärende. Gruppering i användargränssnittet är skiftlägeskänsligt, så GET /Home/Index räknas separat från GET /home/INDEX även om de ofta resulterar i samma kontrollant och åtgärdskörning. Anledningen till detta är att URL:er i allmänhet är skiftlägeskänsliga. Du kanske vill se om alla 404 fel har inträffat för URL:er som skrivits i versaler. Du kan läsa mer om insamling av begärandenamn via ASP.NET webb-SDK i blogginlägget.

Maximal längd: 1 024 tecken

ID

ID är identifieraren för en begärandeanropsinstans. Den används för korrelation mellan begäran och andra telemetriobjekt. ID:t bör vara globalt unikt. Mer information finns i Telemetrikorrelation i Application Insights.

Maximal längd: 128 tecken

webbadress

URL är begärande-URL:en med alla frågesträngsparametrar.

Maximal längd: 2 048 tecken

Källa

Källan är källan till begäran. Exempel är instrumentationsnyckeln för anroparen eller anroparens IP-adress. Mer information finns i Telemetrikorrelation i Application Insights.

Maximal längd: 1 024 tecken

Varaktighet

Varaktigheten för begäran är formaterad som DD.HH:MM:SS.MMMMMM. Det måste vara positivt och mindre än 1000 dagar. Det här fältet krävs eftersom telemetri för begäran representerar åtgärden med början och slutet.

Svarskod

Svarskoden är resultatet av en körning av begäran. Det är HTTP-statuskoden för HTTP-begäranden. Det kan vara ett HRESULT värde eller en undantagstyp för andra typer av begäranden.

Maximal längd: 1 024 tecken

Klart

Lyckad indikerar om ett anrop lyckades eller misslyckades. Fältet är obligatoriskt. När en begäran inte uttryckligen anges till falseanses den vara lyckad. Om ett undantag eller returnerad felresultatkod avbröt åtgärden anger du värdet till false.

För webbprogram definierar Application Insights en begäran som lyckad när svarskoden är mindre än 400 eller lika med 401. Det finns dock fall då den här standardmappningen inte matchar programmets semantik.

Svarskoden 404 kan indikera "inga poster", vilket kan vara en del av det vanliga flödet. Det kan också tyda på en bruten länk. För brutna länkar kan du implementera mer avancerad logik. Du kan bara markera brutna länkar som fel när länkarna finns på samma plats genom att analysera URL-referensen. Eller så kan du markera dem som fel när de nås från företagets mobilprogram. 301 På samma sätt och 302 ange fel när de nås från klienten som inte stöder omdirigering.

Delvis godkänt innehåll 206 kan tyda på ett fel i en övergripande begäran. En Application Insights-slutpunkt kan till exempel ta emot en batch med telemetriobjekt som en enda begäran. Den returnerar 206 när vissa objekt i batchen inte har bearbetats. En ökande frekvens av 206 indikerar ett problem som måste undersökas. Liknande logik gäller för 207 Multi-Status, där framgången kan vara den sämsta av separata svarskoder.

Anpassade egenskaper

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

Anpassade mått

Samling anpassade mått: Använd den här samlingen för att rapportera namngivna mått som är associerade med telemetriobjektet. Vanliga användningsfall är:

• Storleken på beroendetelemetrinyttolasten.
• Antalet köobjekt som bearbetas via telemetri för begäran.
• Den tid det tog för en kund att slutföra guiden genom att slutföra händelsetelemetrin.

Du kan köra frågor mot anpassade mått i Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Anteckning

• Anpassade mått är associerade med det telemetriobjekt som de tillhör. De är föremål för sampling med telemetriobjektet som innehåller dessa mätningar. Om du vill spåra ett mått som har ett värde som är oberoende av andra telemetrityper använder du måtttelemetri.
• Använd inte strängvärden för anpassade mått. Endast numeriska värden stöds.

Maximal nyckellängd: 150

Dependency

Beroendetelemetri (i Application Insights) representerar en interaktion mellan den övervakade komponenten och en fjärrkomponent som SQL eller en HTTP-slutpunkt.

Name

Det här fältet är namnet på kommandot som initierades med det här beroendeanropet. Den har ett lågt kardinalitetsvärde. Exempel är lagrat procedurnamn och url-sökvägsmall.

ID

ID är identifieraren för en beroendeanropsinstans. Den används för korrelation med det telemetriobjekt för begäran som motsvarar det här beroendeanropet. Mer information finns i Telemetrikorrelation i Application Insights.

Data

Det här fältet är kommandot som initierades av det här beroendeanropet. Exempel är SQL-instruktion och HTTP-URL med alla frågeparametrar.

Typ

Det här fältet är namnet på beroendetypen. Den har ett lågt kardinalitetsvärde för logisk gruppering av beroenden och tolkning av andra fält som commandName och resultCode. Exempel är SQL, Azure-tabellen och HTTP.

Mål

Det här fältet är målplatsen för ett beroendeanrop. Exempel är servernamn och värdadress. Mer information finns i Telemetrikorrelation i Application Insights.

Varaktighet

Varaktigheten för begäran är i formatet DD.HH:MM:SS.MMMMMM. Det måste vara mindre än 1000 dagar.

Resultatkod

Det här fältet är resultatkoden för ett beroendeanrop. Exempel är SQL-felkod och HTTP-statuskod.

Klart

Det här fältet är en indikation på ett lyckat eller misslyckat anrop.

Anpassade egenskaper

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

Anpassade mått

Samling anpassade mått: Använd den här samlingen för att rapportera namngivna mått som är associerade med telemetriobjektet. Vanliga användningsfall är:

• Storleken på beroendetelemetrinyttolasten.
• Antalet köobjekt som bearbetas via telemetri för begäran.
• Den tid det tog för en kund att slutföra guiden genom att slutföra händelsetelemetrin.

Du kan köra frågor mot anpassade mått i Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Anteckning

• Anpassade mått är associerade med det telemetriobjekt som de tillhör. De är föremål för sampling med telemetriobjektet som innehåller dessa mätningar. Om du vill spåra ett mått som har ett värde som är oberoende av andra telemetrityper använder du måtttelemetri.
• Använd inte strängvärden för anpassade mått. Endast numeriska värden stöds.

Maximal nyckellängd: 150

Undantag

I Application Insights representerar en instans av undantag ett hanterat eller ohanterat undantag som inträffade under körningen av det övervakade programmet.

Problem-ID

Problem-ID:t identifierar var undantaget utlöstes i kod. Den används för undantagsgruppering. Vanligtvis är det en kombination av en undantagstyp och en funktion från anropsstacken.

Maximal längd: 1 024 tecken

Allvarlighetsnivå

Det här fältet är spårningens allvarlighetsgrad. Värdet kan vara Verbose, Information, Warning, Erroreller Critical.

Undantagsinformation

(Utökas)

Anpassade egenskaper

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

Anpassade mått

Samling anpassade mått: Använd den här samlingen för att rapportera namngivna mått som är associerade med telemetriobjektet. Vanliga användningsfall är:

• Storleken på beroendetelemetrinyttolasten.
• Antalet köobjekt som bearbetas via telemetri för begäran.
• Den tid det tog för en kund att slutföra guiden genom att slutföra händelsetelemetrin.

Du kan köra frågor mot anpassade mått i Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Anteckning

• Anpassade mått är associerade med det telemetriobjekt som de tillhör. De är föremål för sampling med telemetriobjektet som innehåller dessa mätningar. Om du vill spåra ett mått som har ett värde som är oberoende av andra telemetrityper använder du måtttelemetri.
• Använd inte strängvärden för anpassade mått. Endast numeriska värden stöds.

Maximal nyckellängd: 150

Spårning

Spårningstelemetri i Application Insights representerar printfspårningsinstruktioner i stil med text som söks igenom. Log4Net, NLogoch andra textbaserade loggfilposter översätts till instanser av den här typen. Spårningen har inte mått som utökningsbarhet.

Meddelande

Spårningsmeddelande.

Maximal längd: 32 768 tecken

Allvarlighetsnivå

Spåra allvarlighetsgrad.

Värden: Verbose, Information, Warning, Erroroch Critical

Anpassade egenskaper

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

Event

Du kan skapa händelsetelemetriobjekt (i Application Insights) för att representera en händelse som inträffade i ditt program. Vanligtvis är det en användarinteraktion, till exempel ett knappklick eller en beställningsutcheckning. Det kan också vara en programlivscykelhändelse som initiering eller en konfigurationsuppdatering.

Semantiskt kan händelser eller kanske inte korreleras till begäranden. Om den används korrekt är händelsetelemetri viktigare än begäranden eller spårningar. Händelser representerar affärstelemetri och bör omfattas av separat, mindre aggressiv sampling.

Name

Händelsenamn: Om du vill tillåta korrekt gruppering och användbara mått begränsar du programmet så att det genererar några separata händelsenamn. Använd till exempel inte ett separat namn för varje genererad instans av en händelse.

Maximal längd: 512 tecken

Anpassade egenskaper

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

Anpassade mått

Samling anpassade mått: Använd den här samlingen för att rapportera namngivna mått som är associerade med telemetriobjektet. Vanliga användningsfall är:

• Storleken på beroendetelemetrinyttolasten.
• Antalet köobjekt som bearbetas via telemetri för begäran.
• Den tid det tog för en kund att slutföra guiden genom att slutföra händelsetelemetrin.

Du kan köra frågor mot anpassade mått i Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Anteckning

• Anpassade mått är associerade med det telemetriobjekt som de tillhör. De är föremål för sampling med telemetriobjektet som innehåller dessa mätningar. Om du vill spåra ett mått som har ett värde som är oberoende av andra telemetrityper använder du måtttelemetri.
• Använd inte strängvärden för anpassade mått. Endast numeriska värden stöds.

Maximal nyckellängd: 150

Mått

Application Insights stöder två typer av måtttelemetri: enkel mätning och föraggregerat mått. Enkel mätning är bara ett namn och värde. Föraggregerat mått anger det lägsta och högsta värdet för måttet i aggregeringsintervallet och standardavvikelsen för det.

Föraggregerad måtttelemetri förutsätter att aggregeringsperioden var en minut.

Application Insights stöder flera välkända måttnamn. Dessa mått placeras i tabellen performanceCounters .

I följande tabell visas de mått som representerar system- och processräknare.

.NET-namn	Plattformsoberoende namn	beskrivning
\Processor(_Total)\% Processor Time	Pågående arbete...	Totalt antal processorer för datorer.
\Memory\Available Bytes	Pågående arbete...	Visar mängden fysiskt minne i byte som är tillgängligt för processer som körs på datorn. Den beräknas genom att summera mängden utrymme på de nollade, kostnadsfria och väntelägesminneslistorna. Ledigt minne är redo för användning. Nollat minne består av sidor med minne fyllt med nollor för att förhindra att senare processer ser data som används av en tidigare process. Väntelägesminne är minne som har tagits bort från en process arbetsuppsättning (dess fysiska minne) på väg till disken, men som fortfarande är tillgängligt för att återkallas. Se Minnesobjekt.
\Process(??APP_WIN32_PROC??)\% Processor Time	Pågående arbete...	CPU för den process som är värd för programmet.
\Process(??APP_WIN32_PROC??)\Private Bytes	Pågående arbete...	Minne som används av processen som är värd för programmet.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Pågående arbete...	Hastighet för I/O-åtgärder som körs av processen som är värd för programmet.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Pågående arbete...	Frekvens för begäranden som bearbetas av ett program.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Pågående arbete...	Frekvens för undantag som genereras av ett program.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Pågående arbete...	Genomsnittlig körningstid för begäranden.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Pågående arbete...	Antal begäranden som väntar på bearbetningen i en kö.

Mer information om REST API för mått finns i Mått – Hämta.

Name

Det här fältet är namnet på måttet som du vill se i Application Insights-portalen och användargränssnittet.

Värde

Det här fältet är det enda värdet för mätning. Det är summan av enskilda mått för aggregeringen.

Antal

Det här fältet är måttvikten för det aggregerade måttet. Det bör inte anges för en mätning.

Min

Det här fältet är det minsta värdet för det aggregerade måttet. Det bör inte anges för en mätning.

Max

Det här fältet är det högsta värdet för det aggregerade måttet. Det bör inte anges för en mätning.

Standardavvikelse

Det här fältet är standardavvikelsen för det aggregerade måttet. Det bör inte anges för en mätning.

Anpassade egenskaper

Måttet med den anpassade egenskapen CustomPerfCounter inställd true på anger att måttet representerar Prestandaräknaren för Windows. Dessa mått placeras i tabellen performanceCounters , inte i customMetrics. Dessutom parsas namnet på det här måttet för att extrahera kategori-, räknar- och instansnamn.

Namn/värde-samling med anpassade egenskaper: Den här samlingen används för att utöka standardtelemetri med anpassade dimensioner. Exempel är distributionsfacket som producerade telemetri eller den telemetriobjektspecifika egenskapen som ordernumret.

• Maximal nyckellängd: 150
• Maximal värdelängd: 8 192

PageView

PageView-telemetri (i Application Insights) loggas när en programanvändare öppnar en ny sida i ett övervakat program. Page I det här sammanhanget är en logisk enhet som definieras av utvecklaren som en programflik eller en skärm och som inte nödvändigtvis är korrelerad till en webbläsarwebbsida eller en uppdateringsåtgärd. Den här skillnaden kan förstås ytterligare i kontexten för ensidesprogram (SPA), där växlingen mellan sidor inte är kopplad till webbläsarsideåtgärder. Det pageViews.duration är den tid det tar för programmet att presentera sidan för användaren.

Anteckning

• Som standard loggar Application Insights SDK:er enskilda PageView händelser på varje webbläsarwebbsidas inläsningsåtgärd, med pageViews.duration ifylld efter webbläsarens tidsinställning. Utvecklare kan utöka ytterligare spårning av PageView händelser med hjälp av API-anropet trackPageView.
• Standardkvarhållningen för loggar är 30 dagar. Om du vill visa PageView statistik över en längre tidsperiod måste du justera inställningen.

Mäta webbläsareTiming i Application Insights

Moderna webbläsare exponerar mått för sidinläsningsåtgärder med prestanda-API:et. Application Insights förenklar dessa mätningar genom att konsolidera relaterade tidsinställningar till standardmått för webbläsare enligt definitionen i dessa tidsdefinitioner för bearbetning:

• Klient <–> DNS: Klienten kontaktar DNS för att matcha webbplatsens värdnamn och DNS svarar med IP-adressen.

• Klient <–> Webbserver: Klienten skapar TCP och sedan TLS-handskakningar med webbservern.

• Klient <–> Webbserver: Klienten skickar nyttolasten för begäran, väntar på att servern ska köra begäran och tar emot det första svarspaketet.

• Klient <- webbserver: Klienten tar emot resten av svarsnyttolasten byte från webbservern.

• Klient: Klienten har nu full svarsnyttolast och måste rendera innehåll i webbläsaren och läsa in DOM.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = #3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = #5

• browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

• pageViews/duration

  • Varaktigheten PageView kommer från webbläsarens gränssnitt för prestandatid, PerformanceNavigationTiming.duration.

  • Om PerformanceNavigationTiming är tillgängligt används den varaktigheten.

    Om det inte är det används det inaktuella PerformanceTiming gränssnittet och deltat mellan NavigationStart och LoadEventEnd beräknas.

  • Utvecklaren anger ett varaktighetsvärde när anpassade PageView händelser loggas med hjälp av API-anropet trackPageView.

Kontext

Varje telemetriobjekt kan ha ett starkt skrivet kontextfält. Varje fält möjliggör ett specifikt övervakningsscenario. Använd samlingen med anpassade egenskaper för att lagra anpassad eller programspecifik kontextuell information.

Programversion

Information i programkontextfälten handlar alltid om programmet som skickar telemetrin. Programversionen används för att analysera trendändringar i programmets beteende och dess korrelation till distributionerna.

Maximal längd: 1 024

Klientens IP-adress

Det här fältet är IP-adressen för klientenheten. Har stöd för IPv4 och IPv6. När telemetri skickas från en tjänst handlar platskontexten om den användare som initierade åtgärden i tjänsten. Application Insights extraherar geoplatsinformationen från klientens IP-adress och trunkerar den sedan. Klient-IP-adressen kan inte användas som användar identifierbar information.

Maximal längd: 46

Enhetstyp

Ursprungligen användes det här fältet för att ange vilken typ av enhet programmets användare använder. Idag används det främst för att skilja JavaScript-telemetri med enhetstypen Browser från telemetri på serversidan med enhetstypen PC.

Maximal längd: 64

Åtgärds-ID

Det här fältet är den unika identifieraren för rotåtgärden. Med den här identifieraren kan du gruppera telemetri mellan flera komponenter. Mer information finns i Telemetrikorrelation. Antingen skapar en begäran eller en sidvy åtgärds-ID: t. Alla andra telemetri anger det här fältet till värdet för den innehållande begäran eller sidvyn.

Maximal längd: 128

Överordnat åtgärds-ID

Det här fältet är den unika identifieraren för telemetriobjektets omedelbara överordnade objekt. Mer information finns i Telemetrikorrelation.

Maximal längd: 128

Operationsnamn

Det här fältet är namnet (gruppen) på åtgärden. Antingen skapar en begäran eller en sidvy åtgärdsnamnet. Alla andra telemetriobjekt anger det här fältet till värdet för den innehållande begäran eller sidvyn. Åtgärdsnamnet används för att hitta alla telemetriobjekt för en åtgärdsgrupp (till exempel GET Home/Index). Den här kontextegenskapen används för att besvara frågor som Vilka är de vanliga undantagen som genereras på den här sidan?

Maximal längd: 1 024

Syntetisk källa för åtgärden

Det här fältet är namnet på den syntetiska källan. Viss telemetri från programmet kan representera syntetisk trafik. Det kan vara webbkrypteraren som indexerar webbplatsen, platstillgänglighetstester eller spårningar från diagnostikbibliotek som själva Application Insights SDK.

Maximal längd: 1 024

Sessions-ID

Sessions-ID är instansen av användarens interaktion med appen. Information i sessionskontextfälten handlar alltid om användaren. När telemetri skickas från en tjänst handlar sessionskontexten om den användare som initierade åtgärden i tjänsten.

Maximal längd: 64

Anonymt användar-ID

Det anonyma användar-ID:t (User.Id) representerar programmets användare. När telemetri skickas från en tjänst handlar användarkontexten om den användare som initierade åtgärden i tjänsten.

Sampling är en av metoderna för att minimera mängden insamlad telemetri. En samplingsalgoritm försöker antingen sampla in eller ut all korrelerad telemetri. Ett anonymt användar-ID används för generering av samplingspoäng, så ett anonymt användar-ID bör vara ett slumpmässigt värde.

Anteckning

Antalet anonyma användar-ID:t är inte detsamma som antalet unika programanvändare. Antalet anonyma användar-ID:n är oftast högre eftersom ett nytt unikt anonymt användar-ID allokeras varje gång användaren öppnar din app på en annan enhet eller i en annan webbläsare eller när användaren rensar webbläsarcookies. Den här beräkningen kan resultera i att samma fysiska användare räknas flera gånger.

Användar-ID:t kan korsreferenseras med sessions-ID:t för att tillhandahålla unika telemetridimensioner och upprätta användaraktivitet under en sessionsperiod.

Att använda ett anonymt användar-ID för att lagra ett användarnamn är ett missbruk av fältet. Använd ett autentiserat användar-ID.

Maximal längd: 128

Autentiserat användar-ID

Ett autentiserat användar-ID är motsatsen till ett anonymt användar-ID. Det här fältet representerar användaren med ett eget namn. Det här ID:t samlas endast in som standard med ASP.NET Framework SDK: s AuthenticatedUserIdTelemetryInitializer.

Använd Application Insights SDK för att initiera det autentiserade användar-ID:t med ett värde som identifierar användaren beständigt mellan webbläsare och enheter. På så sätt tillskrivs alla telemetriobjekt det unika ID:t. Det här ID:t möjliggör frågor för all telemetri som samlas in för en viss användare (med undantag för samplingskonfigurationer och telemetrifiltrering).

Användar-ID:t kan korsreferenseras med sessions-ID:t för att tillhandahålla unika telemetridimensioner och upprätta användaraktivitet under en sessionsperiod.

Maximal längd: 1 024

Konto-ID

Konto-ID:t i program med flera klienter är det klientkonto-ID eller namn som användaren agerar med. Det används för mer användarsegmentering när ett användar-ID och ett autentiserat användar-ID inte räcker. Exempel kan vara ett prenumerations-ID för Azure Portal eller bloggnamnet för en bloggplattform.

Maximal längd: 1 024

Molnroll

Det här fältet är namnet på den roll som programmet är en del av. Den mappar direkt till rollnamnet i Azure. Det kan också användas för att särskilja mikrotjänster, som ingår i ett enda program.

Maximal längd: 256

Instans av molntjänstroll

Det här fältet är namnet på den instans där programmet körs. Det är till exempel datornamnet för lokalt eller instansnamnet för Azure.

Maximal längd: 256

Intern: SDK-version

Mer information finns i SDK-versionen.

Maximal längd: 64

Internt: Nodnamn

Det här fältet representerar det nodnamn som används i faktureringssyfte. Använd den för att åsidosätta standardidentifieringen av noder.

Maximal längd: 256

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Hur mäter jag effekten av en övervakningskampanj?

PageView-telemetri innehåller URL och du kan parsa UTM-parametern med hjälp av en regex-funktion i Kusto.

Ibland kan dessa data saknas eller vara felaktiga om användaren eller företaget inaktiverar sändningen av användaragenten i webbläsarinställningarna. UA Parser-regexes kanske inte innehåller all enhetsinformation. Eller så kanske Application Insights inte har antagit de senaste uppdateringarna.

Varför skulle en anpassad mätning lyckas utan fel, men loggen visas inte?

Detta kan inträffa om du använder strängvärden. Endast numeriska värden fungerar med anpassade mått.

Nästa steg

Lär dig hur du använder Application Insights API för anpassade händelser och mått, inklusive:

• Telemetri för anpassad begäran
• Anpassad beroendetelemetri
• Anpassad spårningstelemetri
• Anpassad händelsetelemetri
• Anpassad måtttelemetri

Konfigurera beroendespårning för:

• .NET
• Java

Mer information:

• Kolla in plattformar som stöds av Application Insights.
• Kolla in standardkonfigurationen för kontextegenskaper.
• Utforska .NET-spårningsloggar i Application Insights.
• Utforska Java-spårningsloggar i Application Insights.
• Lär dig mer om den inbyggda Azure Functions-integreringen med Application Insights för att övervaka funktionskörningar.
• Lär dig hur du konfigurerar ett ASP.NET Core-program med Application Insights.
• Lär dig hur du diagnostiserar undantag i dina webbappar med Application Insights.
• Lär dig hur du utökar och filtrerar telemetri.
• Använd sampling för att minimera mängden telemetri baserat på datamodell.