Model danych telemetrii usługi Application Insights

Aplikacja Szczegółowe informacje wysyła dane telemetryczne z aplikacji internetowej do witryny Azure Portal, aby umożliwić analizowanie wydajności i użycia aplikacji. Model telemetrii jest ustandaryzowany, więc można utworzyć monitorowanie niezależne od platformy i języka.

Dane zbierane przez aplikację Szczegółowe informacje modeluje ten typowy wzorzec wykonywania aplikacji.

Następujące typy danych telemetrycznych służą do monitorowania wykonywania aplikacji. Zestaw SDK usługi Application Szczegółowe informacje z platformy aplikacji internetowej automatycznie zbiera następujące trzy typy:

• Żądanie: wygenerowane w celu zarejestrowania żądania odebranego przez aplikację. Na przykład zestaw SDK aplikacji Szczegółowe informacje sieci Web automatycznie generuje element telemetrii Żądania dla każdego żądania HTTP odbieranego przez aplikację internetową.

  Operacja składa się z wątków wykonywania, które przetwarzają żądanie. Możesz również napisać kod do monitorowania innych typów operacji, takich jak "wznawianie" w zadaniu internetowym lub funkcji, która okresowo przetwarza dane. Każda operacja ma identyfikator. Identyfikator może służyć do grupowania wszystkich danych telemetrycznych wygenerowanych podczas przetwarzania żądania przez aplikację. Każda operacja kończy się powodzeniem lub niepowodzeniem i ma czas trwania.

• Wyjątek: zazwyczaj reprezentuje wyjątek, który powoduje niepowodzenie operacji.

• Zależność: reprezentuje wywołanie z aplikacji do usługi zewnętrznej lub magazynu, takiego jak interfejs API REST lub SQL. W ASP.NET wywołania zależności do języka SQL są definiowane przez System.Dataelement . Wywołania do punktów końcowych HTTP są definiowane przez element System.Net.

Aplikacja Szczegółowe informacje udostępnia trzy typy danych dla telemetrii niestandardowej:

• Śledzenie: używane bezpośrednio lub za pośrednictwem karty do implementowania rejestrowania diagnostycznego przy użyciu platformy instrumentacji, która jest ci znana, na przykład Log4Net lub System.Diagnostics.
• Zdarzenie: zazwyczaj służy do przechwytywania interakcji użytkownika z usługą w celu analizowania wzorców użycia.
• Metryka: służy do raportowania okresowych pomiarów skalarnych.

Każdy element telemetrii może definiować informacje kontekstowe , takie jak wersja aplikacji lub identyfikator sesji użytkownika. Kontekst to zestaw silnie typiowanych pól, które odblokowywać niektóre scenariusze. Gdy wersja aplikacji jest poprawnie zainicjowana, Szczegółowe informacje aplikacji może wykrywać nowe wzorce w zachowaniu aplikacji skorelowane z ponownym wdrożeniem.

Możesz użyć identyfikatora sesji, aby obliczyć awarię lub problem dotyczący użytkowników. Obliczanie odrębnej liczby wartości identyfikatorów sesji dla określonej zależności, śledzenia błędów lub wyjątku krytycznego daje dobre zrozumienie wpływu.

Model telemetrii application Szczegółowe informacje definiuje sposób korelowania danych telemetrycznych z operacją, której jest częścią. Na przykład żądanie może wykonać wywołanie usługi SQL Database i zarejestrować informacje diagnostyczne. Można ustawić kontekst korelacji dla tych elementów telemetrii, które są związane z powrotem do telemetrii żądania.

Ulepszenia schematu

Model danych application Szczegółowe informacje to podstawowy, ale zaawansowany sposób modelowania telemetrii aplikacji. Staramy się zachować prosty i szczupły model do obsługi podstawowych scenariuszy i umożliwić rozszerzenie schematu do użycia zaawansowanego.

Aby zgłosić problemy i sugestie dotyczące modelu danych lub schematu, skorzystaj z naszego repozytorium GitHub.

Zażądaj

Element telemetrii żądania w aplikacji Szczegółowe informacje reprezentuje logiczną sekwencję wykonywania wyzwalaną przez żądanie zewnętrzne do aplikacji. Każde wykonanie żądania jest identyfikowane przez unikatowe id i url zawierające wszystkie parametry wykonywania.

Żądania można grupować według wartości logicznej name i definiować source dla tego żądania. Wykonanie kodu może spowodować lub successfail i ma określony durationelement . Możesz dalej grupować wykonania sukcesów i niepowodzeń przy użyciu polecenia resultCode. Godzina rozpoczęcia telemetrii żądania jest definiowana na poziomie koperty.

Żądanie telemetrii obsługuje standardowy model rozszerzalności przy użyciu niestandardowych properties i measurements.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametry połączenia w celu skorzystania z nowych funkcji.

Nazwisko

To pole jest nazwą żądania i reprezentuje ścieżkę kodu pobraną do przetworzenia żądania. Niska wartość kardynalności umożliwia lepsze grupowanie żądań. W przypadku żądań HTTP reprezentuje ona metodę HTTP i szablon ścieżki adresu URL, tak jak GET /values/{id} bez rzeczywistej id wartości.

Zestaw SDK aplikacji Szczegółowe informacje sieci Web wysyła nazwę żądania "tak, jak to" o wielkości liter. Grupowanie w interfejsie użytkownika uwzględnia wielkość liter, dlatego GET /Home/Index jest liczone oddzielnie, GET /home/INDEX mimo że często powodują one wykonanie tego samego kontrolera i akcji. Przyczyną tego jest to, że adresy URL są ogólnie wrażliwe na wielkość liter. Możesz sprawdzić, czy wszystkie 404 błędy wystąpiły w przypadku adresów URL wpisanych wielkimi literami. Więcej informacji na temat zbierania nazw żądań można dowiedzieć się w ASP.NET internetowym zestawie SDK we wpisie w blogu.

Maksymalna długość: 1024 znaki

ID

Identyfikator to identyfikator wystąpienia wywołania żądania. Służy do korelacji między żądaniem a innymi elementami telemetrii. Identyfikator powinien być globalnie unikatowy. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii w Szczegółowe informacje aplikacji.

Maksymalna długość: 128 znaków

URL

Adres URL to adres URL żądania ze wszystkimi parametrami ciągu zapytania.

Maksymalna długość: 2048 znaków

Źródło

Źródło jest źródłem żądania. Przykłady to klucz instrumentacji obiektu wywołującego lub adres IP obiektu wywołującego. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii w Szczegółowe informacje aplikacji.

Maksymalna długość: 1024 znaki

Czas trwania

Czas trwania żądania jest sformatowany jako DD.HH:MM:SS.MMMMMM. Musi być dodatni i krótszy niż 1000 dni. To pole jest wymagane, ponieważ dane telemetryczne żądania reprezentują operację z początkiem i końcem.

Kod odpowiedzi

Kod odpowiedzi jest wynikiem wykonania żądania. Jest to kod stanu HTTP dla żądań HTTP. Może to być HRESULT wartość lub typ wyjątku dla innych typów żądań.

Maksymalna długość: 1024 znaki

Powodzenie

Powodzenie wskazuje, czy wywołanie zakończyło się powodzeniem, czy niepowodzeniem. To pole jest wymagane. Jeśli żądanie nie zostanie jawnie ustawione na falsewartość , zostanie uznane za pomyślne. Jeśli wyjątek lub zwrócony kod wyniku błędu przerwał operację, ustaw tę wartość na false.

W przypadku aplikacji internetowych aplikacja Szczegółowe informacje definiuje żądanie jako pomyślne, gdy kod odpowiedzi jest mniejszy lub 400 równy 401. Istnieją jednak przypadki, gdy to mapowanie domyślne nie pasuje do semantyki aplikacji.

Kod 404 odpowiedzi może wskazywać "brak rekordów", które mogą być częścią zwykłego przepływu. Może to również wskazywać na przerwane łącze. W przypadku przerwanych łączy można zaimplementować bardziej zaawansowaną logikę. Linki uszkodzone można oznaczyć jako błędy tylko wtedy, gdy te linki znajdują się w tej samej witrynie, analizując odwołanie do adresu URL. Możesz też oznaczyć je jako błędy w przypadku uzyskania dostępu z aplikacji mobilnej firmy. 301 Podobnie i 302 wskazuje błąd po korzystaniu z klienta, który nie obsługuje przekierowania.

