Udostępnij za pośrednictwem


Rozszerzone cele zdarzeń programu SQL Server

SQL Server Rozszerzone cele zdarzenie są odbiorców zdarzeń.Cele można zapisać w pliku danych wartość zagregowana zdarzeń lub uruchomić zadanie, które jest powiązane zdarzenie. Cele można przetwarzać dane synchronicznie lub asynchronicznie.

Projekt rozszerzone zdarzenia zapewnia, że cele gwarantowana odbierać zdarzenia raz i tylko raz na sesja.

Rozszerzone zdarzenia dostarcza następujących wielkości docelowych używające sesja rozszerzone zdarzenia:

  • Zdarzenie bucketing

    Służy do zliczania, ile razy wystąpi określone zdarzenie, na podstawie kolumna określone zdarzenie lub akcja.

  • Kojarzenie zdarzenia

    Wiele rodzajów zdarzenia występują w parach, takich jak blokada nabywa i blokada zwalnia.Służy do określenia, kiedy określone zdarzenie sparowany nie występuje w zestaw pasujących.

  • Śledzenie zdarzeń systemu Windows (ETW)

    Służy do skorelowania SQL Server zdarzeń z systemu operacyjnego lub aplikacji dane zdarzenie.

  • Plik zdarzeń

    Umożliwia zapis zdarzenie sesja wyjścia z buforów pamięci na dysku.

  • Synchroniczne zdarzenie licznika

    Zlicza wszystkie określonych zdarzeń występujących podczas sesja rozszerzone zdarzenia.Umożliwia uzyskanie informacji na temat charakterystyki obciążenia bez dodawania narzutów pełne zdarzenie kolekcja.

  • Bufor cykliczny

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

Cele można podzielić na cele pliku i cele w pamięci.

  • Zdarzenie plików miejsce docelowe i ETW są uważane za plików miejsce docelowe.

  • Zdarzenie bucketing, kojarzenie zdarzenia licznika zdarzeniach synchronicznych i cele buforu ring są uważane za docelowych w pamięci, gdy dane są przechowywane w buforze sesja ( target_data kolumna sys.dm_xe_session_targets dynamiczny widok zarządzania).

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

Za pomocą następujące wskazówki ułatwiające podjęcie decyzji, które miejsce docelowe do używania.

Docelowa

Zalecane użycie

miejsce docelowe zdarzenia w pliku lub miejsce docelowe ETW.

Korzystanie z pliku miejsce docelowe po jednej lub więcej z następujących warunków jest spełniony:

  • Chcesz wykonać długoterminowe danych kolekcja.

  • Chcesz zbierać dane dla zdarzeń bardzo dużej.

  • Aby zachować zdarzenie danych do celów historycznych.

Bufor cyklicznymiejsce docelowe

Bufor cykliczny za pomocą miejsce docelowe gdy są spełnione następujące warunki:

  • Chcesz wykonać śledzenie cykliczne, gdzie stale zbierania danych, ale tylko opieki o ostatnich zdarzeń (około 2 megabajtów (MB) danych zdarzenie).Lub chcesz wykonać krótkoterminowe danych kolekcjai 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ć dane surowe i nie zagregowane informacje.

  • Nie trzeba przechowywać dane zdarzenie w celach historycznych.

Bucketing miejsce docelowe zdarzenie, parowania miejsce docelowe zdarzenie lub miejsce docelowe Licznik Synchroniczne zdarzenie

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

  • Potrzeba rozwiązania określonego problemu za pomocą miejsce docelowe, który można wykonać jakąś formę analizy i agregacja danych zdarzenie.Na przykład można sprawdzić, czy wszystkie transakcje pozostają otwarte (zdarzenie parowania domiejsce doceloweowej) lub można zobaczyć jakie góry są kwerendy przez użycie Procesora przez danego czas okresu (bucketing miejsce docelowe zdarzenia).

  • Chcesz wykonać krótkoterminowe danych kolekcja.

  • Nie trzeba przechowywać dane zdarzenie w celach historycznych.

