Udostępnij za pośrednictwem


SQL Server Extended Events Targets

SQL Server Rozszerzone docelowe zdarzenie są odbiorców zdarzeń.Cele można zapisać w pliku danych agregacja zdarzeń lub uruchomić zadanie, które jest powiązane zdarzenie.Cele można przetwarzać dane synchronicznego lub asynchronicznego.

Projekt Extended zdarzenia zapewnia elementów docelowych są gwarantowane odbierać zdarzenia raz i tylko jeden raz w ciągu danej sesja.

Rozszerzone zdarzenia zawierają następujące cele, których można używać dla sesja Extended zdarzenia:

  • Event bucketing

    Użyj do policzenia, ile razy występuje określonego zdarzenie, na podstawie kolumna określonego zdarzenie lub akcja.

  • Event pairing

    Wiele rodzajów zdarzenia występują w parach, takie jak blokowanie uzyskuje i zablokować wydań.Służy do określania, kiedy określonego zdarzenie sparowany nie występuje zestaw z dopasowaną.

  • Event Tracing for Windows (ETW)

    Służy do powiązania SQL Server zdarzenie zawierające dane zdarzeń systemu operacyjnego lub aplikacji systemu Windows.

  • Event file

    Należy użyć, aby zapisać dane wyjściowe sesja zdarzenie z buforów pamięci pełną na dysku.

  • Synchronous event counter

    Zlicza wszystkie określonego zdarzenia, które występują podczas sesja Extended zdarzenia.Służy do wyświetlania informacji na temat właściwości obciążenia bez dodawania obciążenie związane z zbieranie zdarzeń pełny.

  • Ring buffer

    Służy do przechowywania danych zdarzenia w pamięci na podstawie first-in first-out (FIFO) lub na podstawie FIFO na zdarzenie.

Elementy docelowe mogą być podzielone na cele plików i elementów docelowych w pamięci.

  • zdarzenie pliku docelowego i ETW miejsce docelowe są traktowane jako elementy docelowe pliku.

  • Zdarzenie bucketing, kojarzenie zdarzenia, Licznik Zdarzenia synchroniczne i cele bufor dzwonienia są uważane za docelowych w pamięci, gdy dane są przechowywane w buforze sesja (kolumna target_data dynamiczny widok zarządzania sys.dm_xe_session_targets).

Należy pamiętać, że po zatrzymaniu sesja, używający miejsce docelowe znajdującej się w pamięci wszystkie informacje, które są przechowywane w buforze sesja zostaną utracone.Jeśli chcesz uzyskać dostęp do danych zdarzenie po zatrzymaniu sesja, należy skonfigurować sesja, aby użyć pliku miejsce docelowe (zalecane) lub Zapisz dane przed zatrzymaniem sesja.

Można zdecydować, które za pomocą następujących wytycznych miejsce docelowe do używania.

Element zwracane typy

Zalecane użycie

zdarzenie pliku docelowego lub miejsce docelowe ETW

Użycie miejsce docelowe pliku, gdy jeden lub więcej z następujących warunków jest spełniony:

  • Zajdzie potrzeba wykonania danych długoterminowych kolekcja.

  • Chcesz zbierać dane dotyczące zdarzeń bardzo dużej.

  • Aby zachować zdarzenie danych historycznych celów.

Pierścień buforu docelowego

Za pomocą miejsce docelowe bufor dzwonienia, gdy są spełnione następujące warunki:

  • Chcesz przeprowadzić śledzenie cykliczne, gdzie stale zbierania danych, ale tylko opieki o ostatnich zdarzeń (około 2 megabajtów (MB) danych zdarzenie).Lub zajdzie potrzeba wykonania danych krótkoterminowe kolekcja i wyświetlanie ostatnich zdarzeń.

  • Chcesz wyświetlić wszystkie dane zdarzenie, które są przechwytywane w buforze sesja.Innymi słowy który chcesz wyświetlić nieprzetworzone dane, a nie zagregowane informacje.

  • Nie trzeba zachować zdarzenie danych historycznych celów.

miejsce docelowe bucketing zdarzenie, miejsce docelowe powiązań zdarzenie lub miejsce docelowe licznik zdarzenie synchroniczne