Częściowo zaakceptowana zawartość 206 może wskazywać na niepowodzenie ogólnego żądania. Na przykład punkt końcowy aplikacji Szczegółowe informacje może odbierać partię elementów telemetrii jako pojedyncze żądanie. Jest zwracany 206 , gdy niektóre elementy w partii nie zostały pomyślnie przetworzone. Rosnąca liczba 206 wskazuje na problem, który należy zbadać. Podobna logika ma zastosowanie do 207 wielu stanów, gdzie powodzenie może być najgorszym z oddzielnych kodów odpowiedzi.

Właściwości niestandardowe

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

Pomiary niestandardowe

Kolekcja pomiarów niestandardowych: ta kolekcja służy do raportowania miar nazwanych skojarzonych z elementem telemetrii. Typowe przypadki użycia to:

• Rozmiar ładunku telemetrii zależności.
• Liczba elementów kolejki przetwarzanych przez dane telemetryczne żądania.
• Czas ukończenia kroku działania kreatora przez klienta podczas wykonywania telemetrii zdarzenia.

Możesz wykonywać zapytania dotyczące pomiarów niestandardowych w usłudze Application Analytics:

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

Uwaga

• Miary niestandardowe są skojarzone z elementem telemetrii, do którego należą. Podlegają one próbkowaniu z elementem telemetrii zawierającym te pomiary. Aby śledzić pomiar, który ma wartość niezależną od innych typów telemetrii, użyj telemetrii metryk.
• Nie używaj wartości ciągu dla pomiarów niestandardowych. Obsługiwane są tylko wartości liczbowe.

Maksymalna długość klucza: 150

Dependency

Telemetria zależności (w aplikacji Szczegółowe informacje) reprezentuje interakcję monitorowanego składnika ze składnikiem zdalnym, takim jak SQL lub punkt końcowy HTTP.

Nazwisko

To pole jest nazwą polecenia zainicjowanego za pomocą tego wywołania zależności. Ma niską wartość kardynalności. Przykłady to nazwa procedury składowanej i szablon ścieżki adresu URL.

ID

Identyfikator to identyfikator wystąpienia wywołania zależności. Służy do korelacji z elementem telemetrii żądania odpowiadającym temu wywołaniu zależności. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii w Szczegółowe informacje aplikacji.

Data

To pole jest poleceniem zainicjowanym przez to wywołanie zależności. Przykłady to instrukcja SQL i adres URL HTTP ze wszystkimi parametrami zapytania.

Typ

To pole jest nazwą typu zależności. Ma niską kardynalność dla logicznego grupowania zależności i interpretacji innych pól, takich jak commandName i resultCode. Przykłady to SQL, tabela platformy Azure i protokół HTTP.

Obiekt docelowy

To pole jest docelową lokacją wywołania zależności. Przykłady to nazwa serwera i adres hosta. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii w Szczegółowe informacje aplikacji.

Czas trwania

Czas trwania żądania ma format DD.HH:MM:SS.MMMMMM. Musi to być mniej niż 1000 dni.

Kod wyniku

To pole jest kodem wynikowym wywołania zależności. Przykłady to kod błędu SQL i kod stanu HTTP.

Powodzenie

To pole wskazuje na pomyślne lub nieudane wywołanie.

Właściwości niestandardowe

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

Pomiary niestandardowe

Kolekcja pomiarów niestandardowych: ta kolekcja służy do raportowania miar nazwanych skojarzonych z elementem telemetrii. Typowe przypadki użycia to:

• Rozmiar ładunku telemetrii zależności.
• Liczba elementów kolejki przetwarzanych przez dane telemetryczne żądania.
• Czas ukończenia kroku działania kreatora przez klienta podczas wykonywania telemetrii zdarzenia.

Możesz wykonywać zapytania dotyczące pomiarów niestandardowych w usłudze Application Analytics:

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

Uwaga

• Miary niestandardowe są skojarzone z elementem telemetrii, do którego należą. Podlegają one próbkowaniu z elementem telemetrii zawierającym te pomiary. Aby śledzić pomiar, który ma wartość niezależną od innych typów telemetrii, użyj telemetrii metryk.
• Nie używaj wartości ciągu dla pomiarów niestandardowych. Obsługiwane są tylko wartości liczbowe.

Maksymalna długość klucza: 150

Wyjątek

W Szczegółowe informacje aplikacji wystąpienie wyjątku reprezentuje obsłużony lub nieobsługiwany wyjątek, który wystąpił podczas wykonywania monitorowanej aplikacji.

