Dane śledzenia diagnostycznego

Ślady to publikowanie określonych komunikatów generowanych podczas wykonywania aplikacji. Jeśli śledzenie, musi mieć mechanizm do gromadzenia i rejestrowania wiadomości, które mają być wysyłane. Przez odbiorniki odbierania komunikatów śledzenia. Odbiornik ma na celu zbierania, przechowywania i komunikatów śledzenia, które trasy. Odbiorniki bezpośrednie dane wyjściowe śledzenia do odpowiedniego obiektu docelowego, takie jak dziennik, okno lub PLiku tekstowego.

Jedno takie odbiornik DefaultTraceListener, jest automatycznie tworzone i inicjowana, gdy śledzenie jest włączone. Jeśli chcesz, aby dane wyjściowe śledzenia kierować do żadnych dodatkowych źródeł, należy utworzyć i zainicjować odbiorniki śledzenia dodatkowe. Odbiorniki, tworzonych powinny odzwierciedlać Twoich potrzeb. Na przykład może być potrzebny rekord tekstowy wszystkich danych wyjściowych śledzenia. W takim przypadku należy utworzyć odbiornik, który zapisano wszystkie dane wyjściowe w nowy PLik tekstowy, jeśli włączona. Z drugiej strony można wyświetlić dane wyjściowe tylko podczas wykonywania aplikacji. W takim przypadku można utworzyć odbiornik, który przekierowanie wszystkie dane wyjściowe do okna konsoli. EventLogTraceListener Można skierować dane wyjściowe śledzenia do dziennika zdarzeń, a właściwość TextWriterTraceListener może zapisywać dane wyjściowe śledzenia w strumieniu.

Włączenie debugowania

Aby umożliwić śledzenie podczas przetwarzania transakcji, należy edytować plik konfiguracji aplikacji. Poniżej przedstawiono przykład.

<configuration>  
<system.diagnostics>  
     <sources>  
          <source name="System.Transactions" switchValue="Warning">  
               <listeners>  
                    <add name="tx"
                     type="System.Diagnostics.XmlWriterTraceListener"
                     initializeData= "tx.log" />  
               </listeners>  
          </source>  
     </sources>  
</system.diagnostics>  
</configuration>  

System.Transactionszapisy są zapisywane w źródle o nazwie "System.Transactions". Można użyć add określić nazwę i typ odbiornik śledzenia ma być używany. W naszej przykładowej konfiguracji nazwaliśmy odbiornik "tx" i dodaliśmy standardowy odbiornik śledzenia programu .NET Framework (XmlWriterTraceListener) jako typ, którego chcemy użyć. Użyj initializeData do ustawienia dla tego odbiornika nazwa PLiku dziennika. Ponadto możesz zastąpić w pełni kwalifikowaną ścieżkę dla prostej nazwy pliku.

Poszczególne typy komunikatów śledzenia przypisano poziomu, aby wskazać jej stopień ważności. Jeśli poziom śledzenia domeny aPLikacji jest równa lub mniejsza niż poziom typu zdarzenia, generowany jest ten komunikat. Poziom śledzenia jest kontrolowane przez switchValue ustawienia w PLiku konfiguracji. Poziomy, które są skojarzone z komunikatów śledzenia są zdefiniowane w poniższej tabeli.

Poziom śledzenia	opis
Krytyczne	Wystąpiły błędy poważne, podobny do następującego: — Błąd, który może spowodować natychmiastową utratę funkcji użytkownika. — Zdarzenie, które wymaga od administratora podjęcia działań w celu uniknięcia utraty funkcjonalności. - Kod zawiesza się. — Ten poziom śledzenia może również zapewnić wystarczający kontekst do interpretowania innych śladów krytycznych. Może to ułatwić identyfikację sekwencji działań prowadzących do wystąpienia poważnego błędu.
Błąd	Wystąpił błąd (na przykład nieprawidłowa konfiguracja lub zachowanie sieci), który może spowodować utratę funkcjonalności użytkownika.
Ostrzeżenie	Istnieje warunek, który może następnie spowodować błąd lub błąd krytyczny (na przykład niepowodzenie alokacji lub zbliżanie się do limitu). Normalne przetwarzanie błędów z kodu użytkownika (na przykład przerwane transakcje, przekroczenia limitu czasu, uwierzytelnianie nie powiodło się) może również wygenerować ostrzeżenie.
Informacja	Komunikaty przydatne do monitorowania i diagnozowania stanu systemu, pomiaru wydajności lub profilowania są generowane. Może to dotyczyć transakcji i rejestracja zdarzenia okresu istnienia, na przykład tworzenia ani przydzielonej przekroczenia granicę znaczących lub alokacji zasobów znaczących transakcji. Deweloper może następnie wykorzystać takie informacje na potrzeby planowania pojemności i zarządzania wydajnością.

