LoggingEventSource Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Element LoggingEventSource to most ze wszystkich dzienników opartych na protokole ILogger do rejestrowania elementu EventSource/EventListener.
public ref class LoggingEventSource sealed : System::Diagnostics::Tracing::EventSource[System.Diagnostics.Tracing.EventSource(Name="Microsoft-Extensions-Logging")]
public sealed class LoggingEventSource : System.Diagnostics.Tracing.EventSource[<System.Diagnostics.Tracing.EventSource(Name="Microsoft-Extensions-Logging")>]
type LoggingEventSource = class
inherit EventSourcePublic NotInheritable Class LoggingEventSource
Inherits EventSource- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie pokazano, jak uzyskać informacje dotyczące rejestrowania za pomocą elementu EventListener:
class MyEventListener : EventListener
{
protected override void OnEventSourceCreated(EventSource eventSource)
{
if (eventSource.Name == "Microsoft-Extensions-Logging")
{
// initialize a string, string dictionary of arguments to pass to the EventSource.
// Turn on loggers matching App* to Information, everything else (*) is the default level (which is EventLevel.Error)
var args = new Dictionary<string, string>() { { "FilterSpecs", "App*:Information;*" } };
// Set the default level (verbosity) to Error, and only ask for the formatted messages in this case.
EnableEvents(eventSource, EventLevel.Error, LoggingEventSource.Keywords.FormattedMessage, args);
}
}
protected override void OnEventWritten(EventWrittenEventArgs eventData)
{
// Look for the formatted message event, which has the following argument layout (as defined in the LoggingEventSource.
// FormattedMessage(LogLevel Level, int FactoryID, string LoggerName, string EventId, string FormattedMessage);
if (eventData.EventName == "FormattedMessage")
Console.WriteLine("Logger {0}: {1}", eventData.Payload[2], eventData.Payload[4]);
}
}
Uwagi
Włącz to rejestrowanie, włączając usługę EventSource o nazwie Microsoft-Extensions-Logging.
Po włączeniu elementu EventSource zestaw EventLevel jest tłumaczony w oczywisty sposób na poziom skojarzony z ILoggerem (w ten sposób Debuguj = pełne, Informacyjne = Informacyjne ... Krytyczne == Krytyczne)
Dzięki temu można filtrować według poziomu zdarzeń w prosty sposób.
W przypadku bardziej precyzyjnej kontrolki można określić argument źródła zdarzeń o nazwie FilterSpecs.
Argumentem FilterSpecs jest rozdzielona średnikami lista specyfikacji. Gdzie każda specyfikacja jest
SPEC = // empty spec, same as *
| NAME // Just a name the level is the default level
| NAME : LEVEL // specifies level for a particular logger (can have a * suffix).
Gdzie Name jest nazwą ILogger (sprawa ma znaczenie), nazwa może mieć * który działa jako symbol wieloznaczny JAKO SUFIKS. W związku z tym net* będzie pasować do wszystkich rejestratorów, które zaczynają się od "Net".
Poziom jest liczbą lub ciągiem LogLevel. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Określa poziom skojarzonego wzorca. Jeśli liczba nie jest określona, (pierwsza forma specyfikacji) jest to domyślny poziom dla źródła zdarzeń.
Pierwsze dopasowanie jest używane, jeśli określona nazwa pasuje do więcej niż jednego wzorca.
Oprócz poziomu i argumentu FilterSpec można również ustawić słowa kluczowe źródła zdarzeń. Zapoznaj się z poniższą definicją słów kluczowych, ale w zasadzie możesz zdecydować, czy chcesz mieć
- Keywords.Message — zdarzenie jest uzyskiwane z danymi w postaci przeanalizowanej.
- Keywords.JsonMessage — otrzymujesz zdarzenie z danymi w postaci analizy, ale jako obiekt blob JSON (nie podzielone według argumentu ...)
- Keywords.FormattedMessage — zdarzenie z danymi sformatowanymi jako ciąg
Oczekuje się, że naraz włączysz tylko jedno z tych słów kluczowych, ale możesz włączyć je wszystkie i uzyskać te same dane zarejestrowane na trzy różne sposoby.
Właściwości
| ConstructionException |
Pobiera wszelkie wyjątki, które zostały zgłoszony podczas budowy źródła zdarzeń. (Odziedziczone po EventSource) |
| Guid |
Unikatowy identyfikator źródła zdarzeń. (Odziedziczone po EventSource) |
| Name |
Przyjazna nazwa klasy pochodzącej ze źródła zdarzeń. (Odziedziczone po EventSource) |
| Settings |
Pobiera ustawienia zastosowane do tego źródła zdarzeń. (Odziedziczone po EventSource) |
Metody
| Dispose() |
Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy EventSource. (Odziedziczone po EventSource) |
| Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez klasę EventSource i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po EventSource) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetTrait(String) |
Pobiera wartość cech skojarzona z określonym kluczem. (Odziedziczone po EventSource) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| IsEnabled() |
Określa, czy bieżące źródło zdarzeń jest włączone. (Odziedziczone po EventSource) |
| IsEnabled(EventLevel, EventKeywords) |
Określa, czy jest włączone bieżące źródło zdarzeń, które ma określony poziom i słowo kluczowe. (Odziedziczone po EventSource) |
| IsEnabled(EventLevel, EventKeywords, EventChannel) |
Określa, czy bieżące źródło zdarzeń jest włączone dla zdarzeń z określonym poziomem, słowami kluczowymi i kanałem. (Odziedziczone po EventSource) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnEventCommand(EventCommandEventArgs) |
Wywoływana, gdy bieżące źródło zdarzeń jest aktualizowane przez kontroler. (Odziedziczone po EventSource) |
| ToString() |
Uzyskuje reprezentację ciągu bieżącego wystąpienia źródła zdarzeń. (Odziedziczone po EventSource) |
| Write(String) |
Zapisuje zdarzenie bez pól, ale z określoną nazwą i opcjami domyślnymi. (Odziedziczone po EventSource) |
| Write(String, EventSourceOptions) |
Zapisuje zdarzenie bez pól, ale z określoną nazwą i opcjami. (Odziedziczone po EventSource) |
| Write<T>(String, EventSourceOptions, Guid, Guid, T) |
Zapisuje zdarzenie o określonej nazwie, opcjach, powiązanych działaniach i danych zdarzenia. (Odziedziczone po EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Zapisuje zdarzenie o określonej nazwie, danych zdarzenia i opcjach. (Odziedziczone po EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Zapisuje zdarzenie o określonej nazwie, opcjach i danych zdarzenia. (Odziedziczone po EventSource) |
| Write<T>(String, T) |
Zapisuje zdarzenie o określonej nazwie i danych. (Odziedziczone po EventSource) |
| WriteEvent(Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Byte[]) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu tablicy bajtów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i zmiennej liczby elementów pierwotnych źródła zdarzeń. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int32, Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów całkowitych. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int32, Int32, Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów całkowitych. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int32, String) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej i argumentów ciągu. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int64) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int64, Byte[]) |
Zapisuje dane zdarzenia przy użyciu określonego identyfikatora i 64-bitowej liczby całkowitej i argumentów tablicy bajtów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int64, Int64) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int64, Int64, Int64) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Int64, String) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej oraz argumentów ciągu. (Odziedziczone po EventSource) |
| WriteEvent(Int32, Object[]) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i tablicy argumentów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu ciągu. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String, Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String, Int32, Int32) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String, Int64) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String, String) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu. (Odziedziczone po EventSource) |
| WriteEvent(Int32, String, String, String) |
Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu. (Odziedziczone po EventSource) |
| WriteEventCore(Int32, Int32, EventSource+EventData*) |
Tworzy nowe WriteEvent przeciążenie przy użyciu podanego identyfikatora zdarzenia i danych zdarzenia. (Odziedziczone po EventSource) |
| WriteEventWithRelatedActivityId(Int32, Guid, Object[]) |
Zapisuje zdarzenie wskazujące, że bieżące działanie jest związane z innym działaniem. (Odziedziczone po EventSource) |
| WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) |
Zapisuje zdarzenie wskazujące, że bieżące działanie jest związane z innym działaniem. (Odziedziczone po EventSource) |
Zdarzenia
| EventCommandExecuted |
Występuje, gdy polecenie pochodzi z odbiornika zdarzeń. (Odziedziczone po EventSource) |
