LoggingEventSource Class

Definition

LoggingEventSource stellt die Verbindung zwischen allen auf ILogger basierenden Protokollen und der Protokollierung von EventSource/EventListener dar.The LoggingEventSource is the bridge from all ILogger based logging to EventSource/EventListener logging.

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
type LoggingEventSource = class
    inherit EventSource
Public NotInheritable Class LoggingEventSource
Inherits EventSource
Inheritance
LoggingEventSource
Attributes

Examples

Im folgenden Beispiel wird gezeigt, wie Sie einen EventListener verwenden, um ilogging-Informationen zu erhalten:The following example shows how to use an EventListener to get ILogging information:

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

Remarks

Sie aktivieren diese Protokollierung, indem Sie eventSource mit dem Namen Microsoft-Extensions-Loggingaktivieren.You turn this logging on by enabling the EventSource called Microsoft-Extensions-Logging.

Wenn Sie eventSource aktiviert haben, wird die von Ihnen festgelegte Eventlevel-Methode auf offensichtliche Weise in die Ebene übersetzt, die der ILogger zugeordnet ist (d. h. Debug = Verbose, Information = Information... Kritisch = = kritisch)When you enabled the EventSource, the EventLevel you set is translated in the obvious way to the level associated with the ILogger (thus Debug = verbose, Informational = Informational ... Critical == Critical)

Dadurch kann direkt nach der Ereignisebene gefiltert werden.This allows you to filter by event level in a straightforward way.

Für ein feineres Steuerelement können Sie ein eventSource-Argument namens FilterSpecsangeben.For finer control you can specify a EventSource Argument called FilterSpecs.

Das FilterSpecs-Argument ist eine durch Semikolons getrennte Liste von Spezifikationen.The FilterSpecs argument is a semicolon separated list of specifications. Dabei gilt für jede Spezifikation Folgendes:Where each specification is

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

Dabei ist Name der Name eines iloggger (falls es sich um einen Fall handelt), der Name kann eine *, die als Platzhalter als Suffix fungiert.Where Name is the name of a ILoggger (case matters), Name can have a * which acts as a wildcard AS A SUFFIX. Folglich entspricht net* allen Protokollierungen, die mit "NET" beginnen.Thus, Net* will match any loggers that start with the 'Net'.

„LEVEL“ ist eine Zahl oder eine LogLevel-Zeichenfolge.The LEVEL is a number or a LogLevel string. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Damit wird die Ebene für das entsprechende Muster angegeben.0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 This specifies the level for the associated pattern. Wenn die Zahl nicht angegeben wird (erste Form der Spezifikation), wird die Standardebene für EventSource verwendet.If the number is not specified, (first form of the specification) it is the default level for the EventSource.

Wenn ein Name mit mehreren Mustern übereinstimmt, wird die erste Übereinstimmung verwendet.First match is used if a particular name matches more than one pattern.

Zusätzlich zum Level-und FILTERSPEC-Argument können Sie auch eventSource-Schlüsselwörter festlegen.In addition to the level and FilterSpec argument, you can also set EventSource Keywords. 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:See the Keywords definition below, but basically you get to decide if you wish to have

  • Keywords. Message: Sie erhalten das Ereignis mit den Daten in der analysierten Form.Keywords.Message - You get the event with the data in parsed form.
  • Keywords. jsonmessage: Sie erhalten ein Ereignis mit den Daten im Analyse Formular, aber als JSON-BLOB (nicht durch Argument aufgeschlüsselt).Keywords.JsonMessage - you get an event with the data in parse form but as a JSON blob (not broken up by argument ...)
  • Keywords. formattedmessage: Sie erhalten ein Ereignis, bei dem die Daten als Zeichenfolge formatiert sind.Keywords.FormattedMessage - you get an event with the data formatted as a string

