Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Application Insights skickar telemetri från ditt webbprogram till Azure-portalen för att ge insikter om prestanda och användning av ditt program och din infrastruktur. För att hjälpa dig att bättre förstå och organisera telemetridata kategoriserar vi dem i olika typer.
Telemetridatamodellen är standardiserad, vilket gör det möjligt att skapa plattforms- och språkoberoende övervakning. 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.
Data som samlas in av Application Insights modellerar det här typiska programkörningsmönstret.
1availabilityResults är inte tillgängliga som standard och kräver att tillgänglighetstester konfigureras.
2customEvents och customMetrics är endast tillgängliga med anpassad instrumentation.
Kommentar
Application Insights lagrar loggar i traces-tabellen av äldre anledning. Intervallen för distribuerade spårningar lagras i tabellerna requests och dependencies . Vi planerar att lösa detta i en framtida version för att undvika förvirring.
Typer av telemetri
Följande typer av telemetri används för att övervaka körningen av ditt program. Azure Monitor OpenTelemetry Distro och Application Insights JavaScript SDK samlar in:
| Telemetrityp | Tabellnamn (Application Insights) |
Tabellnamn (Log Analytics) |
beskrivning |
|---|---|---|---|
| Tillgänglighet | availabilityResults |
AppAvailabilityResults |
Övervakar programmets tillgänglighet och svarstider genom att skicka webbförfrågningar med jämna mellanrum och varna dig om programmet inte svarar eller om svarstiden är för långsam. |
| Tidsinställning för webbläsare | browserTimings |
AppBrowserTimings |
Mäter prestanda för webbsidor, inklusive sidinläsningstider och nätverksvaraktighet. |
| Beroende | dependencies |
AppDependencies |
Spårar anrop från ditt program till en extern tjänst eller lagring, till exempel ett REST API eller EN SQL-databas, och mäter varaktigheten och framgången för dessa anrop. |
| Händelse | customEvents |
AppEvents |
Används vanligtvis för att samla in användarinteraktioner och andra betydande förekomster i ditt program, till exempel knappklick eller beställningsutcheckningar, för att analysera användningsmönster. |
| Undantag | exceptions |
AppExceptions |
Samlar in felinformation som är avgörande för felsökning och förståelse av fel. |
| Metrik | performanceCounterscustomMetrics |
AppPerformanceCountersAppMetrics |
Prestandaräknare tillhandahåller numeriska data om olika aspekter av program- och systemprestanda, till exempel CPU-användning och minnesförbrukning. Dessutom kan du med anpassade mått definiera och spåra specifika mått som är unika för ditt program, vilket ger flexibilitet att övervaka anpassade prestandaindikatorer. |
| Sidvisning | pageViews |
AppPageViews |
Spårar de sidor som visas av användare, vilket ger insikter om användarnavigering och engagemang i ditt program. |
| Förfrågan | requests |
AppRequests |
Loggar begäranden som tas emot av din applikation, och tillhandahåller information som åtgärds-ID, varaktighet samt status för framgång eller misslyckande. |
| Spårning | traces |
AppTraces |
Loggar programspecifika händelser, till exempel anpassade diagnostikmeddelanden eller spårningsuttryck, som är användbara för felsökning och övervakning av programbeteende över tid. |
Viktigt!
Du kan fråga programtelemetri från både Application Insights och Log Analytics (rekommenderas) men tabell- och fältnamnen skiljer sig åt. Den här skillnaden bevarar bakåtkompatibilitet, till exempel för att säkerställa att kundens instrumentpaneler med anpassade frågor som skapats innan Log Analytics-namngivningskonventionen fortsätter att fungera korrekt.
Om du vill jämföra fältnamn i Azure-portalen öppnar du Application Insights-loggar>, kör en fråga och kopierarId ett telemetriobjekt (till exempel ). 1234a5b6c7de8f90 Öppna sedan en ny flik i webbläsaren, gå till Log>, växla till KQL-läge och kör frågan:
AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"
Expandera båda telemetriobjekten genom att välja sparren till vänster om varje rad för att visa alla deras egenskaper.
Varje telemetriobjekt kan innehålla kontextinformation , till exempel programversion eller användarsessions-ID. Kontexten består av en uppsättning starkt skrivna fält som möjliggör olika analysscenarier.
När programversionen till exempel initieras korrekt kan Application Insights identifiera nya mönster i programbeteendet som är korrelerat med omdistribution. På samma sätt kan du använda sessions-ID för att utvärdera effekten av avbrott eller problem för användare. Genom att beräkna antalet unika sessions-ID:t som är associerade med misslyckade beroenden, felspårningar eller kritiska undantag får du en tydligare bild av användarpåverkan.
Application Insights-telemetrimodellen stöder också korrelation av telemetriobjekt till de åtgärder som de tillhör. Om en begäran till exempel utlöser ett SQL Database-anrop kan både begäran och beroendeanropet innehålla diagnostikdata och länkas via en delad korrelationskontext, så att du kan spåra hela flödet för åtgärden.
Den här artikeln beskriver de fält som är specifika för varje telemetrityp. Om du vill visa en fullständig lista över tillgängliga fält (inklusive kontextfält) för alla telemetrityper följer du länken under varje relevant tabell.
Tillgänglighetstelemetri
Tillgänglighetstelemetri omfattar syntetisk övervakning, där tester simulerar användarinteraktioner för att verifiera att programmet är tillgängligt och dynamiskt. Vi rekommenderar att du konfigurerar standardtillgänglighetstester för att övervaka programmets tillgänglighet från olika platser runt om i världen och skicka din egen testinformation till Application Insights.
Tillgänglighetsspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
id |
Id |
Den unika identifieraren för ett tillgänglighetstestresultat som används för korrelation mellan enskilda testkörningar som kan hjälpa till att spåra specifika fel eller mönster över tid. Mer information finns i Telemetrikorrelation i Application Insights. |
name |
Name |
Namnet på ett tillgänglighetstest. Det definieras när du skapar testet (till exempel "Pingtest för startsida"). |
location |
Location |
Den geografiska plats eller datacenterregion som ett tillgänglighetstest kördes från (till exempel USA, västra, Norra Europa). Det hjälper till att identifiera problem med regionala avbrott eller svarstider. |
success |
Success |
Det här fältet anger om ett tillgänglighetstest lyckades eller inte. Det är ett booleskt värde där true innebär att testet lyckades och false innebär att det misslyckades. |
message |
Message |
Ett beskrivande meddelande med information om resultatet av testet. Den innehåller ofta undantagsinformation eller felsvar. |
duration |
Duration |
Hur lång tid det tog att köra tillgänglighetstestet. Det hjälper till att mäta prestanda och identifiera problem med svarstid. Varaktigheten mäts vanligtvis i millisekunder. |
En lista över alla tillgängliga fält finns i AppAvailabilityResults.
Webbläsartidens telemetri
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.
Webbläsarspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
networkDuration |
NetworkDurationMs |
Klienten kontaktar DNS för att matcha webbplatsens värdnamn och DNS svarar med IP-adressen. Klienten skapar TCP och sedan TLS-handskakningar med webbservern. |
sendDuration |
SendDurationMs |
Klienten skickar nyttolasten för begäran, väntar på att servern ska köra begäran och tar emot det första svarspaketet. |
receiveDuration |
ReceiveDurationMs |
Klienten tar emot resten av webbserverns svarsnyttolastens byter. |
processingDuration |
ProcessingDurationMs |
Klienten har nu full svarsnyttolast och måste rendera innehåll i webbläsaren och läsa in DOM. |
totalDuration |
TotalDurationMs |
Summan av alla webbläsartidsinställningar. |
En lista över alla tillgängliga fält finns i AppBrowserTimings.
Beroendetelemetri
Ett beroendetelemetriobjekt representerar en interaktion mellan den övervakade komponenten och en fjärrkomponent, till exempel SQL eller en HTTP-slutpunkt.
Beroendespecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
id |
Id |
Den unika identifieraren för en beroendeanropsinstans som 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. |
target |
Target |
Målplatsen för ett beroendeanrop. Exempel är servernamn och värdadress. Mer information finns i Telemetrikorrelation i Application Insights. |
type |
DependencyType |
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. |
name |
Name |
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. |
data |
Data |
Kommandot som initierades av det här beroendeanropet. Exempel är SQL-instruktion och HTTP-URL med alla frågeparametrar. |
success |
Success |
Det här fältet anger om ett anrop lyckades eller inte. Det är ett booleskt värde där true innebär att anropet lyckades och false innebär att det misslyckades. |
resultCode |
ResultCode |
Resultatkoden för ett beroendeanrop. Exempel är SQL-felkod och HTTP-statuskod. |
duration |
DurationMs |
Varaktigheten för begäran är i formatet DD.HH:MM:SS.MMMMMM. Det måste vara mindre än 1000 dagar. |
En lista över alla tillgängliga fält finns i AppDependencies.
Händelsetelemetri
Du kan skapa händelsetelemetriobjekt som representerar en händelse som har inträffat 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.
Mer information om hur du skapar anpassad händelsetelemetri finns i Lägga till och ändra Azure Monitor OpenTelemetry för .NET-, Java-, Node.js- och Python-program.
Händelsespecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
name |
Name |
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. |
En lista över alla tillgängliga fält finns i AppEvents.
Undantagstelemetri
Ett undantagstelemetriobjekt representerar ett hanterat eller ohanterat undantag som inträffade under körningen av det övervakade programmet.
Undantagsspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
problemId |
ProblemId |
Identifierar platsen där undantaget kastades i kod. Den används för undantagsgruppering. Vanligtvis är det en kombination av en undantagstyp och en funktion från anropsstacken. |
type |
ExceptionType |
Den specifika typen av undantag som inträffade. Detta inkluderar vanligtvis namnområdet och klassnamnet, till exempel System.NullReferenceException eller System.InvalidOperationException. |
assembly |
Assembly |
Sammansättningen där undantaget utlöstes. Detta är användbart för att hitta komponenten i programmet som ansvarar för undantaget. |
method |
Method |
Metodnamnet i sammansättningen där undantaget utlöstes. Detta ger sammanhangsberoende information om var i koden felet inträffade. |
outerType |
OuterType |
Typen av yttre undantag (omslutning) om det aktuella undantaget är kapslat inom ett annat undantag. Detta är användbart för att förstå i vilken kontext det inre undantaget inträffade och kan hjälpa till att spåra sekvensen av fel. |
outerMessage |
OuterMessage |
Det här meddelandet ger en läsbar förklaring av det yttre undantaget och kan vara till hjälp för att förstå det bredare problemet. |
outerAssembly |
OuterAssembly |
Sammansättningen där det yttre undantaget uppstod. |
outerMethod |
OuterMethod |
Metoden för det yttre undantaget. Detta ger detaljerad information om felpunkten i det yttre undantaget. |
severityLevel |
SeverityLevel |
Allvarlighetsgraden för spårning kan vara något av följande värden: Verbose, Information, Warning, Error eller Critical. |
details |
Details |
Innehåller undantagsinformation som undantagsmeddelandet och anropsstacken. |
En lista över alla tillgängliga fält finns i AppExceptions.
Måtttelemetri
Application Insights stöder två typer av måtttelemetri:
- Ett enda mått har ett namn och ett värde.
- Ett föraggregerat mått tar flera mått under en aggregeringsperiod på 1 minut.
Prestandaräknare
Prestandaräknare är alltid enkla mått med en name och en value, men levereras med de ytterligare fälten category, counteroch för Windows-program också instance.
Prestandaräknarspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
name |
Name |
Namnet på måttet som du vill se i Application Insights-portalen. |
value |
Value |
Det enda värdet för mätning. Det är summan av enskilda mått för aggregeringen. |
category |
Category |
Representerar en grupp relaterade prestandaräknare (till exempel Process). |
counter |
Counter |
Anger det specifika prestandamått som mäts inom en kategori (till exempel IO Data Bytes/sec). |
instance |
Instance |
Identifierar en specifik förekomst av en räknare inom en kategori (till exempel ??APP_WIN32_PROC??). |
En lista över alla tillgängliga fält finns i AppPerformanceCounters.
Mer information om mått finns i Mått i Application Insights. Mer information om REST API för mått finns i Mått – Hämta.
System- och processräknarens metrik
| .NET-namn | beskrivning |
|---|---|
\Processor(_Total)\% Processor Time |
Totalt antal processorer för datorer. |
\Memory\Available Bytes |
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 |
CPU för den process som är värd för programmet. |
\Process(??APP_WIN32_PROC??)\Private Bytes |
Minne som används av processen som är värd för programmet. |
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec |
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 |
Frekvens för begäranden som bearbetas av ett program. |
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec |
Frekvens för undantag som genereras av ett program. |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time |
Genomsnittlig körningstid för begäranden. |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue |
Antal begäranden som väntar på bearbetningen i en kö. |
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.
Anpassade mått
Anpassade mått är prestandaindikatorer eller affärsspecifika mått som du definierar och samlar in för att få insikter som inte omfattas av standardmått. Mer information om anpassade mått finns i Anpassade mått i Azure Monitor (förhandsversion).
Anpassade måttspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
Enkel mätning | Föraggregerat mått |
|---|---|---|---|
name |
Name |
Det här fältet är namnet på måttet som du vill se i Application Insights-portalen och användargränssnittet. | |
value |
Value |
Det här fältet är det enda värdet för mätning. Det är summan av enskilda mått för aggregeringen. | För ett föraggregerat mått är Värdet lika med Summa. |
Max |
Max |
För ett enda mått är Max lika med Värde. | 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. |
Min |
Min |
För ett enda mått är Min lika med Värde. | 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. |
Sum |
Sum |
För ett enda mått är Sum lika med Värde. | Summan av alla värden för det aggregerade måttet. Det bör inte anges för en mätning. |
Count |
Count |
För ett enda mätvärde är Count1. |
Antalet mått under en aggregeringsperiod på 1 minut. Det bör inte anges för en mätning. |
En lista över alla tillgängliga fält finns i AppMetrics.
Kommentar
Om du vill beräkna medelvärdet delar du Summa efter antal.
Telemetri för sidvisning
Telemetri för sidvisning 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.
Sidvisningsspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
name |
Name |
Namnet på sidan som visades av användaren (till exempel "Home" eller "Shopping Cart"). |
url |
Url |
Den fullständiga URL:en för sidan som visades. Det här fältet är avgörande för att analysera trafik och användarbeteende i hela programmet. |
duration |
DurationMs |
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 inaktuellaPerformanceTiming 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. |
En lista över alla tillgängliga fält finns i AppPageViews.
Kommentar
Som standard loggar Application Insights JavaScript SDK enskilda
PageViewhändelser på varje webbläsarwebbsidas inläsningsåtgärd, medpageViews.durationifylld efter webbläsarens tidsinställning. Utvecklare kan utöka ytterligare spårning avPageViewhändelser med hjälp av API-anropet trackPageView.Standardkvarhållningen för loggar är 30 dagar. Om du vill visa
PageViewstatistik över en längre tidsperiod måste du justera inställningen.
Begär telemetri
Telemetri för begäran representerar information som rör inkommande HTTP-begäranden till ditt program. Den här typen av telemetri hjälper dig att övervaka prestanda och framgång för programmets webbaserade tjänster. Ett telemetriobjekt för begäran 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å. Begäranstelemetri stöder standardmodellen för utökningsbarhet genom att använda specialanpassade properties och measurements.
Fält som är specifika för begäran:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
id |
Id |
Den unika identifieraren för en begärandeanropsinstans som 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. |
source |
Source |
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. |
name |
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. |
url |
Url |
URL är begärande-URL:en med alla frågesträngsparametrar. |
success |
Success |
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. |
resultCode |
ResultCode |
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. |
duration |
DurationMs |
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. |
En lista över alla tillgängliga fält finns i AppRequests.
Spårningstelemetri
Spårningstelematri representerar spårningssatser i printf-stil som textsökas.
Log4Net, NLogoch andra textbaserade loggfilposter översätts till instanser av den här typen. Spårningen har inte mått som utökningsbarhet.
Spårningsspecifika fält:
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
message |
Message |
Spårningsmeddelande. |
severityLevel |
SeverityLevel |
Spåra allvarlighetsgrad. |
En lista över alla tillgängliga fält finns i AppTraces.
Kommentar
Värden för severityLevel är uppräknade och plattformsspecifika.
Anpassade egenskaper och mått
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)
Kommentar
- 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
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.
| Fältnamn (Application Insights) |
Fältnamn (Log Analytics) |
beskrivning |
|---|---|---|
account_ID |
user_AccountId |
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. |
application_Version |
AppVersion |
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. |
appId |
ResourceGUID |
En unik identifierare för din Application Insights-resurs för att skilja telemetri från olika program. |
appName |
Inte tillgänglig | I Application Insights appName är samma som _ResourceId. |
client_Browser |
ClientBrowser |
Namnet på webbläsaren som används av klienten. |
client_City |
ClientCity |
Den stad där klienten fanns när telemetrin samlades in (baserat på IP-geoplats). |
client_CountryOrRegion |
ClientCountryOrRegion |
Det land eller den region där klienten fanns när telemetrin samlades in (baserat på IP-geoplats). |
client_IP |
ClientIP |
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. |
client_OS |
ClientOS |
Anger operativsystemet för klienten som genererade telemetrin. |
client_StateorProvince |
ClientStateOrProvince |
Den stat eller provins där klienten fanns när telemetrin samlades in (baserat på IP-geoplats). |
client_Type |
ClientType |
Beskriver vilken typ av klientenhet som skickade telemetrin (till exempel Browser eller PC.) |
cloud_RoleInstance |
AppRoleInstance |
Namnet på den instans där programmet körs. Det är till exempel datornamnet för lokalt eller instansnamnet för Azure. |
cloud_RoleName |
AppRoleName |
Namnet på rollen som applikationen ä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. |
iKey |
IKey |
En äldre unik identifierare som används för att associera telemetridata med en specifik Application Insights-resurs. |
itemId |
Inte tillgänglig | En unik identifierare för ett specifikt telemetriobjekt. |
itemCount |
ItemCount |
Antalet förekomster eller antal som är associerade med en enda telemetrihändelse. |
operation_Id |
OperationId |
Rotåtgärdens unika identifierare. 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. |
operation_Name |
OperationName |
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? |
operation_ParentId |
ParentId |
Den unika identifieraren för telemetriobjektets överordnade objekt. Mer information finns i Telemetrikorrelation. |
operation_SyntheticSource |
SyntheticSource |
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. |
sdkVersion |
SDKVersion |
Den version av Application Insights SDK som skickar telemetridata. Mer information finns i SDK-versionen. |
session_Id |
SessionId |
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. |
user_AuthenticatedId |
UserAuthenticatedId |
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. |
user_Id |
UserId |
Det anonyma användar-ID:t 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. 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. |
_ResourceId |
_ResourceId |
Det fullständiga Azure-resurs-ID:t för Application Insights-komponenten, som innehåller prenumerationen, resursgruppen och resursnamnet. |
Nästa steg
- Granska vanliga frågor och svar: Vanliga frågor och svar om telemetridatamodellen
- Kolla in plattformar som stöds av Application Insights.
- Lär dig hur du samlar in anpassad telemetri med hjälp av Azure Monitor OpenTelemetry Distro.
- Lär dig hur du använder Application Insights API för anpassade händelser och mått.
- Lär dig hur du utökar och filtrerar telemetri.
- Lär dig hur du använder sampling för att minimera mängden telemetri baserat på datamodell.