LoggingEventSource Třída

Definice

Obor názvů:

Microsoft.Extensions.Logging.EventSource

Sestavení:

Microsoft.Extensions.Logging.EventSource.dll

Balíček:

Microsoft.Extensions.Logging.EventSource v8.0.0

Zdroj:

LoggingEventSource.cs

LoggingEventSource je most ze všech protokolování založených na ILoggeru na protokolování 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 EventSource

Public NotInheritable Class LoggingEventSource
Inherits EventSource

Dědičnost

Object

EventSource

LoggingEventSource

Atributy

EventSourceAttribute

Příklady

Následující příklad ukazuje, jak použít EventListener k získání informací o ILogging:

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]);
    }
}

Poznámky

Toto protokolování zapnete tak, že povolíte EventSource s názvem Microsoft-Extensions-Logging.

Když jste povolili EventSource, nastavená úroveň události se přeloží zřejmým způsobem na úroveň přidruženou k ILoggeru (tedy Debug = verbose, Informational = Informational ... Kritické == Kritické)

To vám umožní jednoduše filtrovat podle úrovně událostí.

Pro jemnější kontrolu můžete zadat argument EventSource s názvem FilterSpecs.

Argument FilterSpecs je seznam specifikací oddělený středníkem. Kde je každá specifikace

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

Kde Název je název ILoggeru (záleží na malých a malých a malých písmenech), název může mít znak *, který funguje jako zástupný znak JAKO PŘÍPONA. Hodnota Net* se tedy bude shodovat se všemi protokolovacími nástroji, které začínají na "Net".

Level je číslo nebo řetězec LogLevel. 0= trasování, 1 = ladění, 2 = informace, 3 = upozornění, 4 = chyba, kritické = 5 Určuje úroveň přidruženého vzoru. Pokud není zadané číslo (první forma specifikace), jedná se o výchozí úroveň pro EventSource.

První shoda se použije, pokud konkrétní název odpovídá více než jednomu vzoru.

Kromě level a argumentu FilterSpec můžete nastavit také klíčová slova EventSource. Podívejte se na definici klíčových slov níže, ale v podstatě se můžete rozhodnout, jestli chcete

• Keywords.Message – událost získáte s daty v analyzované podobě.
• Keywords.JsonMessage – získáte událost s daty ve formě parse, ale jako objekt blob JSON (nerozdělí se podle argumentu ...).
• Keywords.FormattedMessage – získáte událost s daty formátovanými jako řetězec.

Očekává se, že najednou zapnete jenom jedno z těchto klíčových slov, ale můžete je zapnout všechna a získat stejná data zaprotokolovaná třemi různými způsoby.

Vlastnosti

ConstructionException	Získá jakoukoli výjimku, která byla vyvolán během vytváření zdroje událostí. (Zděděno od EventSource)
Guid	Jedinečný identifikátor zdroje událostí. (Zděděno od EventSource)
Name	Popisný název třídy, která je odvozena ze zdroje událostí. (Zděděno od EventSource)
Settings	Získá nastavení použité pro tento zdroj událostí. (Zděděno od EventSource)

Metody