Es wird erwartet, dass Sie nur eines dieser Schlüsselwörter gleichzeitig aktivieren, aber Sie können Sie alle aktivieren und die gleichen Daten auf drei verschiedene Arten protokollieren.It is expected that you will turn only one of these keywords on at a time, but you can turn them all on and get the same data logged three different ways.

Properties

ConstructionException

Ruft alle Ausnahmen, die während der Konstruktion einer Ereignisquelle ausgelöst wurden.Gets any exception that was thrown during the construction of the event source.

(Inherited from EventSource)
Guid

Der eindeutige Bezeichner für die Ereignisquelle.The unique identifier for the event source.

(Inherited from EventSource)
Name

Der Anzeigename der Klasse, die von der Ereignisquelle abgeleitet ist.The friendly name of the class that is derived from the event source.

(Inherited from EventSource)
Settings

Ruft die Einstellungen ab, die für diese Ereignisquelle verwendet wurden.Gets the settings applied to this event source.

(Inherited from EventSource)

Methods

Dispose()

Gibt alle von der aktuellen Instanz der EventSource-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the EventSource class.

(Inherited from EventSource)
Dispose(Boolean)

Gibt die von der EventSource-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei.Releases the unmanaged resources used by the EventSource class and optionally releases the managed resources.

(Inherited from EventSource)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetTrait(String)

Ruft den dem angegebenen Schlüssel zugeordneten Merkmalwert ab.Gets the trait value associated with the specified key.

(Inherited from EventSource)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsEnabled()

Bestimmt, ob die aktuelle Ereignisquelle aktiviert ist.Determines whether the current event source is enabled.

(Inherited from EventSource)
IsEnabled(EventLevel, EventKeywords)

Bestimmt, ob die aktuelle Ereignisquelle, die die angegebene Ebene und das Schlüsselwort enthält, aktiviert ist.Determines whether the current event source that has the specified level and keyword is enabled.

(Inherited from EventSource)
IsEnabled(EventLevel, EventKeywords, EventChannel)

Bestimmt, ob die aktuelle Ereignisquelle für Ereignisse mit der angegebenen Ebene, Schlüsselwort und Kanal aktiviert ist.Determines whether the current event source is enabled for events with the specified level, keywords and channel.

(Inherited from EventSource)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnEventCommand(EventCommandEventArgs)

Wird aufgerufen, wenn die aktuelle Ereignisquelle vom Controller aktualisiert wird.Called when the current event source is updated by the controller.

(Inherited from EventSource)
ToString()

Ruft eine Zeichenfolgendarstellung der aktuellen Ereignisquellinstanz ab.Obtains a string representation of the current event source instance.

(Inherited from EventSource)
Write(String)

Schreibt ein Ereignis ohne Felder, jedoch mit dem angegebenen Namen und den Standardoptionen.Writes an event without fields, but with the specified name and default options.

(Inherited from EventSource)
Write(String, EventSourceOptions)

Schreibt ein Ereignis ohne Felder, jedoch mit dem angegebenen Namen und den angegebenen Optionen.Writes an event without fields, but with the specified name and options.

(Inherited from EventSource)
Write<T>(String, EventSourceOptions, Guid, Guid, T)

Schreibt ein Ereignis mit dem angegebenen Namen, verwandten Aktivitäten und den angegebenen Optionen und Ereignisdaten.Writes an event with the specified name, options, related activity and event data.

(Inherited from EventSource)
Write<T>(String, EventSourceOptions, T)

Schreibt ein Ereignis mit dem angegebenen Namen und den angegebenen Daten und Optionen.Writes an event with the specified name, event data and options.

(Inherited from EventSource)
Write<T>(String, EventSourceOptions, T)

Schreibt ein Ereignis mit dem angegebenen Namen und den angegebenen Optionen und Ereignisdaten.Writes an event with the specified name, options and event data.

(Inherited from EventSource)
Write<T>(String, T)

Schreibt ein Ereignis mit dem angegebenen Namen und den angegebenen Daten.Writes an event with the specified name and data.