Bucketing cel zdarzenia

Zdarzenie bucketing grup miejsce docelowe wystąpień określonego typu zdarzenia na podstawie danych zdarzenia."Łańcucha" jest grupowanie zdarzeń, które są uwzględniane w oparciu o kolumna określone zdarzenie lub akcja.Rozwiązywanie problemów z wydajnością, można użyć miejsce docelowe zdarzenie bucketing.Identyfikując którego zdarzeń występujących najczęściej, można znaleźć "punkty aktywne" który wskazują potencjalne przyczyny problemów z wydajnością.

W poniższej tabela opisano opcje, których można używać do konfigurowania miejsce docelowe zdarzenie bucketing.

Opcja

Dozwolone wartości

Opis

slots

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

Określona przez użytkownika wartość wskazuje maksymalną liczbę pakiety, aby zachować.Po osiągnięciu tej wartości, nowe zdarzenia, które nie należą do istniejącego pakiety są ignorowane.

filtering_event_name

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

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

Jeśli określisz tę wartość, należy użyć formatu: nazwa_pakietu.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 filtering_event_name wartości, source_type musi być zestaw 1 (domyślnie).

source_type

Typ obiektu, na podstawie Wiadro z farbą.Wartość ta jest opcjonalna i jeżeli nie określono ma domyślną wartość 1.

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

  • 0 dla zdarzenie

  • 1 dla akcja

source

Nazwa kolumna lub akcja zdarzenia.

Zdarzenie kolumna lub akcja nazwa jest używana jako źródło danych.

Po określeniu kolumnie zdarzenia source, należy określić kolumna zdarzenie, które jest używane do filtering_event_name wartości.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 zdarzenie kolumna dla source, nie musi zawierać nazwę pakiet w source wartości.

Po określeniu nazwy akcja source, należy użyć jednej z akcja, które skonfigurowano dla kolekcja w sesja zdarzenie, w której używany jest ten obiekt miejsce docelowe.Aby znaleźć wartości potencjalnych Nazwa akcja, kwerendy można action_name kolumna sys.dm_xe_sesssion_event_actions Widok.

Jeśli używasz nazwy akcja jako źródło danych, należy określić source wartość przy użyciu formatu: nazwa_pakietu.action_name.

Poniższy przykład ilustruje na wysokim poziom jak bucketing miejsce docelowe zdarzenie zbiera dane.W tym przykładzie ma używać do zliczania, ile czeka każdego typu oczekiwania wystąpił bucketing miejsce docelowe zdarzenie.Aby to zrobić, podczas definiowania bucketing miejsce docelowe zdarzenie byłyby określ następujące opcje:

  • filtering_event_name = "wait_info"

  • source = "wait_type"

  • source_type = 0 (ponieważ wait_type jest kolumna zdarzenie)

W scenariuszu przykład dla źródło wait_type rejestruje się następujące dane.

Filtrowanie Nazwa zdarzenie

Wartość kolumna źródłowe

wait_info

file_io

wait_info

file_io

wait_info

sieci

wait_info

sieci

wait_info

tryb uśpienia

Wartości typu oczekiwania czy podzielić na trzy pakiety, z następującymi wartościami i zlicza gniazda:

Wartość

Liczba gniazd

file_io

2

sieci

2

tryb uśpienia

1

Aby uzyskać więcej informacji dotyczących zdarzeń bucketing miejsce docelowe składni, zobacz Jak Monitor aktywności systemu przy użyciu rozszerzonych zdarzenia.

Bucketing miejsce docelowe tylko zachowuje dane zdarzenie dla określonego źródło.W niektórych przypadkach dane zdarzenie może być zbyt duży, aby zachować całkowicie, w którym to przypadek dane obcięte.Gdy dane zdarzenie jest obcięte, liczba bajtów jest rejestrowane i wyświetlane jako dane wyjściowe XML.

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

Ostrzeżenie

Bucketing dane wyjściowe nie jest zgodna z dowolnego schematu.

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

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

Kojarzenie cel zdarzenia