Dispose()	Uvolní všechny prostředky používané aktuální instancí EventSource třídy . (Zděděno od EventSource)
Dispose(Boolean)	Uvolní nespravované prostředky používané EventSource třídou a volitelně uvolní spravované prostředky. (Zděděno od EventSource)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetTrait(String)	Získá hodnotu vlastnosti přidružené k zadanému klíči. (Zděděno od EventSource)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsEnabled()	Určuje, zda je povolen aktuální zdroj událostí. (Zděděno od EventSource)
IsEnabled(EventLevel, EventKeywords)	Určuje, zda je povolen aktuální zdroj událostí, který má zadanou úroveň a klíčové slovo. (Zděděno od EventSource)
IsEnabled(EventLevel, EventKeywords, EventChannel)	Určuje, jestli je aktuální zdroj událostí povolený pro události se zadanou úrovní, klíčovými slovy a kanálem. (Zděděno od EventSource)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnEventCommand(EventCommandEventArgs)	Volá se při aktualizaci aktuálního zdroje událostí kontrolerem. (Zděděno od EventSource)
ToString()	Získá řetězcovou reprezentaci aktuální instance zdroje událostí. (Zděděno od EventSource)
Write(String)	Zapíše událost bez polí, ale se zadaným názvem a výchozími možnostmi. (Zděděno od EventSource)
Write(String, EventSourceOptions)	Zapíše událost bez polí, ale se zadaným názvem a možnostmi. (Zděděno od EventSource)
Write<T>(String, EventSourceOptions, Guid, Guid, T)	Zapíše událost se zadaným názvem, možnostmi, související aktivitou a daty události. (Zděděno od EventSource)
Write<T>(String, EventSourceOptions, T)	Zapíše událost se zadaným názvem, daty události a možnostmi. (Zděděno od EventSource)
Write<T>(String, EventSourceOptions, T)	Zapíše událost se zadaným názvem, možnostmi a daty události. (Zděděno od EventSource)
Write<T>(String, T)	Zapíše událost se zadaným názvem a daty. (Zděděno od EventSource)
WriteEvent(Int32)	Zapíše událost pomocí zadaného identifikátoru události. (Zděděno od EventSource)
WriteEvent(Int32, Byte[])	Zapíše událost pomocí zadaného identifikátoru události a argumentu pole bajtů. (Zděděno od EventSource)
WriteEvent(Int32, EventSource+EventSourcePrimitive[])	Zapíše událost pomocí zadaného identifikátoru události a proměnné počtu primitiv zdroje událostí. (Zděděno od EventSource)
WriteEvent(Int32, Int32)	Zapíše událost pomocí zadaného identifikátoru události a 32bitového celočíselného argumentu. (Zděděno od EventSource)
WriteEvent(Int32, Int32, Int32)	Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Int32, Int32, Int32)	Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Int32, String)	Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných a řetězcových argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Int64)	Zapíše událost pomocí zadaného identifikátoru události a 64bitového celočíselného argumentu. (Zděděno od EventSource)
WriteEvent(Int32, Int64, Byte[])	Zapíše data události pomocí zadaného identifikátoru a argumentů 64bitového celočíselného a bajtového pole. (Zděděno od EventSource)
WriteEvent(Int32, Int64, Int64)	Zapíše událost pomocí zadaného identifikátoru události a 64bitových argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Int64, Int64, Int64)	Zapíše událost pomocí zadaného identifikátoru události a 64bitových argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Int64, String)	Zapíše událost pomocí zadaného identifikátoru události, 64bitového celého čísla a řetězcových argumentů. (Zděděno od EventSource)
WriteEvent(Int32, Object[])	Zapíše událost pomocí zadaného identifikátoru události a pole argumentů. (Zděděno od EventSource)
WriteEvent(Int32, String)	Zapíše událost pomocí zadaného identifikátoru události a argumentu řetězce. (Zděděno od EventSource)
WriteEvent(Int32, String, Int32)	Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource)
WriteEvent(Int32, String, Int32, Int32)	Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource)
WriteEvent(Int32, String, Int64)	Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource)
WriteEvent(Int32, String, String)	Zapíše událost pomocí zadaného identifikátoru události a řetězcových argumentů. (Zděděno od EventSource)
WriteEvent(Int32, String, String, String)	Zapíše událost pomocí zadaného identifikátoru události a řetězcových argumentů. (Zděděno od EventSource)
WriteEventCore(Int32, Int32, EventSource+EventData*)	Vytvoří nové WriteEvent přetížení pomocí zadaného identifikátoru události a dat události. (Zděděno od EventSource)
WriteEventWithRelatedActivityId(Int32, Guid, Object[])	Zapíše událost, která označuje, že aktuální aktivita souvisí s jinou aktivitou. (Zděděno od EventSource)
WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*)	Zapíše událost, která označuje, že aktuální aktivita souvisí s jinou aktivitou. (Zděděno od EventSource)

Událost

EventCommandExecuted

Vyvolá se, když příkaz pochází z naslouchacího procesu událostí. (Zděděno od EventSource)