(Inherited from EventSource)
WriteEvent(Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichner.Writes an event by using the provided event identifier.

(Inherited from EventSource)
WriteEvent(Int32, Byte[])

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Bytearray-Arguments.Writes an event by using the provided event identifier and byte array argument.

(Inherited from EventSource)
WriteEvent(Int32, Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 32-Bit-Ganzzahl-Arguments.Writes an event by using the provided event identifier and 32-bit integer argument.

(Inherited from EventSource)
WriteEvent(Int32, Int32, Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 32-Bit-Ganzzahl-Argumente.Writes an event by using the provided event identifier and 32-bit integer arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int32, Int32, Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 32-Bit-Ganzzahl-Argumente.Writes an event by using the provided event identifier and 32-bit integer arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int32, String)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und den 32-Bit-Ganzzahl- und Zeichenfolgenargumenten.Writes an event by using the provided event identifier and 32-bit integer and string arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int64)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 64-Bit-Ganzzahl-Arguments.Writes an event by using the provided event identifier and 64-bit integer argument.

(Inherited from EventSource)
WriteEvent(Int32, Int64, Byte[])

Schreibt die Ereignisdaten mithilfe des bereitgestellten Bezeichners und den 64-Bit-Ganzzahl- und Bytearray-Argumenten.Writes the event data using the specified identifier and 64-bit integer and byte array arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int64, Int64)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 64-Bit-Argumente.Writes an event by using the provided event identifier and 64-bit arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int64, Int64, Int64)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und 64-Bit-Argumente.Writes an event by using the provided event identifier and 64-bit arguments.

(Inherited from EventSource)
WriteEvent(Int32, Int64, String)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und den 64-Bit-Ganzzahl- und Zeichenfolgenargumenten.Writes an event by using the provided event identifier and 64-bit integer, and string arguments.

(Inherited from EventSource)
WriteEvent(Int32, Object[])

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Argumentarrays.Writes an event by using the provided event identifier and array of arguments.

(Inherited from EventSource)
WriteEvent(Int32, String)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Zeichenfolgenargument.Writes an event by using the provided event identifier and string argument.

(Inherited from EventSource)
WriteEvent(Int32, String, Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Argumente.Writes an event by using the provided event identifier and arguments.

(Inherited from EventSource)
WriteEvent(Int32, String, Int32, Int32)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Argumente.Writes an event by using the provided event identifier and arguments.

(Inherited from EventSource)
WriteEvent(Int32, String, Int64)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Argumente.Writes an event by using the provided event identifier and arguments.

(Inherited from EventSource)
WriteEvent(Int32, String, String)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Zeichenfolgenargumente.Writes an event by using the provided event identifier and string arguments.

(Inherited from EventSource)
WriteEvent(Int32, String, String, String)

Schreibt ein Ereignis mithilfe des bereitgestellten Ereignisbezeichners und Zeichenfolgenargumente.Writes an event by using the provided event identifier and string arguments.

(Inherited from EventSource)
WriteEventCore(Int32, Int32, EventSource+EventData*)

Erstellt eine neue WriteEvent-Überladung mithilfe des bereitgestellten Ereignisbezeichners und den Ereignisdaten.Creates a new WriteEvent overload by using the provided event identifier and event data.

(Inherited from EventSource)
WriteEventWithRelatedActivityId(Int32, Guid, Object[])

Schreibt ein Ereignis, die angibt, dass die aktuelle Aktivität mit einer andere Aktivität in Beziehung steht.Writes an event that indicates that the current activity is related to another activity.

(Inherited from EventSource)
WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*)

Schreibt ein Ereignis, die angibt, dass die aktuelle Aktivität mit einer andere Aktivität in Beziehung steht.Writes an event that indicates that the current activity is related to another activity.

(Inherited from EventSource)

Events

EventCommandExecuted

Tritt auf, wenn ein Befehl von einem Ereignislistener stammt.Occurs when a command comes from an event listener.

(Inherited from EventSource)

Applies to