Użyj jednej z tych elementów docelowych w pamięci, gdy są spełnione następujące warunki:

  • Konieczne jest Rozwiązywanie problemów z określonego problemu za pomocą miejsce docelowe, które można wykonać jakąś formę analizy i agregowania danych zdarzenie.Na przykład można sprawdzić, czy wszystkie transakcje są po lewej stronie otwarte (zdarzenie kojarzenie miejsce docelowe) lub użytkownik może zechcesz obejrzeć jakie góry kwerendy przez użycie PROCESORA są za dany okres (miejsce docelowe bucketing zdarzenia).

  • Należy wykonać w krótkim okresie zbierania danych.

  • Nie trzeba zachować zdarzenie danych historycznych celów.

zdarzenie Element miejsce docelowe bucketing

Zdarzenie bucketing wystąpień grup miejsce docelowe typu określonego zdarzenia w oparciu o dane zdarzenie."Pakiet" jest grupą zdarzeń, które są obliczane na podstawie kolumna określonego zdarzenie lub akcja.miejsce docelowe bucketing zdarzenie można użyć do rozwiązywania problemów z wydajnością.Identyfikując zdarzenia, które występują najczęściej można znaleźć "punkty aktywne" wskazuje, że potencjalne przyczyny problemu wydajność.

W poniższej tabela opisano opcje, które mogą być używane do konfigurowania miejsce docelowe bucketing zdarzenie.

Opcja

Dozwolone wartości

Description

gniazda

Dowolną liczbą całkowitą.Wartość ta jest opcjonalna.

Określone przez użytkownika wartość określającą maksymalną liczbę przedziałów, aby zachować.Po osiągnięciu tej wartości, nowe zdarzenia, które nie należą do istniejących pakiety są ignorowane.

filtering_event_name

Każde zdarzenie w sesja Extended zdarzenia.Wartość ta jest opcjonalna.

Wartość określona przez użytkownika jest używana do identyfikowania klasy zdarzeń.Bucketed są tylko wystąpienia określonego zdarzenie.Wszystkie zdarzenia są ignorowane.

Jeśli określisz tę wartość, należy użyć formatu: package_name.nazwa_zdarzenia, na przykład 'sqlserver.checkpoint_end'. Nazwa pakiet można zidentyfikować za pomocą następującej kwerendy:

SELECT p.name, se.event_name
FROM sys.dm_xe_session_events se
JOIN sys.dm_xe_packages p
ON se_event_package_guid = p.guid
ORDER BY p.name, se.event_name

Jeśli nie określisz wartości filtering_event_name, source_type należy ustawić na wartość 1 (domyślnie).

source_type

Typ obiektu, na podstawie łańcucha.Ta wartość jest opcjonalny i jeśli nie określona została domyślna wartość 1.

Może mieć jeden z następujących wartości:

  • 0 na zdarzenie

  • 1 akcja

urządzenie źródłowe

Zdarzenie Nazwa kolumna lub akcja.

Zdarzenie kolumna lub akcja nazwa, która jest używana jako urządzenie źródłowe danych.

Po określeniu kolumną zdarzenie dla urządzenie źródłowe, należy określić kolumna ze zdarzeń, który jest używany dla wartości filtering_event_name.Można zidentyfikować potencjalne kolumn za pomocą następującej kwerendy:

SELECT name FROM sys.dm_xe_object_columns
WHERE object_name = '<eventname>'
AND column_type != 'readonly'

Po określeniu kolumną zdarzenie dla urządzenie źródłowe, nie trzeba dołączyć nazwę pakiet wartość źródłową.

Po określeniu o nazwie akcja dla urządzenie źródłowe, należy użyć jednej akcja, który jest skonfigurowany dla kolekcja w sesja zdarzenie, dla których używany jest ten obiekt miejsce docelowe.Aby znaleźć wartości potencjalne nazwy akcja, można wysyłać kwerendy kolumna action_name sys.dm_xe_sesssion_event_actions widoku.

Jeśli używasz o nazwie akcja jako urządzenie źródłowe danych, należy określić wartość urządzenie źródłowe przy użyciu formatu: package_name.action_name.

