LoggingEventSource Klasse

Definition

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

Vererbung

Object

EventSource

LoggingEventSource

Attribute

EventSourceAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie einen EventListener verwenden, um ILogging-Informationen abzurufen:

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

Hinweise

Sie aktivieren diese Protokollierung, indem Sie die EventSource mit dem Namen Microsoft-Extensions-Loggingaktivieren.

Wenn Sie die EventSource aktiviert haben, wird das von Ihnen festgelegte EventLevel auf offensichtliche Weise auf die Ebene übersetzt, die dem ILogger zugeordnet ist (also Debug = ausführlich, Informational = Informational ... Kritisch == Kritisch)

Dadurch kann direkt nach der Ereignisebene gefiltert werden.

Für eine feinere Steuerung können Sie ein EventSource-Argument namens FilterSpecsangeben.

Das FilterSpecs Argument ist eine durch Semikolon getrennte Liste von Spezifikationen. Dabei gilt für jede Spezifikation Folgendes:

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

Wenn Name der Name eines ILoggers ist (Groß-/Kleinschreibung), kann Name ein * haben, das als Platzhalter als SUFFIX fungiert. Daher stimmt Net* mit allen Protokollierungen überein, die mit dem "Net" beginnen.

„LEVEL“ ist eine Zahl oder eine LogLevel-Zeichenfolge. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Dies gibt die Ebene für das zugeordnete Muster an. Wenn die Zahl nicht angegeben wird (erste Form der Spezifikation), wird die Standardebene für EventSource verwendet.

Wenn ein Name mit mehreren Mustern übereinstimmt, wird die erste Übereinstimmung verwendet.

Zusätzlich zum Argument level und FilterSpec können Sie auch EventSource-Schlüsselwörter festlegen. Informationen hierzu finden Sie in der Definition von Schlüsselwörtern weiter unten. Im Prinzip können Sie jedoch entscheiden, was Sie verwenden möchten:

• Keywords.Message: Sie erhalten das Ereignis mit den Daten in analysierter Form.
• Keywords.JsonMessage: Sie erhalten ein Ereignis mit den Daten in Analyseform, aber als JSON-Blob (nicht nach Argument aufgeschlüsselt ...)
• Keywords.FormattedMessage : Sie erhalten ein Ereignis, bei dem die Daten als Zeichenfolge formatiert sind

Es wird erwartet, dass Sie nur eines dieser Schlüsselwörter gleichzeitig aktivieren, aber Sie können sie alle aktivieren und dieselben Daten auf drei verschiedene Arten protokolliert erhalten.

Eigenschaften

Methoden

Ereignisse

Gilt für: