LoggingEventSource Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
LoggingEventSource est le pont reliant l’ensemble de la journalisation ILogger à la journalisation 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 EventSourcePublic NotInheritable Class LoggingEventSource
Inherits EventSource- Héritage
- Attributs
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
| ConstructionException |
Obtient les exceptions levées lors de la construction de la source d'événements. (Hérité de EventSource) |
| Guid |
Identificateur unique de la source d'événement. (Hérité de EventSource) |
| Name |
Nom convivial de la classe dérivé de la source d'événements. (Hérité de EventSource) |
| Settings |
Obtient les paramètres appliqués à cette source d'événements. (Hérité de EventSource) |
Méthodes
| Dispose() |
Libère toutes les ressources utilisées par l'instance actuelle de la classe EventSource. (Hérité de EventSource) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par la classe EventSource et libère éventuellement les ressources managées. (Hérité de EventSource) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetTrait(String) |
Obtient la valeur de la caractéristique associée à la clé spécifiée. (Hérité de EventSource) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| IsEnabled() |
Détermine si la source d'événements actuelle est activée. (Hérité de EventSource) |
| IsEnabled(EventLevel, EventKeywords) |
Détermine si la source d'événements actuelle qui a le niveau et le mot clé spécifiés est activée. (Hérité de EventSource) |
| IsEnabled(EventLevel, EventKeywords, EventChannel) |
Détermine si la source d'événements actuelle est activée pour les événements avec le niveau, les mots clés et le canal spécifiés. (Hérité de EventSource) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnEventCommand(EventCommandEventArgs) |
Appelée lorsque la source d'événements actuelle est mise à jour par le contrôleur. (Hérité de EventSource) |
| ToString() |
Obtient une représentation sous forme de chaîne de l'instance de source d'événements actuelle. (Hérité de EventSource) |
| Write(String) |
Écrit un événement sans champ, mais avec le nom spécifié et les options par défaut. (Hérité de EventSource) |
| Write(String, EventSourceOptions) |
Écrit un événement sans champ, mais avec le nom et les options spécifiés. (Hérité de EventSource) |
| Write<T>(String, EventSourceOptions, Guid, Guid, T) |
Écrit un événement avec le nom, les options, l'activité associée et les données d'événements spécifiés. (Hérité de EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Écrit un événement avec le nom, les données d'événements et les options spécifiés. (Hérité de EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Écrit un événement avec le nom, les données d'événements et les options spécifiés. (Hérité de EventSource) |
| Write<T>(String, T) |
Écrit un événement avec le nom et les données spécifiés. (Hérité de EventSource) |
| WriteEvent(Int32) |
Écrit un événement à l'aide de l'identificateur d'événement fourni. (Hérité de EventSource) |
| WriteEvent(Int32, Byte[]) |
Écrit un événement à l'aide de l'identificateur d'événement et de l'argument de tableau d'octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Écrit un événement à l’aide de l’identificateur d’événement fourni et d’un nombre variable de primitives sources d’événements. (Hérité de EventSource) |
| WriteEvent(Int32, Int32) |
Écrit un événement à l’aide de l’identificateur d’événement et de l’argument en entier d’une valeur de 32 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int32, Int32) |
Écrit un événement à l’aide de l’identificateur d’événement et des arguments en entier d’une valeur de 32 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int32, Int32, Int32) |
Écrit un événement à l’aide de l’identificateur d’événement et des arguments en entier d’une valeur de 32 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int32, String) |
Écrit un événement à l'aide de l'identificateur d'événement et des arguments de chaînes et d'entiers 32 bits fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int64) |
Écrit un événement à l'aide de l'identificateur d'événement et de l'argument en entier d'une valeur de 64 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int64, Byte[]) |
Écrit les données d’événements à l’aide de l’identificateur et des arguments de tableau de chaînes et d’entiers 64 bits spécifiés. (Hérité de EventSource) |
| WriteEvent(Int32, Int64, Int64) |
Écrit un événement à l'aide de l'identificateur d'événement et des arguments d'une valeur de 64 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int64, Int64, Int64) |
Écrit un événement à l'aide de l'identificateur d'événement et des arguments d'une valeur de 64 octets fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Int64, String) |
Écrit un événement à l’aide de l’identificateur d’événement et des arguments de chaînes et d’entiers 64 bits fournis. (Hérité de EventSource) |
| WriteEvent(Int32, Object[]) |
Écrit un événement à l’aide de l’identificateur d’événement et du tableau d’arguments fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String) |
Écrit un événement à l'aide de l'identificateur d'événement et de l'argument de chaîne fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String, Int32) |
Écrit un événement à l’aide de l’identificateur d’événement et d’arguments fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String, Int32, Int32) |
Écrit un événement à l’aide de l’identificateur d’événement et d’arguments fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String, Int64) |
Écrit un événement à l’aide de l’identificateur d’événement et d’arguments fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String, String) |
Écrit un événement à l’aide de l’identificateur d’événement et des arguments de chaîne fournis. (Hérité de EventSource) |
| WriteEvent(Int32, String, String, String) |
Écrit un événement à l’aide de l’identificateur d’événement et des arguments de chaîne fournis. (Hérité de EventSource) |
| WriteEventCore(Int32, Int32, EventSource+EventData*) |
Crée une surcharge WriteEvent à l'aide de l'identificateur d'événement et des données d'événement fournis. (Hérité de EventSource) |
| WriteEventWithRelatedActivityId(Int32, Guid, Object[]) |
Écrit un événement qui indique que l'activité actuelle est liée à une autre activité. (Hérité de EventSource) |
| WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) |
Écrit un événement qui indique que l'activité actuelle est liée à une autre activité. (Hérité de EventSource) |
Événements
| EventCommandExecuted |
Se produit lorsqu’une commande est issue d’un détecteur d’événements. (Hérité de EventSource) |