miejsce docelowe zdarzenie parowania dopasowuje dwa zdarzenie przy użyciu jednej lub kilku kolumn danych, które są obecne w każdym przypadku.Wiele zdarzeń pochodzą w parach, na przykład blokada nabywa i zablokować wydań.Po sekwencję zdarzeń jest sparowany, zarówno zdarzenie są odrzucane.Odrzucanie dopasowane zestawy umożliwia łatwe wykrycie nabycia blokada, które nie zostały zwolnione.

Za pomocą filtrów poziom zdarzeń, kojarzenie miejsce docelowe można tylko przechwytywania zdarzeń, które nie spełniają ustalonych kryteriów.

Przy użyciu skojarzenia zdarzeń miejsce docelowe możesz wybrać dwa zdarzenie, które zostaną dopasowane wraz z sekwencją kolumny, aby wykonać dopasowanie na.Wszystkie kolumny w tej sekwencji musi być tego samego typu.

W poniższej tabela opisano opcje dostępne dla konfigurowania zdarzenie par.

Opcja

Dozwolone wartości

Opis

begin_event

Wszelkie nazwy zdarzenie jest obecny w bieżącej sesja.

Określanie początku zdarzenie w sekwencji par nazwa zdarzenie.

end_event

Wszelkie nazwy zdarzenie jest obecny w bieżącej sesja.

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

begin_matching_columns

Rozdzielanych przecinkami, Lista uporządkowana kolumna nazwy.

Kolumny do wykonywania dopasowywania.

end_matching_columns

Rozdzielanych przecinkami, Lista uporządkowana kolumna nazwy.

Kolumny do wykonywania dopasowywania.

begin_matching_actions

Rozdzielany przecinkami, uporządkowaną listę czynności.

Akcje do wykonania dopasowywania.

end_matching_actions

Rozdzielany przecinkami, uporządkowaną listę czynności.

Akcje do wykonania dopasowywania.

respond_to_memory_pressure

Jedna z następujących wartości:

  • 0 = Nie odpowiada.

  • 1 = Zatrzymaj dodanie do listy nowego sierot, po presji pamięci.

Odpowiedź miejsce docelowe zdarzenia pamięci.Jeśli zestaw 1 i serwer ma za mało pamięci, usunięte nieparzysty informacje są przechowywane.

Dane skojarzone z zdarzenie przechwyceniu i zapisaniu dla przyszłych parowania.Ponadto również zbierane są dane dodane przez akcje.Dane zebrane zdarzenie są przechowywane w pamięci i jako takie ma skończoną limit.Limit ten jest oparty na wydajność systemu i aktywności.Zamiast maksymalną ilość pamięci do wykorzystania jako parametru, ilość pamięci używana będzie opierać się na dostępnych zasobów systemowych.Gdy nie są one dostępne, nieparzysty zdarzenia, które zostały zachowane zostaną usunięte.Jeśli nie zostały skojarzone zdarzenie zostało porzucone, pasujące zdarzenie pojawi się jako nieparzysty zdarzenie.

miejsce docelowe parowania serializes nieparzysty zdarzenia w formacie XML.Ten format nie jest zgodna z dowolnego schematu.Format zawiera tylko dwa typy elementów.<Nieparzysty> element jest głównym, po czym <zdarzenie> element dla każdego zdarzenie nieparzysty, który aktualnie jest śledzona.<zdarzenie> element zawiera jeden atrybut zawierający nazwę zdarzenie nieparzysty.

Poniższy przykład ilustruje parowania format wyjściowy miejsce docelowe.

<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 zdarzeń dla docelowego systemu Windows

Przed użyciem zdarzeń śledzenia dla systemu Windows (ETW) jako miejsce docelowe, zalecamy posiadają pracy wiedza z ETW.Śledzenia ETW albo jest używany w połączeniu ze zdarzeniami rozszerzone lub jako odbiorca zdarzeń rozszerzone zdarzenie.Poniższe łącza zewnętrzne zapewniają punkt wyjścia dla uzyskania informacje dotyczące ETW:

