Udostępnij za pośrednictwem


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.