Identyfikator problemu

Identyfikator problemu określa, gdzie wyjątek został zgłoszony w kodzie. Służy do grupowania wyjątków. Zazwyczaj jest to kombinacja typu wyjątku i funkcji ze stosu wywołań.

Maksymalna długość: 1024 znaki

Poziom ważności

To pole jest poziomem ważności śledzenia. Wartość może mieć Verbosewartość , , Information, ErrorWarning, lub Critical.

Szczegóły wyjątku

(Do rozszerzenia)

Właściwości niestandardowe

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

Pomiary niestandardowe

Kolekcja pomiarów niestandardowych: ta kolekcja służy do raportowania miar nazwanych skojarzonych z elementem telemetrii. Typowe przypadki użycia to:

• Rozmiar ładunku telemetrii zależności.
• Liczba elementów kolejki przetwarzanych przez dane telemetryczne żądania.
• Czas ukończenia kroku działania kreatora przez klienta podczas wykonywania telemetrii zdarzenia.

Możesz wykonywać zapytania dotyczące pomiarów niestandardowych w usłudze Application Analytics:

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

Uwaga

• Miary niestandardowe są skojarzone z elementem telemetrii, do którego należą. Podlegają one próbkowaniu z elementem telemetrii zawierającym te pomiary. Aby śledzić pomiar, który ma wartość niezależną od innych typów telemetrii, użyj telemetrii metryk.
• Nie używaj wartości ciągu dla pomiarów niestandardowych. Obsługiwane są tylko wartości liczbowe.

Maksymalna długość klucza: 150

Śledzenie

Dane telemetryczne śledzenia w Szczegółowe informacje aplikacji reprezentują printfinstrukcje śledzenia stylu, które są przeszukiwane tekstem. Log4Net, NLogi inne wpisy pliku dziennika opartego na tekście są tłumaczone na wystąpienia tego typu. Ślad nie ma miar jako rozszerzalności.

Wiadomość

Komunikat śledzenia.

Maksymalna długość: 32 768 znaków

Poziom ważności

Poziom ważności śledzenia.

Wartości:Verbose, Information, Warning, Errori Critical

Właściwości niestandardowe

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

Wydarzenie

Możesz utworzyć elementy telemetrii zdarzeń (w aplikacji Szczegółowe informacje), aby reprezentować zdarzenie, które wystąpiło w aplikacji. Zazwyczaj jest to interakcja użytkownika, taka jak kliknięcie przycisku lub wyewidencjonowania zamówienia. Może to być również zdarzenie cyklu życia aplikacji, takie jak inicjowanie lub aktualizacja konfiguracji.

Semantycznie zdarzenia mogą lub nie są skorelowane z żądaniami. W przypadku prawidłowego użycia dane telemetryczne zdarzeń są ważniejsze niż żądania lub ślady. Zdarzenia reprezentują telemetrię biznesową i powinny podlegać oddzielnemu, mniej agresywnemu próbkowaniu.

Nazwisko

Nazwa zdarzenia: aby umożliwić odpowiednie grupowanie i przydatne metryki, ogranicz aplikację tak, aby wygenerowała kilka oddzielnych nazw zdarzeń. Na przykład nie używaj oddzielnej nazwy dla każdego wygenerowanego wystąpienia zdarzenia.

Maksymalna długość: 512 znaków

Właściwości niestandardowe

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

Pomiary niestandardowe

Kolekcja pomiarów niestandardowych: ta kolekcja służy do raportowania miar nazwanych skojarzonych z elementem telemetrii. Typowe przypadki użycia to:

• Rozmiar ładunku telemetrii zależności.
• Liczba elementów kolejki przetwarzanych przez dane telemetryczne żądania.
• Czas ukończenia kroku działania kreatora przez klienta podczas wykonywania telemetrii zdarzenia.

Możesz wykonywać zapytania dotyczące pomiarów niestandardowych w usłudze Application Analytics:

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

Uwaga

• Miary niestandardowe są skojarzone z elementem telemetrii, do którego należą. Podlegają one próbkowaniu z elementem telemetrii zawierającym te pomiary. Aby śledzić pomiar, który ma wartość niezależną od innych typów telemetrii, użyj telemetrii metryk.
• Nie używaj wartości ciągu dla pomiarów niestandardowych. Obsługiwane są tylko wartości liczbowe.

