LoggingEventSource Clase

Definición

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

Herencia

Object

EventSource

LoggingEventSource

Atributos

EventSourceAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar un EventListener para obtener información de 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]);
    }
}

Comentarios

Para activar este registro, habilite EventSource denominado Microsoft-Extensions-Logging.

Cuando habilitó EventSource, eventLevel que estableció se traduce de la manera obvia al nivel asociado a ILogger (por lo tanto, Depurar = detallado, Informational = Informational ... Crítico == Crítico)

Esto permite filtrar por nivel de evento de una manera sencilla.

Para un control más preciso, puede especificar un argumento EventSource denominado FilterSpecs.

El FilterSpecs argumento es una lista separada por punto y coma de especificaciones. Donde cada especificación es

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

Donde Name es el nombre de un ILogger (asunto de mayúsculas y minúsculas), Name puede tener un * que actúa como carácter comodín COMO SUFFIX. Por lo tanto, Net* coincidirá con los registradores que empiecen por "Net".

LEVEL es un número o una cadena LogLevel. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Especifica el nivel del patrón asociado. Si no se especifica el número (el primer formato de la especificación) es el nivel predeterminado para EventSource.

Se usa la primera coincidencia si un nombre determinado coincide con más de un patrón.

Además del argumento level y FilterSpec, también puede establecer EventSource Keywords. Vea la definición de las palabras clave siguiente, pero básicamente puede decidir si quiere tener

• Keywords.Message: obtiene el evento con los datos en formato analizado.
• Keywords.JsonMessage: obtiene un evento con los datos en formato de análisis, pero como un blob JSON (no dividido por argumento ...)
• Keywords.FormattedMessage: obtiene un evento con los datos con formato de cadena.

Se espera que active solo una de estas palabras clave a la vez, pero puede activarlas todas y obtener los mismos datos registrados de tres maneras diferentes.

Propiedades

Métodos

Eventos

Se aplica a