Poniższy przykład ilustruje na wysokim poziomie, w jaki sposób miejsce docelowe bucketing zdarzenie zbiera dane.W tym przykładzie, którego chcesz użyć do zliczania, ile czeka każdego typu oczekiwania wystąpił miejsce docelowe bucketing zdarzenie.Aby to zrobić, podczas definiowania miejsce docelowe bucketing zdarzeń czy określ następujące opcje:

  • filtering_event_name = "wait_info"

  • urządzenie źródłowe = "wait_type"

  • source_type = 0 (ponieważ wait_type zdarzenie kolumna)

W scenariuszu przykładzie dla urządzenie źródłowe wait_type rejestruje się następujące dane.

Filtrowanie nazwy zdarzenie

Wartość kolumna źródłowej

wait_info

file_io

wait_info

file_io

wait_info

sieci

wait_info

sieci

wait_info

tryb uśpienia

Wartości typu oczekiwania będzie można podzielić na trzy pakiety z następujących wartości i zlicza, gniazda:

Wartość

Licznik gniazdo

file_io

2

sieci

2

tryb uśpienia

1

Aby uzyskać więcej informacji na temat zdarzenie bucketing miejsce docelowe składni, zobacz How to: Monitor System Activity Using Extended Events.

miejsce docelowe bucketing zachowuje tylko dane zdarzenie dla określonego urządzenie źródłowe.W niektórych przypadkach dane opisujące zdarzenie może być zbyt duży, aby zachować całkowicie, w tym przypadek dane zostaną obcięte.Gdy dane zdarzenie zostanie obcięta do liczby całkowitej, liczba bajtów jest rejestrowane i wyświetlane jako dane wyjściowe XML.

miejsce docelowe bucketing serializes danych do programu wywołującego lub procedury w formacie XML.

Uwaga

Wyjście bucketing nie jest zgodna z dowolnego schematu.

Poniższy przykład przedstawia format wyjściowy bucketing miejsce docelowe.

<Slots truncated = "0" buckets=[count]>
    <Slot count=[count] trunc=[truncated bytes]>
        <value>
        </value>
    </Slot>
</Slots>

Element miejsce docelowe zdarzenie skojarzenia urządzeń

miejsce docelowe powiązań zdarzenie jest taka sama, jak dwa zdarzenie przy użyciu jednej lub kilku kolumn danych, które znajdują się w każdym zdarzeniu.Pary mogą mieć wiele zdarzeń, na przykład blokada uzyskuje i zablokować wydań.Po sekwencję zdarzeń w parach, zarówno zdarzenie są odrzucane.Odrzucanie dopasowane zestawów pozwala na łatwe wykrywanie nabycia blokada, które nie zostały zwolnione.

Za pomocą zdarzenie - poziom filtry, skojarzenia miejsce docelowe może służyć do tylko przechwytywania zdarzenie s nie są zgodne z kryteriami wstępną.

Korzystając z zdarzenie, kojarzenie miejsce docelowe można wybrać dwa zdarzenie, które zostaną dopasowane razem z kolejność kolumn, aby wykonać dopasowanie.Wszystkie kolumny w tej sekwencji muszą być tego samego typu.

W poniższej tabela opisano dostępne opcje konfigurowania powiązań zdarzenie.

Opcja

Dozwolone wartości

Description

begin_event

Dowolna nazwa zdarzenie znajduje się w bieżącej sesja.

Nazwa zdarzenie określające zdarzenie początku w parach sekwencji.

end_event

Dowolna nazwa zdarzenie znajduje się w bieżącej sesja.

Nazwa zdarzenie określające zdarzenie zakończenia w parach sekwencji.

begin_matching_columns

Zamówione, rozdzielane przecinkami listę nazw kolumn.

Kolumny, aby wykonać dopasowanie.

end_matching_columns

Zamówione, rozdzielane przecinkami listę nazw kolumn.

Kolumny, aby wykonać dopasowanie.

begin_matching_actions

Rozdzielanych przecinkami, uporządkowana lista działań.

Akcje do wykonania, dopasowywanie.

end_matching_actions

Rozdzielanych przecinkami, uporządkowana lista działań.

Akcje do wykonania, dopasowywanie.