Maksymalna długość klucza: 150

Metric

Aplikacja Szczegółowe informacje obsługuje dwa typy telemetrii metryk: pojedynczą miarę i metryki wstępnie agregowane. Pojedyncza miara to tylko nazwa i wartość. Wstępnie zagregowana metryka określa minimalną i maksymalną wartość metryki w interwale agregacji i odchylenie standardowe.

Wstępnie zagregowane dane telemetryczne metryk zakładają, że okres agregacji wynosił jedną minutę.

Aplikacja Szczegółowe informacje obsługuje kilka dobrze znanych nazw metryk. Te metryki są umieszczane w performanceCounters tabeli.

W poniższej tabeli przedstawiono metryki reprezentujące liczniki systemu i procesu.

Nazwa platformy .NET	Nazwa niezależna od platformy	opis
\Processor(_Total)\% Processor Time	Trwa praca...	Łączna liczba procesorów cpu maszyny.
\Memory\Available Bytes	Trwa praca...	Przedstawia ilość pamięci fizycznej w bajtach dostępnych dla procesów uruchomionych na komputerze. Jest obliczana przez sumowanie ilości miejsca na listach zerowanych, wolnych i rezerwowych pamięci. Ilość wolnej pamięci jest gotowa do użycia. Pamięć zerowa składa się ze stron pamięci wypełnionej zerami, aby zapobiec wyświetlaniu danych używanych przez poprzedni proces w późniejszych procesach. Pamięć rezerwowa to pamięć, która została usunięta z zestawu roboczego procesu (jego pamięci fizycznej) w drodze do dysku, ale nadal jest dostępna do odwołania. Zobacz Obiekt pamięci.
\Process(??APP_WIN32_PROC??)\% Processor Time	Trwa praca...	Procesor CPU procesu hostowania aplikacji.
\Process(??APP_WIN32_PROC??)\Private Bytes	Trwa praca...	Pamięć używana przez proces hostowania aplikacji.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Trwa praca...	Szybkość operacji we/wy uruchamianych przez proces hostowania aplikacji.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Trwa praca...	Szybkość żądań przetwarzanych przez aplikację.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Trwa praca...	Częstotliwość wyjątków zgłaszanych przez aplikację.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Trwa praca...	Średni czas wykonywania żądania.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Trwa praca...	Liczba żądań oczekujących na przetwarzanie w kolejce.

Aby uzyskać więcej informacji na temat interfejsu API REST metryk, zobacz Metryki — Pobieranie.

Nazwisko

To pole jest nazwą metryki, którą chcesz wyświetlić w portalu Szczegółowe informacje aplikacji i interfejsie użytkownika.

Wartość

To pole jest pojedynczą wartością pomiaru. Jest to suma poszczególnych pomiarów dla agregacji.

Count

To pole jest wagą metryki zagregowanej metryki. Nie należy go ustawiać dla miary.

Minimum

To pole jest minimalną wartością zagregowanej metryki. Nie należy go ustawiać dla miary.

Maksimum

To pole jest maksymalną wartością zagregowanej metryki. Nie należy go ustawiać dla miary.

Odchylenie standardowe

To pole jest odchyleniem standardowym zagregowanej metryki. Nie należy go ustawiać dla miary.

Właściwości niestandardowe

Metryka z właściwością niestandardową CustomPerfCounter ustawioną na true wartość wskazuje, że metryka reprezentuje licznik wydajności systemu Windows. Te metryki są umieszczane w performanceCounters tabeli, a nie w pliku customMetrics. Ponadto nazwa tej metryki jest analizowana w celu wyodrębnienia kategorii, licznika i nazw wystąpień.

Kolekcja właściwości niestandardowych typu name-value: ta kolekcja służy do rozszerzania standardowej telemetrii za pomocą wymiarów niestandardowych. Przykłady to miejsce wdrożenia, które wygenerowało dane telemetryczne lub właściwość specyficzną dla elementu telemetrii, na przykład numer zamówienia.

• Maksymalna długość klucza: 150
• Maksymalna długość wartości: 8192

PageView