Rozszerzone obsługuje zdarzenia ETW wersja systemu Windows XP i Windows Server 2003.miejsce docelowe ETW jest tarczę singleton, chociaż miejsce docelowe mogą być dodawane do wielu sesji.Jeśli zdarzenie jest wywoływane na wiele sesji, zdarzenie tylko będzie propagowane do docelowej ETW jedną czas na wystąpienie zdarzenia.Aparat rozszerzone zdarzenia jest ograniczone do pojedynczego wystąpienie jednego procesu.

Ważna informacjaWażne:

W celu miejsce docelowe ETW pracy SQL Server konto uruchamiania usługi musi być element członkowski w grupie Użytkownicy dziennika wydajności.

Konfiguracja w sesja ETW zdarzenia jest kontrolowana przez proces obsługujący silnika rozszerzone zdarzenia.Aparat kontroluje zdarzeń do ognia i jakie warunki muszą być spełnione w celu zdarzenie.

Po powiązanie do sesja rozszerzone zdarzenia, którego dołącza miejsce docelowe ETW w pierwszym czas podczas trwaniaczas procesu, miejsce docelowe ETW otwiera pojedynczej sesja ETW na SQL Server dostawca.Jeżeli sesja ETW już istnieje, miejsce docelowe ETW pobiera odwołanie do istniejącej sesji.Ta sesja ETW jest współużytkowane przez wszystkie SQL Server wystąpień na danym komputerze.Ta sesja ETW odbiera wszystkie zdarzenia z sesji, które mają miejsce docelowe ETW.

Ponieważ ETW dostawców włączone zajmują zdarzeń i ich przepływu niedziałający do ETW, wszystkie pakiety rozszerzone zdarzenia są włączone w sesja.Podczas zdarzenie jest uruchamiany, miejsce docelowe ETW wysyła zdarzenie do sesja włączono dostawca dla zdarzenie.

miejsce docelowe ETW obsługuje synchroniczne publikowanie zdarzenia w wątek, który fires zdarzenie.Jednak ETW miejsce docelowe nie obsługuje asynchroniczny zdarzenie publikacji.

miejsce docelowe ETW nie obsługuje sterowania z zewnętrznych kontrolerów ETW, takich jak logman.exe.Do produkcji śladów ETW, sesja zdarzeń muszą być tworzone ETW miejsce docelowe.Aby uzyskać więcej informacji, zobacz Tworzenie sesji zdarzeń języka Transact-SQL).

Ostrzeżenie

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

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

Opcja

Dozwolone wartości

Opis

default_xe_session_name

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

Nazwa sesja rozszerzone 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, Extended zdarzenia sesja.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 rozszerzone zdarzenia.Wartość domyślna to 20 MB.

default_etw_session_buffer_size_kb

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

Rozmiar buforu w pamięci w kilobajtach (KB) dla sesja rozszerzone zdarzenia.Wartość domyślna to 128 KB.

retries

Dowolna liczba całkowita bez znaku.

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

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

miejsce docelowe ETW jest odpowiedzialny za:

  • Tworzenie sesja ETW domyślne.

  • Rejestrowanie wszystkich pakietów rozszerzone zdarzenia z ETW.Gwarantuje to, że zdarzenia nie są porzucane ETW.

  • Zarządzanie przepływem zdarzenia ETW.miejsce docelowe ETW tworzy zdarzenie ETW danymi rozszerzone zdarzenie i wysyła go do odpowiedniej sesja ETW.Jeśli zdarzenie jest większy niż rozmiar buforu lub dane nie dopasowanie w jednym przypadku ETW ETW dzieli zdarzenia na fragmenty.

  • Utrzymywanie rozszerzone 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.

    Ważna informacjaWażne:

    Nie można zmienić ścieżka pliku, po rozpoczęciu pierwszej sesja.

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

Cel zdarzenia w pliku