respond_to_memory_pressure

Jeden z następujących wartości:

  • 0 = Nie nie odpowiada.

  • 1 = Zakończenia dodawania nowych sierot do listy, jeśli brakuje pamięci ciśnienia.

miejsce docelowe Odpowiedzi na zdarzenia pamięci.Jeśli ustawiona na wartość 1 i serwer ma za mało pamięci, nieparzysty informacje, które jest utrzymywanie są usuwane.

Wszystkie dane skojarzone z zdarzenie jest przechwycona, a przechowywane dla przyszłych powiązań.Ponadto również zbierane są dane dodawane przez akcje.Dane zebrane zdarzenie są przechowywane w pamięci i jako taka nie ma ograniczeń ograniczone.Limit ten jest oparty na wydajność systemu i działania.Zamiast przyjmowania maksymalną ilość pamięci, która może być użyta jako parametru, ilość pamięci, używany będzie opierać się na dostępnych zasobów systemowych.Jeśli nie są one dostępne, nieparzysty zdarzenia, które mają zostać zachowane zostaną usunięte.Jeśli nie zostały skojarzone zdarzenie zostało porzucone, pasujące zdarzenie pojawi się jako zdarzenie nieparzysty.

Kojarzenie miejsce docelowe serializes nieparzysty zdarzenia w formacie XML.Ten format nie jest zgodna z dowolnego schematu.Format zawiera tylko dwa typy elementów.The <unpaired> element is the root, followed by one <zdarzenie> element for each unpaired zdarzenie that is currently being tracked. The <zdarzenie> element contains one atrybut that contains the name of the unpaired zdarzenie.

Poniższy przykład przedstawia format wyjściowy miejsce docelowe powiązań.

<unpaired truncated = "0" matchedCount = "[matched count]" memoryPressureDroppedCount = " [lost count]">
    <event name  = "[event name]" package = "[package]" id= "[event ID value]" version = "[event version]">
    <data name = "[column name]"> 
    <type name = "[column type]" package = "[type package]" /> 
    <value>[column value]</value>
    <text value>[text value]</text>>
        </data>
    </event>
</unpaired>

Śledzenie zdarzenie dla docelowego systemu Windows

Przed użyciem zdarzeń śledzenia dla systemu Windows (ETW) jako miejsce docelowe, zaleca się, czy użytkownik posiada użytkownika praktycznej wiedza na temat ETW.Śledzenia ETW albo jest używana w połączeniu z rozszerzonym zdarzenie lub jako odbiorca zdarzeń Extended zdarzenie.Poniższe łącza zewnętrzne udostępniają punkt początkowy, aby uzyskać informacje dotyczące ETW:

Rozszerzone obsługuje zdarzenia ETW wersja systemu Windows XP i Windows Server 2003.miejsce docelowe ETW jest pojedynczych wartości miejsce docelowe, mimo że docelowym mogą być dodawane do wielu sesji.Jeśli zdarzenie jest wywoływane na wiele sesji, zdarzenie będzie tylko propagowane do jednego elementu docelowego ETW czas na wystąpienie zdarzenia.Aparat Extended zdarzeń jest ograniczony do pojedynczego wystąpienie jednego procesu.

Important noteImportant Note:

W celu miejsce docelowe ETW do pracy SQL Server Konto uruchamiania usługa musi być członkiem grupy Użytkownicy dzienników wydajności.

Konfiguracja zdarzeń w sesja programu ETW jest kontrolowana przez obsługującego aparat Extended zdarzenia.Aparat kontroluje zdarzeń do ognia i jakie warunki muszą być spełnione w celu zdarzenie uruchomienie.

Po wiązanie z sesja Extended zdarzenia, które łączy miejsce docelowe ETW po raz pierwszy podczas trwania procesu, miejsce docelowe ETW otwiera pojedynczej sesja ETW na SQL Server Dostawca. Jeżeli do sesja ETW już istnieje, obiekt miejsce docelowe ETW pobiera odwołanie do istniejącej sesja.Ta sesja ETW jest współużytkowane przez wszystkie SQL Server wystąpienia na danym komputerze. Ta sesja ETW odbiera wszystkie zdarzenia z sesji, które mają miejsce docelowe ETW.