Dane telemetryczne PageView (w aplikacji Szczegółowe informacje) są rejestrowane po otwarciu nowej strony monitorowanej aplikacji przez użytkownika aplikacji. Element Page w tym kontekście jest jednostką logiczną zdefiniowaną przez dewelopera jako kartą aplikacji lub ekranem i niekoniecznie jest skorelowana z ładowaniem strony internetowej przeglądarki ani akcją odświeżania. To rozróżnienie można dokładniej zrozumieć w kontekście aplikacji jednostronicowych (SPA), gdzie przełączanie między stronami nie jest powiązane z akcjami strony przeglądarki. Jest pageViews.duration to czas potrzebny aplikacji na wyświetlenie strony użytkownikowi.

Uwaga

• Domyślnie zestawy SDK Szczegółowe informacje aplikacji rejestrują pojedyncze PageView zdarzenia na każdej akcji ładowania strony internetowej przeglądarki z wypełnionym chronometrażempageViews.durationprzeglądarki. Deweloperzy mogą rozszerzyć dodatkowe śledzenie zdarzeń PageView przy użyciu wywołania interfejsu API trackPageView.
• Domyślne przechowywanie dzienników wynosi 30 dni. Jeśli chcesz wyświetlić PageView statystyki w dłuższym okresie, musisz dostosować ustawienie.

Mierzenie browserTiming w Szczegółowe informacje aplikacji

Nowoczesne przeglądarki udostępniają miary dla akcji ładowania stron za pomocą interfejsu API wydajności. Szczegółowe informacje aplikacji upraszcza te pomiary, konsolidując powiązane chronometraż do standardowych metryk przeglądarki zgodnie z definicjami czasu przetwarzania:

• Klient —> DNS: Klient <dociera do systemu DNS, aby rozpoznać nazwę hosta witryny internetowej, a dns odpowiada za pomocą adresu IP.

• Klient <—> serwer sieci Web: klient tworzy protokół TCP, a następnie uzgadnianie PROTOKOŁU TLS z serwerem internetowym.

• Klient —> serwer sieci Web: Klient <wysyła ładunek żądania, czeka na wykonanie żądania przez serwer i odbiera pierwszy pakiet odpowiedzi.

• Klient <— serwer sieci Web: klient odbiera pozostałe bajty ładunku odpowiedzi z serwera internetowego.

• Klient: Klient ma teraz pełny ładunek odpowiedzi i musi renderować zawartość w przeglądarce i załadować dom.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = 3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = 5

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

• pageViews/duration

  • Czas PageView trwania pochodzi z interfejsu chronometrażu wydajności przeglądarki, PerformanceNavigationTiming.duration.

  • Jeśli PerformanceNavigationTiming jest dostępny, ten czas trwania jest używany.

    Jeśli tak nie jest, jest używany przestarzałyPerformanceTiming interfejs, a różnica między NavigationStart i LoadEventEnd jest obliczana.

  • Deweloper określa wartość czasu trwania rejestrowania zdarzeń niestandardowych PageView przy użyciu wywołania interfejsu API trackPageView.

Kontekst

Każdy element telemetrii może mieć silnie typizowane pole kontekstu. Każde pole umożliwia korzystanie z określonego scenariusza monitorowania. Użyj kolekcji właściwości niestandardowych do przechowywania niestandardowych lub specyficznych dla aplikacji informacji kontekstowych.

Wersja aplikacji

Informacje w polach kontekstu aplikacji zawsze dotyczą aplikacji wysyłającej dane telemetryczne. Wersja aplikacji służy do analizowania zmian trendów w zachowaniu aplikacji i jej korelacji z wdrożeniami.

Maksymalna długość: 1024

Adres IP klienta

To pole jest adresem IP urządzenia klienckiego. Obsługiwane są protokoły IPv4 i IPv6. Gdy dane telemetryczne są wysyłane z usługi, kontekst lokalizacji dotyczy użytkownika, który zainicjował operację w usłudze. Aplikacja Szczegółowe informacje wyodrębnić informacje o lokalizacji geograficznej z adresu IP klienta, a następnie je obcinać. Sam adres IP klienta nie może być używany jako informacje umożliwiające identyfikację użytkownika.

Maksymalna długość: 46

Typ urządzenia

Pierwotnie to pole zostało użyte do wskazania typu urządzenia używanego przez użytkownika aplikacji. Obecnie jest używany głównie do odróżnienia telemetrii JavaScript z typem urządzenia od telemetrii po stronie serwera z typem BrowserPCurządzenia .

