LoggingEventSource Classe

Definição

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

Métodos

Eventos

Aplica-se a