Ponieważ ETW musi dostawców, aby mieć możliwość zużywają zdarzenia i dołącz je niedziałający, aby ETW, wszystkie pakiety Extended zdarzenia są włączone dla sesja.Jeśli zdarzenie jest uruchamiany, miejsce docelowe ETW wysyła zdarzenia do sesja, dla którego włączono dostawca dla zdarzenia.

ETW miejsce docelowe obsługuje synchroniczne publikowanie zdarzenie w wątek, który uruchomieniu zdarzenie.ETW obiekt miejsce docelowe nie obsługuje publikowania zdarzenie asynchroniczne.

ETW obiekt miejsce docelowe nie obsługuje formantu z zewnętrznym kontrolerów ETW, takie jak logman.exe.Do utworzenia śledzenia ETW zdarzenie sesja musi być utworzony obiekt docelowy ETW.Aby uzyskać więcej informacji zobaczCREATE zdarzenie sesja (języka Transact-SQL).

Uwaga

Włączanie miejsce docelowe ETW tworzy sesja programu ETW o nazwie XE_DEFAULT_ETW_SESSION.Jeśli sesja o tej nazwie już istnieje XE_DEFAULT_ETW_SESSION, jest ona używana bez modyfikowania wszystkie właściwości istniejącej sesji.XE_DEFAULT_ETW_SESSION jest współużytkowane przez wszystkie wystąpienia SQL Server. Po uruchomieniu XE_DEFAULT_ETW_SESSION, musisz zatrzymać go przy użyciu kontrolera ETW, takie jak narzędzie Logman.Na przykład można uruchomić następujące polecenie w wiersz polecenia: logman zatrzymania XE_DEFAULT_ETW_SESSION - ets.

W poniższej tabela opisano dostępne opcje konfigurowania miejsce docelowe ETW.

Opcja

Dozwolone wartości

Description

default_xe_session_name

Dowolny ciąg maksymalnie 256 znaków.Wartość ta jest opcjonalna.

Nazwa sesja Extended zdarzenia.Domyślnie jest to XESESSION0_4B7A5EC6-37EF-4d4c-81EC-13C547B9AC46.

default_etw_session_logfile_path

Dowolny ciąg maksymalnie 256 znaków.Wartość ta jest opcjonalna.

Ścieżka do pliku dziennika dla sesja Extended zdarzenia.Domyślnie jest to %TEMP%\ XEEtw.etl.

default_etw_session_logfile_size_mb

Dowolna liczba całkowita bez znaku.Wartość ta jest opcjonalna.

Rozmiar pliku dziennika, w megabajtach (MB) dla sesja Extended zdarzenia.Wartością domyślną jest 20 MB.

default_etw_session_buffer_size_kb

Dowolna liczba całkowita bez znaku.Wartość ta jest opcjonalna.

Pamięć w rozmiar buforu, w kilobajtach (KB), Extended zdarzenia sesja.Wartością domyślną jest 128 KB.

ponownych prób

Dowolna liczba całkowita bez znaku.

Liczba ponownych prób publikowanie zdarzenie ETW podsystemu przed upuszczanie zdarzenie.Wartość domyślna to 0.

Konfigurowanie poprzednich ustawień jest opcjonalna.miejsce docelowe ETW używa wartości domyślnych dla tych ustawień.

Obiekt miejsce docelowe ETW jest następujący:

  • Tworzenie sesja ETW domyślne.

  • Rejestrowanie wszystkich pakietów Extended zdarzenia z ETW.Pozwala to uzyskać pewność, że zdarzenia nie są usuwane przez ETW.

  • Zarządzanie przepływem zdarzenia ETW.ETW miejsce docelowe tworzy zdarzenie ETW danymi Extended zdarzenie i wysyła go do odpowiedniej sesja ETW.Jeśli zdarzenie jest większy niż rozmiar buforu lub danych nie pasują do jednego zdarzenia ETW, zdarzenia ETW dzieli się na fragmenty.

  • Utrzymywanie Extended zdarzenia pakietów włączony przez cały czas.

