LoggingEventSource Třída

Definice

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

Metody

Událost

Platí pro