miejsce docelowe zdarzenie w pliku jest asynchroniczne docelowego, który zapisuje pełną buforów dysku.Plik miejsce docelowe tworzy dwa typy plików dziennika i metadane.Plik metadane opisano zdarzenie zawartość obecne w miejsce docelowe wyjściowego pliku dziennika.Umożliwia to prawidłowe analizy wszystkich zdarzenies w pliku dziennika, a także analizowanie danych działań związanych z zdarzenie.

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

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

Opcja

Dozwolone wartości

Opis

filename

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śli max_file_size nie zostanie określona, plik będzie rosnąć, aż dysk jest pełny.Domyślny rozmiar pliku wynosi 1 GB.

max_file_size musi być większy niż bieżący rozmiar buforów sesja.Jeśli nie jest, miejsce docelowe plik nie będzie zainicjować, sprawozdawczości, max_file_size jest nieprawidłowy.Aby wyświetlić bieżący rozmiar buforów, kwerenda buffer_size kolumna w sys.dm_xe_sessions dynamiczny widok zarządzania.

Jeśli domyślny rozmiar pliku jest mniejszy niż rozmiar buforu sesja, zaleca się ustawienie max_file_size wartość określoną w max_memory kolumna w sys.server_event_sessions wykazu widoku.

Gdy max_file_size jest zestaw rozmiar większy niż rozmiar buforów sesja, to mogą być zaokrąglane niedziałający do najbliższej wielokrotności rozmiar buforu sesja.Może spowodować miejsce docelowe pliku, 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 wynikowego pliku jest zaokrąglana niedziałający do 100 MB, ponieważ bufor drugiego nie zmieszczą się w pozostałe 50 MB miejsca.

Jeśli domyślny rozmiar pliku jest mniejszy niż rozmiar buforu sesja, zaleca się ustawienie max_file_size wartości w max_memory kolumna w sys.server_event_sessions wykazu widoku.

max_rollover_files

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

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

increment

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

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

metadatafile

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

Lokalizacja i nazwa pliku metadane.

Pierwszy czas że tworzony jest plik miejsce docelowe, należy określić nazwę pliku jest dołączana z 0 i wartość Liczba całkowita długa.Wartość całkowita jest obliczany jako liczba milisekund między 1 stycznia 1600 i data i czas tworzony jest plik.Ten format służy także najazdu kolejnych plików.Z badania wartość Liczba całkowita długa, można określić najczęściej bieżącego pliku.Poniższy przykład ilustruje nazewnictwa plików w scenariuszu, w którym można określić filename opcji 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

Cel licznik zdarzenia synchroniczne

miejsce docelowe zdarzenie synchroniczne licznik zlicza wszystkie zdarzenie, które ognia podczas sesja rozszerzone zdarzenie.Przy użyciu miejsce docelowe zdarzenie synchroniczne licznika bez dodawania narzutów pełnego zdarzeń można uzyskać informacje dotyczące charakterystyki obciążenia kolekcja.Ten obiekt miejsce docelowe nie ma żadnych parametrów można dostosowywać.

Poniższy przykład ilustruje synchroniczne zdarzenie licznik miejsce docelowe format wyjściowy.

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

Tarcza pierścieniowa buforu

Bufor cykliczny miejsce docelowe krótko przechowuje w pamięci dane zdarzenie.miejsce docelowe ten można zarządzać zdarzeń w jednym z dwóch trybów.

  • Pierwszy tryb jest ścisłe first-in first-out (FIFO), gdzie najstarsze zdarzenie jest odrzucany, gdy jest używana cała pamięć przydzielona do miejsce docelowe.W tym trybie (domyślnie) occurrence_number jest opcja zestaw 0.

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

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

Opcja

Dozwolone wartości

Opis

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

Jedna z następujących wartości:

  • 0 (domyślnie) = najstarsze zdarzenie jest odrzucany, gdy jest używana 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.

Tryb FIFO, aby użyć i, jeżeli zestaw na wartość większą niż 0, preferowany liczba zdarzeń każdego typu w buforze.

Poniższy przykład ilustruje ring bufor miejsce docelowe format wyjściowy.

<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>