Maksymalna długość: 64

Identyfikator operacji

To pole jest unikatowym identyfikatorem operacji głównej. Ten identyfikator umożliwia grupowanie danych telemetrycznych w wielu składnikach. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii. Żądanie lub widok strony tworzy identyfikator operacji. Wszystkie inne dane telemetryczne ustawia to pole na wartość dla zawierającego żądania lub widoku strony.

Maksymalna długość: 128

Identyfikator operacji nadrzędnej

To pole jest unikatowym identyfikatorem najbliższego nadrzędnego elementu telemetrii. Aby uzyskać więcej informacji, zobacz Korelacja telemetrii.

Maksymalna długość: 128

Nazwa operacji

To pole jest nazwą (grupą) operacji. Żądanie lub widok strony tworzy nazwę operacji. Wszystkie inne elementy telemetrii ustawiają to pole na wartość zawierającego żądanie lub widok strony. Nazwa operacji służy do znajdowania wszystkich elementów telemetrii dla grupy operacji (na przykład GET Home/Index). Ta właściwość kontekstu służy do odpowiadania na pytania, takie jak Jakie są typowe wyjątki zgłaszane na tej stronie?

Maksymalna długość: 1024

Syntetyczne źródło operacji

To pole jest nazwą syntetycznego źródła. Niektóre dane telemetryczne z aplikacji mogą reprezentować ruch syntetyczny. Może to być przeszukiwacz internetowy indeksujący witrynę internetową, testy dostępności witryny lub ślady z bibliotek diagnostycznych, takich jak sam zestaw SDK Szczegółowe informacje aplikacji.

Maksymalna długość: 1024

Identyfikator sesji

Identyfikator sesji to wystąpienie interakcji użytkownika z aplikacją. Informacje w polach kontekstu sesji są zawsze o użytkowniku. Gdy dane telemetryczne są wysyłane z usługi, kontekst sesji dotyczy użytkownika, który zainicjował operację w usłudze.

Maksymalna długość: 64

Identyfikator użytkownika anonimowego

Anonimowy identyfikator użytkownika (User.Id) reprezentuje użytkownika aplikacji. Gdy dane telemetryczne są wysyłane z usługi, kontekst użytkownika dotyczy użytkownika, który zainicjował operację w usłudze.

Próbkowanie jest jedną z technik minimalizujących ilość zebranych danych telemetrycznych. Algorytm próbkowania próbuje pobrać próbkę lub wszystkie skorelowane dane telemetryczne. Identyfikator anonimowego użytkownika jest używany do generowania wyników próbkowania, więc identyfikator użytkownika anonimowego powinien być wystarczającą wartością losową.

Uwaga

Liczba identyfikatorów użytkowników anonimowych nie jest taka sama jak liczba unikatowych użytkowników aplikacji. Liczba identyfikatorów użytkowników anonimowych jest zwykle wyższa, ponieważ za każdym razem, gdy użytkownik otworzy aplikację na innym urządzeniu lub przeglądarce, lub czyści pliki cookie przeglądarki, zostanie przydzielony nowy unikatowy identyfikator anonimowego użytkownika. To obliczenie może spowodować wielokrotne liczenie tych samych użytkowników fizycznych.

Identyfikatory użytkowników można odwoływać się do identyfikatorów sesji w celu zapewnienia unikatowych wymiarów telemetrii i ustanowienia aktywności użytkownika w czasie trwania sesji.

Używanie anonimowego identyfikatora użytkownika do przechowywania nazwy użytkownika jest nieprawidłowym użyciem pola. Użyj uwierzytelnionego identyfikatora użytkownika.

Maksymalna długość: 128

Uwierzytelniony identyfikator użytkownika

Uwierzytelniony identyfikator użytkownika jest przeciwieństwem anonimowego identyfikatora użytkownika. To pole reprezentuje użytkownika o przyjaznej nazwie. Ten identyfikator jest domyślnie zbierany tylko przy użyciu zestawu SDK platformy AuthenticatedUserIdTelemetryInitializerASP.NET Framework.

