LoggingEventSource Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
LoggingEventSource es el puente al registro de EventSource/EventListener de todos los registros basados en ILogger.
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 EventSourcePublic NotInheritable Class LoggingEventSource
Inherits EventSource- Herencia
- Atributos
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
| ConstructionException |
Obtiene cualquier excepción que se produjo durante la construcción de un origen de eventos. (Heredado de EventSource) |
| Guid |
Identificador único para el origen de eventos. (Heredado de EventSource) |
| Name |
Nombre descriptivo de la clase que se deriva del origen de eventos. (Heredado de EventSource) |
| Settings |
Obtiene la configuración aplicada a este origen del evento. (Heredado de EventSource) |
Métodos
| Dispose() |
Libera todos los recursos usados por la instancia actual de la clase EventSource. (Heredado de EventSource) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por la clase EventSource y, de forma opcional, libera los recursos administrados. (Heredado de EventSource) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetTrait(String) |
Obtiene el valor de rasgo asociado a la clave especificada. (Heredado de EventSource) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| IsEnabled() |
Determina si el origen de eventos actual está habilitado. (Heredado de EventSource) |
| IsEnabled(EventLevel, EventKeywords) |
Determina si el origen de eventos actual que tiene el nivel y la palabra clave especificados está habilitado. (Heredado de EventSource) |
| IsEnabled(EventLevel, EventKeywords, EventChannel) |
Determina si el origen del evento actual está habilitado para eventos con el nivel, las palabras clave y el canal especificados. (Heredado de EventSource) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnEventCommand(EventCommandEventArgs) |
Se llama cuando el origen de eventos actual es actualizado por el controlador. (Heredado de EventSource) |
| ToString() |
Obtiene una representación de cadena de la instancia del origen de eventos actual. (Heredado de EventSource) |
| Write(String) |
Escribe un evento sin campos, pero con el nombre especificado y las opciones predeterminadas. (Heredado de EventSource) |
| Write(String, EventSourceOptions) |
Escribe un evento sin campos, pero con el nombre y las opciones especificados. (Heredado de EventSource) |
| Write<T>(String, EventSourceOptions, Guid, Guid, T) |
Escribe un evento con el nombre, las opciones, la actividad relacionada y los datos de evento especificados. (Heredado de EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Escribe un evento con el nombre, los datos de evento y las opciones especificados. (Heredado de EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Escribe un evento con el nombre, las opciones y los datos de evento especificados. (Heredado de EventSource) |
| Write<T>(String, T) |
Escribe un evento con el nombre y los datos especificados. (Heredado de EventSource) |
| WriteEvent(Int32) |
Escribe un evento con el identificador de eventos proporcionado. (Heredado de EventSource) |
| WriteEvent(Int32, Byte[]) |
Escribe un evento con el identificador de eventos y el argumento de matriz de bytes especificados. (Heredado de EventSource) |
| WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Escribe un evento mediante el identificador de evento proporcionado y un número variable de primitivos de origen de eventos. (Heredado de EventSource) |
| WriteEvent(Int32, Int32) |
Escribe un evento con el identificador de eventos y el argumento entero de 32 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int32, Int32) |
Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int32, Int32, Int32) |
Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int32, String) |
Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 32 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int64) |
Escribe un evento con el identificador de eventos y el argumento entero de 64 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int64, Byte[]) |
Escribe los datos del evento con el identificador y los argumentos de matriz de bytes y enteros de 64 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int64, Int64) |
Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int64, Int64, Int64) |
Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Int64, String) |
Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 64 bits especificados. (Heredado de EventSource) |
| WriteEvent(Int32, Object[]) |
Escribe un evento con el identificador de eventos y la matriz de argumentos especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String) |
Escribe un evento con el identificador de eventos y el argumento de cadena especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String, Int32) |
Escribe un evento con el identificador de eventos y los argumentos especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String, Int32, Int32) |
Escribe un evento con el identificador de eventos y los argumentos especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String, Int64) |
Escribe un evento con el identificador de eventos y los argumentos especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String, String) |
Escribe un evento con el identificador de eventos y los argumentos de cadena especificados. (Heredado de EventSource) |
| WriteEvent(Int32, String, String, String) |
Escribe un evento con el identificador de eventos y los argumentos de cadena especificados. (Heredado de EventSource) |
| WriteEventCore(Int32, Int32, EventSource+EventData*) |
Crea una nueva sobrecarga de WriteEvent usando el identificador de eventos y los datos de eventos proporcionados. (Heredado de EventSource) |
| WriteEventWithRelatedActivityId(Int32, Guid, Object[]) |
Escribe un evento que indica que la actividad actual se relaciona con otra actividad. (Heredado de EventSource) |
| WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) |
Escribe un evento que indica que la actividad actual se relaciona con otra actividad. (Heredado de EventSource) |
Eventos
| EventCommandExecuted |
Se produce cuando un comando proviene de un agente de escucha de eventos. (Heredado de EventSource) |