ETW używane są następujące domyślne lokalizacje plików:

  • Plik wyjściowy ETW jest % TEMP%\XEEtw.etl.

    Important noteImportant Note:

    Nie można zmienić ścieżka do pliku, po uruchomieniu pierwszej sesja.

  • Zarządzane Object Format (MOF) pliki znajdują się w <ścieżka instalacji programu>\Microsoft SQL Server\Shared. Aby uzyskać więcej informacji zobacz Zarządzane format obiektu w witrynie MSDN.

zdarzenie Pliku docelowego

zdarzenie Plik miejsce docelowe jest asynchroniczne docelowego, który zapisuje pełną buforów dysku.Plik miejsce docelowe tworzy dwa typy plików, dziennik i metadane.Plik metadane informacje znajdujące się w pliku dziennika wyjściowego miejsce docelowe zawartość zdarzenie.Pozwala to na prawidłowe analizowania wszystkich zdarzeń w pliku dziennika, a także podczas analizowania danych akcja skojarzonego ze zdarzeniem.

Aby użyć tego miejsce docelowe należy określić plik i metadane nazwę pliku dziennika lokalizacji.Inne opcje konfiguracja, takie jak rozmiar i wzrost właściwości pliku są opcjonalne.

W poniższej tabela opisano dostępne opcje konfigurowania miejsce docelowe pliku zdarzenie.

Opcja

Dozwolone wartości

Description

Nazwa pliku

Dowolny ciąg maksymalnie 260 znaków.Wartość ta jest wymagana.

Lokalizację i nazwę pliku.

Można użyć dowolnego innego rozszerzenia nazwy pliku.

max_file_size

Dowolna liczba całkowita 64-bitowych.Wartość ta jest opcjonalna.

Maksymalny rozmiar pliku w megabajtach (MB).Jeżeli nie określono max_file_size, plik będzie rosnąć do momentu dysk jest zapełniony.Domyślny rozmiar pliku wynosi 1 GB.

max_file_size musi być większa niż bieżący rozmiar buforów sesja.Jeśli nie jest dostępne, plik miejsce docelowe nie będzie można zainicjować, raportowania, że max_file_size jest nieprawidłowy.Aby wyświetlić bieżący rozmiar buforów, kwerendy kolumna buffer_size sys.dm_xe_sessions dynamicznego zarządzania widoku.

Jeśli domyślny rozmiar pliku jest mniejszy niż rozmiar buforu sesja, zaleca się ustawienie na wartość określoną kolumna max_memory max_file_size sys.server_event_sessionsSłuży do wyświetlania katalogu .

Gdy max_file_size ma rozmiar większy niż rozmiar buforów sesja, to mogą być zaokrąglane niedziałający do najbliższej wielokrotności rozmiaru buforu sesja.To może utworzyć pliku docelowego, który jest mniejszy niż określona wartość max_file_size.Na przykład, jeśli rozmiar buforu jest 100 MB i max_file_size jest zestaw do 150 MB, rozmiar pliku wynikowego jest zaokrąglana niedziałający do 100 MB, ponieważ bufor drugiego czy nie mieści się w pozostałych 50 MB miejsca na.

Jeśli domyślny rozmiar pliku jest mniejszy niż rozmiar buforu sesja, zaleca się ustawienie max_file_size wartość kolumna max_memory sys.server_event_sessions Służy do wyświetlania katalogu.

max_rollover_files

Dowolna liczba całkowita 32-bitowych.Wartość ta jest opcjonalna.

Maksymalna liczba plików, aby zachować w systemie plików.

wartość przyrostu

Dowolna liczba całkowita 32-bitowych.Wartość ta jest opcjonalna.

Przyrostowe wzrostu w megabajtach (MB) dla pliku.Jeżeli nie określono tego parametru, domyślna wartość przyrostu jest dwukrotnie rozmiar buforu sesja.

MetadataFile

Dowolny ciąg maksymalnie 260 znaków.Wartość ta jest wymagana.

Lokalizacja i nazwa metadane dla pliku.