Kody śledzenia

Poniższa tabela zawiera listę kodów śledzenia generowanych przez System.Transactions infrastruktury. W tabeli znajduje się identyfikator kodu śledzenia, EventType poziom wyliczenia dla śledzenia oraz dodatkowe dane zawarte w śledzenia TraceRecord . Ponadto odpowiedni poziom śledzenia śledzenia jest również przechowywany w śledzeniaRekordu.

TraceCode	EventType	Dodatkowe dane w TraceRecord
TransactionCreated	Informacje	TransactionTraceId
TransactionPromoted	Informacje	TransactionTraceId lokalnego, TransactionTraceId rozproszonych
EnlistmentCreated	Informacje	TransactionTraceId, EnlistmentTraceId, EnlistmentType (trwałe/volatile) EnlistmentOptions
EnlistmentCallbackNegative	Ostrzeżenie	TransactionTraceId, EnlistmentTraceId, Wywołanie zwrotne (forcerollback/zostało przerwane/wątPLiwych)
TransactionRollbackCalled	Ostrzeżenie	TransactionTraceId
TransactionAborted	Ostrzeżenie	TransactionTraceId
TransactionInDoubt	Ostrzeżenie	TransactionTraceId
TransactionScopeCreated	Informacje	TransactionScopeResult, które mogą być następujące: - Nowa transakcja. - Przekazano transakcję. - Przekazano transakcję zależną. — Przy użyciu bieżącej transakcji. - Brak transakcji. nowe bieżącego TransactionTraceId
TransactionScopeDisposed	Informacje	TransactionTraceId bieżącej transakcji zakresu "oczekiwano".
TransactionScopeIncomplete	Ostrzeżenie	TransactionTraceId bieżącej transakcji zakresu "oczekiwano".
TransactionScopeNestedIncorrectly	Ostrzeżenie	TransactionTraceId bieżącej transakcji zakresu "oczekiwano".
TransactionScopeCurrentTransactionChanged	Ostrzeżenie	Stary bieżącego TransactionTraceId, innych TransactionTraceId
TransactionScopeTimeout	Ostrzeżenie	TransactionTraceId bieżącej transakcji zakresu "oczekiwano".
DependentCloneCreated	Informacje	TransactionTraceId, typ utworzonej transakcji zależnej (RollbackIfNotComplete/BlockCommitUntilComplete)
DependentCloneComplete	Informacje	TransactionTraceId
RecoveryComplete	Informacje	Identyfikator GUID Menedżera zasobów (z base)
Reenlist	Informacje	Identyfikator GUID Menedżera zasobów (z base)
TransactionSerialized	Informacje	TransactionTraceId.
TransactionException	Błąd	Komunikat wyjątku
InvalidOperationException	Błąd	Komunikat wyjątku
InternalError	Krytyczne	Komunikat wyjątku
TransferEvent		Podczas deserializacji transakcji, lub promowane z System.Transactions transakcja rozproszona jednego, bieżący identyfikator działania w kontekście wykonywania i identyfikator transakcji rozproszonych są zapisywane. USŁUGI ponownie wywołuje kodu zarządzanego, identyfikator transakcja rozproszona jest ustawiana jako identyfikator działania w kontekście wykonywania na czas trwania wywołania zwrotnego.
ConfiguredDefaultTimeoutAdjusted	Ostrzeżenie	Nie dodatkowe dane.
TransactionTimeout	Ostrzeżenie	Upłynął limit czasu TransactionTraceId bycia transakcji.

Schemat XML dla poszczególnych elementów dodatkowe dane ma następujący format.

TransactionTraceIdentifier

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

< CloneIdentifier >

the clone id number

</CloneIdentifier>

</TransactionTraceIdentifier>

EnlistmentTraceIdentifier

<EnlistmentTraceIdentifier>

<ResourceManagerId>

string form of guid

</ResourceManagerId>

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

<CloneIdentifier >

the clone id number

</CloneIdentifier>

<TransactionTraceIdentifier>

<EnlistmentIdentifier>

the enlistment id number

</EnlistmentIdentifier>

</EnlistmentTraceIdentifier>

Identyfikator Menedżera zasobów

<ResourceManagerId>

string form of guid

</ResourceManagerId>

Problemy zabezpieczeń dla śledzenia

Gdy jako administrator włączysz śledzenie, poufne informacje mogą być zapisywane w dzienniku śledzenia, który jest domyślnie przeglądany publicznie. Aby wyeliminować wszelkie możliwe zagrożenia bezpieczeństwa, należy rozważyć zapisanie dziennika śledzenia w bezpiecznej lokalizacji kontrolowanej przez uprawnienia dostępu do udziału i systemu plików.