LoggingEventSource Classe

Definição

Namespace:

Microsoft.Extensions.Logging.EventSource

Assembly:

Microsoft.Extensions.Logging.EventSource.dll

Pacote:

Microsoft.Extensions.Logging.EventSource v8.0.0

Origem:

LoggingEventSource.cs

O LoggingEventSource é a ponte de todo o ILogger baseado no registro em log para o registro em log EventSource/EventListener.

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

Herança

Object

EventSource

LoggingEventSource

Atributos

EventSourceAttribute

Exemplos

O exemplo a seguir mostra como usar um EventListener para obter informações 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]);
    }
}

Comentários

Ative esse log habilitando o EventSource chamado Microsoft-Extensions-Logging.

Quando você habilitou o EventSource, o EventLevel definido é convertido da maneira óbvia para o nível associado ao ILogger (portanto, Depurar = detalhado, Informativo = Informativo ... Crítico == Crítico)

Isso permite que você filtre por nível de evento de uma maneira simples.

Para um controle mais fino, você pode especificar um Argumento EventSource chamado FilterSpecs.

O FilterSpecs argumento é uma lista separada por ponto e vírgula de especificações. Em que cada especificação é

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

Em que Name é o nome de um ILogger (case matters), Name pode ter um * que atua como um caractere curinga AS A SUFFIX. Portanto, Net* corresponderá a todos os agentes que começam com o 'Net'.

LEVEL é um número ou uma cadeia de caracteres LogLevel. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Isso especifica o nível do padrão associado. Se o número não for especificado, (primeira forma da especificação) será o nível padrão para o EventSource.

A primeira correspondência será usada se um nome específico corresponder a mais de um padrão.

Além do nível e do argumento FilterSpec, você também pode definir palavras-chave EventSource. Confira a definição de Palavras-chave abaixo, mas basicamente você decide se deseja ter

• Keywords.Message - Você obtém o evento com os dados em formato analisado.
• Keywords.JsonMessage – você obtém um evento com os dados em formato de análise, mas como um blob JSON (não dividido por argumento ...)
• Keywords.FormattedMessage – você obtém um evento com os dados formatados como uma cadeia de caracteres

Espera-se que você ative apenas uma dessas palavras-chave por vez, mas você pode ativá-las todas e obter os mesmos dados registrados de três maneiras diferentes.

Propriedades

ConstructionException	Obtém as exceções geradas durante a construção de origem do evento. (Herdado de EventSource)
Guid	O identificador exclusivo da origem do evento. (Herdado de EventSource)
Name	O nome amigável da classe que é derivada da origem do evento. (Herdado de EventSource)
Settings	Obtém as configurações aplicadas a esta origem do evento. (Herdado de EventSource)

Métodos

Dispose()	Libera todos os recursos usados pela instância atual da classe EventSource. (Herdado de EventSource)
Dispose(Boolean)	Libera os recursos não gerenciados usados pela classe EventSource e, opcionalmente, libera os recursos gerenciados. (Herdado de EventSource)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetTrait(String)	Obtém o valor de característica associado à chave especificada. (Herdado de EventSource)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsEnabled()	Determina se a origem do evento atual está habilitada. (Herdado de EventSource)
IsEnabled(EventLevel, EventKeywords)	Determina se a origem do evento atual que tem o nível e a palavra-chave especificados está habilitada. (Herdado de EventSource)
IsEnabled(EventLevel, EventKeywords, EventChannel)	Determina se a origem do evento atual é habilitada para eventos com o nível, palavras-chave e canais específicos. (Herdado de EventSource)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnEventCommand(EventCommandEventArgs)	Chamado quando a origem do evento atual é atualizada pelo controlador. (Herdado de EventSource)
ToString()	Obtém uma representação de cadeia de caracteres da instância da origem do evento atual. (Herdado de EventSource)
Write(String)	Grava um evento sem campos, mas com o nome e as opções padrão especificados. (Herdado de EventSource)
Write(String, EventSourceOptions)	Grava um evento sem campos, mas com o nome e as opções especificadas. (Herdado de EventSource)
Write<T>(String, EventSourceOptions, Guid, Guid, T)	Grava um evento com o nome, opções, dados de atividade e de evento relacionados especificados. (Herdado de EventSource)
Write<T>(String, EventSourceOptions, T)	Grava um evento com o nome, dados de evento e opções especificados. (Herdado de EventSource)
Write<T>(String, EventSourceOptions, T)	Grava um evento com o nome, opções e dados de evento especificados. (Herdado de EventSource)
Write<T>(String, T)	Grava um evento com o nome e os dados especificados. (Herdado de EventSource)
WriteEvent(Int32)	Grava um evento usando o identificador de evento fornecido. (Herdado de EventSource)
WriteEvent(Int32, Byte[])	Grava um evento usando o identificador de evento e o argumento de matriz de bytes fornecidos. (Herdado de EventSource)
WriteEvent(Int32, EventSource+EventSourcePrimitive[])	Grava um evento usando o identificador de evento fornecido e um número variável de primitivos de origem do evento. (Herdado de EventSource)
WriteEvent(Int32, Int32)	Grava um evento usando o identificador de evento e o argumento inteiro de 32 bits fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Int32, Int32)	Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Int32, Int32, Int32)	Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Int32, String)	Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 32 bits e cadeia de caracteres fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Int64)	Grava um evento usando o identificador de evento e o argumento inteiro de 64 bits fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Int64, Byte[])	Grava os dados de evento usando o identificador especificado e inteiro de 64 bits e argumentos da matriz de bytes. (Herdado de EventSource)
WriteEvent(Int32, Int64, Int64)	Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits. (Herdado de EventSource)
WriteEvent(Int32, Int64, Int64, Int64)	Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits. (Herdado de EventSource)
WriteEvent(Int32, Int64, String)	Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 64 bits e cadeia de caracteres fornecidos. (Herdado de EventSource)
WriteEvent(Int32, Object[])	Grava um evento usando o identificador de evento fornecido e a matriz de argumentos. (Herdado de EventSource)
WriteEvent(Int32, String)	Grava um evento usando o identificador de evento e o argumentos de cadeia de caractere fornecidos. (Herdado de EventSource)
WriteEvent(Int32, String, Int32)	Grava um evento usando o identificador de evento fornecido e os argumentos. (Herdado de EventSource)
WriteEvent(Int32, String, Int32, Int32)	Grava um evento usando o identificador de evento fornecido e os argumentos. (Herdado de EventSource)
WriteEvent(Int32, String, Int64)	Grava um evento usando o identificador de evento fornecido e os argumentos. (Herdado de EventSource)
WriteEvent(Int32, String, String)	Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos. (Herdado de EventSource)
WriteEvent(Int32, String, String, String)	Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos. (Herdado de EventSource)
WriteEventCore(Int32, Int32, EventSource+EventData*)	Cria uma nova sobrecarga WriteEvent usando o identificador de evento fornecidos e os dados de evento. (Herdado de EventSource)
WriteEventWithRelatedActivityId(Int32, Guid, Object[])	Grava um evento que indica que a atividade atual está relacionada a outra atividade. (Herdado de EventSource)
WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*)	Grava um evento que indica que a atividade atual está relacionada a outra atividade. (Herdado de EventSource)

Eventos

EventCommandExecuted

Ocorre quando um comando é proveniente de um ouvinte de evento. (Herdado de EventSource)