Pierwszy czas że tworzony jest plik miejsce docelowe, należy określić nazwę pliku są dołączane _0_ i wartości Liczba całkowita długa.Wartość całkowita jest obliczany jako liczba milisekund między 1 stycznia 1600 oraz data i czas plik jest tworzony.Ten format służy także najazdu kolejnych plików.Z badania wartość długa liczba całkowita, można określić najbardziej bieżącego pliku.Poniższy przykład ilustruje, w jaki sposób pliki są nazywane w sytuacji, gdy określono opcję nazwy pliku jako C:\OutputFiles\MyOutput.xel:

  • pierwszy plik utworzony - C:\OutputFiles\MyOutput_0_128500310259380000.xel

  • pierwszy plik przerzucania - C:\OutputFiles\MyOutput_0_128505831770890000.xel

  • drugi plik przerzucania - C:\OutputFiles\MyOutput_0_132410772966237000.xel

Synchroniczne zdarzenie licznika docelowa

miejsce docelowe zdarzenie synchroniczne licznik zlicza wszystkie zdarzenie, które ognia podczas sesja Extended zdarzenie.Za pomocą miejsce docelowe Licznik Synchroniczne zdarzenie, można uzyskać informacji na temat właściwości obciążenia bez dodawania obciążenie związane z zbieranie zdarzeń pełny.Ten obiekt miejsce docelowe nie ma żadnych parametrów można dostosowywać.

Poniższy przykład przedstawia dane wyjściowe miejsce docelowe Licznik Synchroniczne zdarzenie.

<CounterTarget truncated = "0">
  <Packages>
    <Package name = "[package name]">
      <Event name = "[event name]" count = "[number]" />
    </Package>
  </Packages>
</CounterTarget>

Dzwonek buforu miejsce docelowe

miejsce docelowe bufor dzwonienia krótko przechowuje dane opisujące zdarzenie w pamięci.Ten obiekt miejsce docelowe może zarządzać zdarzeń w jednym z dwóch trybów.

  • Pierwszy tryb jest ściśle first-in first-out (FIFO), gdzie najstarszych zdarzeń jest odrzucany, gdy używana jest cała pamięć przydzielona do miejsce docelowe.W tym trybie (ustawienie domyślne), jest opcja occurrence_number zestaw na 0.

  • Tryb drugiego jest FIFO zdarzenie, gdzie są przechowywane określoną liczbę zdarzeń każdego typu.W tym trybie najstarszych zdarzeń każdego typu są odrzucane, gdy używany jest cała pamięć przydzielona do miejsce docelowe.Można skonfigurować opcję occurrence_number, aby określić liczbę zdarzeń każdego typu, aby zachować.

W poniższej tabela opisano dostępne opcje konfigurowania miejsce docelowe bufor dzwonienia.

Opcja

Dozwolone wartości

Description

default_memory

Dowolna liczba całkowita 32-bitowych.Wartość ta jest opcjonalna.

Maksymalna ilość pamięci w kilobajtach (KB), aby użyć.Istniejące zdarzenia są odrzucane, po osiągnięciu tej wartości.

occurrence_number

Jeden z następujących wartości:

  • 0 (domyślnie) = najstarsze zdarzenie jest odrzucany, gdy używana jest cała pamięć przydzielona do miejsce docelowe.

  • Dowolna liczba całkowita 32-bitowe = liczba zdarzeń każdego typu, aby zachować zanim zostanie odrzucony na podstawie FIFO na zdarzenie.

Wartość ta jest opcjonalna.

Z FIFO trybu użyć i, jeśli ustawiona na wartość większą niż 0, preferowane liczbę zdarzeń, dla każdego typu, który ma przechowywać w buforze.

Poniższy przykład przedstawia bufor cykliczny miejsce docelowe danych wyjściowych.

<RingBufferTarget eventsPerSec="" processingTime="" totalEventsProcessed="" eventCount="" droppedCount="" memoryUsed="">
 <event name="" package="" id="" version="" timestamp="">
    <data name="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </data>
    <action name="" package="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </action>
  </event>
</RingBufferTarget>

Historia zmian

Microsoft Learning

Dodano notatek o sesja XE_DEFAULT_ETW_SESSION do sekcji "Zdarzenie śledzenia dla systemu Windows".

Wprowadzenie dodane krótkie opisy dla każdego typu docelowego i wskazówki dodano zalecany sposób użycia.