LoggingEventSource Classe

Définition

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

Héritage

Object

EventSource

LoggingEventSource

Attributs

EventSourceAttribute

Exemples

L’exemple suivant montre comment utiliser un EventListener pour obtenir des informations 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]);
    }
}

Remarques

Vous activez cette journalisation en activant eventSource appelé Microsoft-Extensions-Logging.

Lorsque vous avez activé EventSource, l’EventLevel que vous définissez est traduit de la manière évidente au niveau associé à ILogger (par conséquent, Debug = verbose, Informational = Informational ... Critique == Critique)

Cela vous permet de filtrer par niveau d’événement de manière simple.

Pour un contrôle plus fin, vous pouvez spécifier un argument EventSource appelé FilterSpecs.

L’argument FilterSpecs est une liste de spécifications séparée par des points-virgules. Où chaque spécification affiche

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

Où Name est le nom d’un ILogger (la casse est importante), Name peut avoir un * qui agit comme un caractère générique en tant que SUFFIXE. Par conséquent, Net* correspond à tous les enregistreurs d’événements qui commencent par le « Net ».

LEVEL est un nombre ou une chaîne LogLevel. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Cela spécifie le niveau pour le modèle associé. Si le numéro n’est pas spécifié (première forme de la spécification), il s’agit du niveau par défaut pour l’EventSource.

La première correspondance est utilisée si un nom particulier correspond à plusieurs modèles.

En plus de l’argument level et FilterSpec, vous pouvez également définir des mots clés EventSource. Consultez la définition des mots clés ci-dessous, mais vous devez simplement décider si vous préférez

• Keywords.Message : vous obtenez l’événement avec les données sous forme analysée.
• Keywords.JsonMessage : vous obtenez un événement avec les données sous forme d’analyse, mais en tant qu’objet blob JSON (non divisé par argument ...)
• Keywords.FormattedMessage : vous obtenez un événement avec les données mises en forme sous forme de chaîne

Il est prévu que vous n’activez qu’un seul de ces mots clés à la fois, mais vous pouvez tous les activer et obtenir les mêmes données enregistrées de trois façons différentes.

Propriétés

Méthodes

Événements

S’applique à