Użyj zestawu SDK Szczegółowe informacje aplikacji, aby zainicjować uwierzytelniony identyfikator użytkownika z wartością identyfikującą użytkownika w sposób trwały w przeglądarkach i urządzeniach. W ten sposób wszystkie elementy telemetrii są przypisywane do tego unikatowego identyfikatora. Ten identyfikator umożliwia wykonywanie zapytań dotyczących wszystkich danych telemetrycznych zebranych dla określonego użytkownika (z zastrzeżeniem konfiguracji próbkowania i filtrowania telemetrii).

Identyfikatory użytkowników można odwoływać się do identyfikatorów sesji w celu zapewnienia unikatowych wymiarów telemetrii i ustanowienia aktywności użytkownika w czasie trwania sesji.

Maksymalna długość: 1024

Identyfikator konta

Identyfikator konta w aplikacjach wielodostępnych to identyfikator konta dzierżawy lub nazwa, z którą działa użytkownik. Jest ona używana do większej liczby segmentacji użytkowników, gdy identyfikator użytkownika i uwierzytelniony identyfikator użytkownika nie są wystarczające. Przykłady mogą być identyfikatorem subskrypcji witryny Azure Portal lub nazwą bloga dla platformy blogowania.

Maksymalna długość: 1024

Rola chmury

To pole jest nazwą roli, której częścią jest aplikacja. Mapuje ona bezpośrednio na nazwę roli na platformie Azure. Może również służyć do rozróżniania mikrousług, które są częścią jednej aplikacji.

Maksymalna długość: 256

Wystąpienie roli w chmurze

To pole jest nazwą wystąpienia, w którym aplikacja jest uruchomiona. Na przykład jest to nazwa komputera dla środowiska lokalnego lub nazwa wystąpienia platformy Azure.

Maksymalna długość: 256

Wewnętrzne: wersja zestawu SDK

Aby uzyskać więcej informacji, zobacz Wersja zestawu SDK.

Maksymalna długość: 64

Wewnętrzne: nazwa węzła

To pole reprezentuje nazwę węzła używaną do celów rozliczeniowych. Służy do zastępowania standardowego wykrywania węzłów.

Maksymalna długość: 256

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Jak zmierzyć wpływ kampanii monitorowania?

Telemetria PageView zawiera adres URL i można przeanalizować parametr UTM przy użyciu funkcji regex w usłudze Kusto.

Czasami te dane mogą być brakujące lub niedokładne, jeśli użytkownik lub przedsiębiorstwo wyłączy wysyłanie agenta użytkownika w ustawieniach przeglądarki. Wyrażenia regularne analizatora UA mogą nie zawierać wszystkich informacji o urządzeniu. Lub aplikacja Szczegółowe informacje może nie przyjąć najnowszych aktualizacji.

Dlaczego pomiar niestandardowy zakończy się powodzeniem bez błędu, ale dziennik nie zostanie wyświetlony?

Taka sytuacja może wystąpić, jeśli używasz wartości ciągu. Tylko wartości liczbowe działają z pomiarami niestandardowymi.

Następne kroki

Dowiedz się, jak używać interfejsu API Szczegółowe informacje aplikacji na potrzeby zdarzeń niestandardowych i metryk, w tym:

• Telemetria żądania niestandardowego
• Telemetria zależności niestandardowych
• Niestandardowe dane telemetryczne śledzenia
• Telemetria zdarzenia niestandardowego
• Telemetria metryk niestandardowych

Konfigurowanie śledzenia zależności dla:

• .NET
• Java

Dodatkowe informacje:

• Zapoznaj się z platformami obsługiwanymi przez usługę Application Szczegółowe informacje.
• Zapoznaj się ze standardową konfiguracją kolekcji właściwości kontekstu.
• Zapoznaj się z dziennikami śledzenia platformy .NET w Szczegółowe informacje aplikacji.
• Zapoznaj się z dziennikami śledzenia języka Java w Szczegółowe informacje aplikacji.
• Dowiedz się więcej o wbudowanej integracji usługi Azure Functions z aplikacją Szczegółowe informacje do monitorowania wykonywania funkcji.
• Dowiedz się, jak skonfigurować aplikację ASP.NET Core przy użyciu usługi Application Szczegółowe informacje.
• Dowiedz się, jak diagnozować wyjątki w aplikacjach internetowych za pomocą Szczegółowe informacje aplikacji.
• Dowiedz się, jak rozszerzać i filtrować dane telemetryczne.
• Użyj próbkowania , aby zminimalizować ilość danych telemetrycznych na podstawie modelu danych.