Mappage d'événements de base de données de surveillance

Article
03/05/2012

Cette rubrique contient le mappage des champs de la table intermédiaire dans la base de données de surveillance aux vues d'événements pour chaque type d'événement émis par le composant d'exécution Windows Workflow Foundation (WF). Ces informations sont nécessaires lors de la configuration d'une base de données de surveillance non-SQL pour une utilisation avec Microsoft AppFabric 1.1 pour Windows Server. Lorsque vous utilisez SQL Server, toutes les vues et la table intermédiaire sont créées par le processus de configuration d'AppFabric. Toutefois, dans le cadre d'une implémentation de base de données non-SQL, vous devez créer manuellement ces vues et la table intermédiaire. Lorsqu'un événement se produit dans un service WCF ou WF géré par AppFabric, le service de collecte d'événements ; écrit une ligne correspondant à cet événement dans la table ASStagingTable de la base de données de surveillance. Il est nécessaire de mapper ces données à la vue correspondante afin qu'elles puissent être affichées dans le tableau de bord d'AppFabric. Ce mappage peut être effectué à l'aide du mécanisme de votre choix pour transmettre les données de la table intermédiaire vers une table prenant en charge les vues de surveillance. Par exemple, vous pouvez utiliser un déclencheur de base de données ou une tâche.

Ce document n'inclut que quelques événements et mappages de vues. Pour obtenir un ensemble d'événements complet et les mappages associés, téléchargez les mappages d'événements de base de données d'AppFabric. Pour plus d'informations sur ce processus de mappage, consultez les rubriques Procédure d'utilisation d'une base de données de surveillance non-SQL Server et Vues et tables des bases de données de surveillance.

Mappage courant des événements

Table ASStagingTable

Chaque événement renseigne les champs suivants de la table ASStagingTable.

Colonnes de la table ASStagingTable	Données de l'événement
EventTypeId	ID de l'événement émis
E2EActivityId	ID d'activité de bout en bout émis avec l'événement
Computer	Nom de l'ordinateur sur lequel l'événement est émis
EventSource	Chemin d'accès virtuel de l'événement
ProcessId	ID du processus
TraceLevelId	Niveau de suivi de l'événement émis
TimeCreated	Heure de création de l'événement

Vue ASEventSources

La plupart des événements renseignent la vue ASEventSources (à l'exception de l'ID d'événement 499).

Nom de colonne	Source des données
ID	ID de la source de l'événement. Utilisé par les autres vues pour obtenir les détails relatifs à la source de l'événement.
Name	Nom du service extrait de la colonne EventSource de la table ASStagingTable
Computer	Mappé à la colonne Computer de la table ASStagingTable
Site	Nom du site extrait de la colonne EventSource de la table ASStagingTable
VirtualPath	Nom du chemin d'accès virtuel extrait de la colonne EventSource de la table ASStagingTable
ApplicationVirtualPath	Nom du chemin d'accès virtuel de l'application extrait de la colonne EventSource de la table ASStagingTable
ServiceVirtualPath	Nom du chemin d'accès virtuel du service extrait de la colonne EventSource de la table ASStagingTable

Vue ASEvents

La plupart des événements renseignent la vue ASEvents (à l'exception de l'ID d'événement 499).

Nom de colonne	Source des données
EventTypeId	EventTypeId mappé à la colonne ASStagingTable.EventTypeId
EventName	Nom de l'événement
EventVersion	Version de l'événement. Actuellement 0.
EventSourceID	Mappé à l'ID de la source de l'événement dans la vue ASEventSources
ProcessId	Mappé à la colonne ASStagingTable.ProcessId
TraceLevelId	Mappé à la colonne ASStagingTable.TraceLevelID
TraceLevel	Représentation sous forme de chaîne de TraceLevelId
E2EActivityId	Mappé à la colonne ASStagingTable.E2EActivityId
TimeCreated	Mappé à la colonne ASStagingTable.TimeCreated

Événements

Voici certains des mappages d'événements pour implémenter une base de données de surveillance.

ID d'événement 100

Outre les colonnes courantes, le service de collecte d'événements ; renseigne les colonnes suivantes de la table ASStagingTable pour l'ID d'événement 100.

Données de l'événement	Colonnes de la table ASStagingTable
TypeName	Data1UniqueId
RecordNumber	Data1BigInt
ActivityRootId	Data3Str
State	Data2Str
Tracking Profile Name	Data1Str
Annotations	CustomAnnotations

Les données de l'événement 100 renseignent les vues suivantes : ASEventSources, ASWfEvents, ASEvents, ASWfTrackingProfiles, ASWfEventAnnotations. Le mappage des données de la table ASStagingTable aux vues courantes ASEventSources et ASEvents est spécifié dans les mappages courants.

Vue : ASWfEventAnnotations

Cette vue est mise à jour avec les annotations émises avec les événements de suivi WF des services WF.

Nom de colonne	Données renseignées
Id	Identificateur unique de la ligne d'événement
AnnotationSetId	Clé pour rechercher l'événement WF ayant émis l'annotation
Name	Nom de l'annotation obtenue de la colonne ASStagingTable.CustomAnnotations
Value	Valeur de l'annotation obtenue de la colonne ASStagingTable.CustomAnnotations

Extraction du nom et de la valeur des annotations de la colonne ASStagingTable.CustomAnnotations

Les annotations sont stockées comme suit. Elles sont émises avec cet événement. Les valeurs des annotations sont stockées dans ce format.

 
< items >
< item  name = "annotationName" type="System.String">annotationValue</item>
</items >

Si aucune annotation n'est spécifiée, la chaîne contient </items>. Les données name et value sont extraites en analysant la valeur stockée dans la colonne ASStagingTable.CustomAnnotations.

Vue ASWfTrackingProfiles

Nom de colonne	Données renseignées
Id	ID unique du modèle de suivi
Name	Mappé à la colonne ASStagingTable.Data1Str de la table ASStagingTable

Vue ASWfEvents

Seules les colonnes renseignées pour cet événement dans cette vue sont spécifiées. Toutes les autres colonnes ont la valeur NULL. La valeur spécialement renseignée par l'événement est spécifiée en gras. Cette vue est créée sur les événements de suivi émis pour les instances de flux de travail.

Nom de colonne	Données renseignées
Id	ID unique généré
EventTypeId	100 (mappé à la colonne EventTypeId de la table ASStagingTable)
EventType	“WorkflowInstanceRecord”
EventVersion	0
EventSourceId	ID dans la vue ASEventSources
ProcessId	Mappé à la colonne ASStagingTable-> : ASStagingTable.ProcessId
WorkflowInstanceId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1UniqueId
TrackingProfileId	ID unique du modèle de suivi mappé à la colonne ID dans la vue ASWfTrackingProfiles. Cette colonne et la vue ASWfTrackingProfiles sont mises à jour via une transaction unique.
E2EActivityId	Mappé à la colonne ASStagingTable-> : ASStagingTable.E2EActivityId
TraceLevelId	Mappé à la colonne ASStagingTable-> : ASStagingTable.TraceLevelId
TraceLevel	Dépendant de TraceLevelId: 0:”LogAlways”1:”Critical”2:”Error”3:”Warning”4:”Information”5:”Verbose”
RecordNumber	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1BigInt
AnnotationSetId	ID unique du jeu d'annotations mappé à la colonne AnnotationSetId dans la vue ASWfEventAnnotations. Cette colonne et la vue ASWfEventAnnotations sont mises à jour via une transaction unique.
TimeCreated	Mappé à la colonne ASStagingTable-> : ASStagingTable.TimeCreated
ActivityRootId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data3Str
State	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data2Str

Vue : ASWfInstances

Cette vue est mise à jour avec l'état de l'instance de flux de travail active. Cette vue est mise à jour après la vue ASWfEvents, mais au cours de la même transaction. Lorsqu'un événement est ajouté à la vue ASWfEvents, celle-ci doit être mise à jour simultanément avec les valeurs insérées dans la vue ASWfEvents, et donc via la même transaction. Il n'y a qu'une ligne par instance de flux de travail. Chaque événement ajouté à la table WFEvents modifie la ligne de l'instance de flux de travail. Une ligne est ajoutée/mise à jour dans cette table sous certaines conditions uniquement. Si l'état est « Deleted » ou « Unloaded » (ASWfEvents.State) pour un événement associé à l'ID 100, aucune ligne n'est ajoutée à la table.

Nom de colonne	Données renseignées
Id	ID unique de l'entrée
WorkflowInstanceId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1UniqueId (ajouté une seule fois pour une instance unique).
LastEventSourceId	Dernier ID de source d'événement (eventSourceID) ayant modifié la ligne. Mappé à la colonne ASWfEvents.EventSourceId.
LastEventStatus	Mappé à la colonne ASWfEvents.State de la vue ASWfEvents. Inséré/mis à jour uniquement si l'état est différent de « Deleted » ou « Unloaded ». Si l'état est « Deleted » ou « Unloaded », une ligne est ajoutée à la table.
StartTime	Mappé à la colonne ASWfEvents.TimeCreated de la vue ASWfEvents. Il s'agit de l'heure de création (TimeCreated) de l'événement associé au numéro d'enregistrement (RecordNumber) le plus faible pour cette instance de flux de travail.
LastModifiedTime	Mappé à la colonne ASWfEvents.TimeCreated de la vue ASWfEvents. Mis à jour lorsque l'état change. Pour mettre à jour cette colonne, le numéro d'enregistrement (RecordNumber) de l'enregistrement de flux de travail (WorkflowRecord) doit être supérieur au numéro d'enregistrement précédent qui a mis à jour cette valeur. Une implémentation possible consiste à utiliser une table temporaire qui mappe l'ID d'instance dans cette table au numéro d'enregistrement (RecordNumber) de l'enregistrement d'événement de flux de travail dans la vue ASWfEvents qui l'a modifié. Lorsqu'un nouvel événement tente de mettre à jour cette ligne pour cette instance, vérifiez si le numéro d'enregistrement est supérieur à celui le plus récemment modifié.
CurrentDuration	Durée du flux de travail en cours d'exécution (LastModifiedTime – StartTime)
ExceptionCount	Nombre d'exceptions rencontrées par le flux de travail. Non mis à jour par l'ID d'événement 100.
LastAbortedTime	Non mis à jour par l'ID d'événement 100.

Pour plus d'informations sur cet événement, consultez la page 100 - WorkflowInstanceRecord (https://go.microsoft.com/fwlink/?LinkId=187224)

ID d'événement 103

Outre les colonnes courantes, le service de collecte d'événements ; renseigne les colonnes suivantes de la table ASStagingTable pour l'ID d'événement 103.

Données de l'événement	Colonnes de la table ASStagingTable
workflowinstanceid	Data1UniqueId
RecordNumber	Data1BigInt
Tracking Profile Name	Data1Str
State	Data2Str
ActivityName	Data3Str
ActivityId	Data4Str
ActivityInstanceId	Data5Str
ActivityTypeName	Data6Str
Annotations	CustomAnnotations
Variables	CustomProperties
Arguments	CustomArguments

Les données de l'événement 103 renseignent les vues suivantes : ASEventSources, ASWfEvents, ASEvents, ASWfTrackingProfiles, ASWfEventAnnotations, ASWfEventProperties, ASWfPropertyNames. Le mappage des données de la table ASStagingTable aux vues courantes ASEventSources et ASEvents est spécifié dans les mappages courants.

Vue : ASWfEventAnnotations

Cette vue est mise à jour avec les annotations émises avec les événements de suivi WF des services WF.

Nom de colonne	Données renseignées
Id	Identificateur unique de la ligne d'événement
AnnotationSetId	Clé pour rechercher l'événement WF ayant émis l'annotation
Name	Nom de l'annotation obtenue de la colonne ASStagingTable.CustomAnnotations
Value	Valeur de l'annotation obtenue de la colonne ASStagingTable.CustomAnnotations

Extraction du nom et de la valeur des annotations de la colonne ASStagingTable.CustomAnnotations

Elles sont émises avec cet événement. Les valeurs des annotations sont stockées dans le format suivant. Si aucune annotation n'est spécifiée, la chaîne contient </items>. Les données name et value sont extraites en analysant la valeur stockée dans la colonne ASStagingTable.CustomAnnotations.

 
< items >
< item  name = "annotationName" type="System.String">annotationValue</item>
</items >

Vue : ASWfPropertyNames

Cette vue est créée sur les noms de propriété suivie extraits des services WF. Le nom peut être un nom de variable, un nom d'argument ou un nom dans customtrackingrecord.

Nom de colonne	Données renseignées
EventSourceId	Source de l'événement. Fait référence à l'ID indiqué dans la vue EventSources.
Name	Nom de la propriété suivie
Type	Type de la propriété suivie

Extraction des données Name et Type de la colonne ASStagingTable.CustomProperties ou ASStagingTable CustomArguments

Les variables de flux de travail sont stockées dans la colonne ASStagingTable.CustomProperties. Pour l'événement 103, le format des variables est le suivant. Si aucune variable n'est spécifiée, la chaîne contient </items>. Analysez la chaîne XML pour obtenir le nom et le type de la variable.

< items >
< item  name = "variableName" type="System.String">variableValue</item>
</items >

Les arguments sont stockés dans la colonne ASStagingTable.CustomArguments. Pour l'événement 103, le format des arguments est le suivant. Analysez la chaîne XML pour obtenir le nom et le type de l'argument. Si aucun argument n'est spécifié, la chaîne contient </items>.

< items >
< item  name = "argumentName" type="System.String">argumentValue</item>
</items >

Vue : ASWfEventProperties

Cette vue inclut une ligne par variable/argument/propriété personnalisée extraite de l'événement WF.

Nom de colonne	Données renseignées
EventId	Mappé à la colonne ASWfEvents.Id de la vue ASWfEvents. Fait référence à l'événement de flux de travail ayant émis ces données.
Name	Nom extrait de l'analyse de la chaîne XML dans la colonne ASStagingTable.CustomArguments ou ASStagingTable.CustomProperties
WfDataSource	Source de la propriété (argument, variable ou données personnalisées). Si les données proviennent de la colonne ASStagingTable.CustomArguments, la valeur est « Argument ». Si les données proviennent de la colonne ASStagingTable.CustomProperties, la valeur est « Variable ».
Type	Type de la propriété extraite de la chaîne XML dans la colonne CustomArguments ou CustomProperties
Value	Valeur de la propriété extraite de la chaîne XML dans la colonne CustomArguments ou CustomProperties lorsque le type est simple
ValueBlob	Valeur de la propriété extraite de la chaîne XML dans la colonne CustomArguments ou CustomProperties lorsque le type est complexe
TimeCreated	Horodatage d'émission de cette propriété. Mappé à la colonne ASWfEvents.TimeCreated

Vue ASWfTrackingProfiles

Nom de colonne	Données renseignées
Id	ID unique du modèle de suivi
Name	Mappé à la colonne ASStagingTable.Data1Str de la table ASStagingTable

Vue ASWfEvents

Nom de colonne	Données renseignées
Id	ID unique généré
EventTypeId	103 (mappé à la colonne EventTypeId de la table ASStagingTable)
EventType	“ActivityStateRecord”
EventVersion	0
EventSourceId	ID dans la vue ASEventSources
ProcessId	Mappé à la colonne ASStagingTable-> : ASStagingTable.ProcessId
WorkflowInstanceId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1UniqueId
TrackingProfileId	ID unique du modèle de suivi mappé à la colonne ID dans la vue ASWfTrackingProfiles. Cette colonne et la vue ASWfTrackingProfiles sont mises à jour via une transaction unique.
E2EActivityId	Mappé à la colonne ASStagingTable-> : ASStagingTable.E2EActivityId
TraceLevelId	Mappé à la colonne ASStagingTable-> : ASStagingTable.TraceLevelId
TraceLevel	Dépendant de TraceLevelId: 0:”LogAlways”1:”Critical”2:”Error”3:”Warning”4:”Information”5:”Verbose”
RecordNumber	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1BigInt
AnnotationSetId	ID unique du jeu d'annotations mappé à la colonne AnnotationSetId dans la vue ASWfEventAnnotations. Cette colonne et la vue ASWfEventAnnotations sont mises à jour via une transaction unique.
TimeCreated	Mappé à la colonne ASStagingTable-> : ASStagingTable.TimeCreated
ActivityName	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data3Str
ActivityId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data4Str
ActivityInstanceId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data5Str
ActivityTypeName	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data6Str
State	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data2Str

Vue : ASWfInstances

Nom de colonne	Données renseignées
Id	ID unique de l'entrée
WorkflowInstanceId	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1UniqueId. (ajouté une seule fois pour une instance unique).
LastEventSourceId	Dernier ID de source d'événement (eventSourceID) ayant modifié la ligne. Mappé à la colonne ASWfEvents.EventSourceId.
LastEventStatus	Mappé à la colonne ASWfEvents.State de la vue ASWfEvents. Inséré/mis à jour uniquement si l'état est différent de « Deleted » ou « Unloaded ». Si l'état est « Deleted » ou « Unloaded », aucune ligne n'est ajoutée à cette table. Dans le cas de l'événement 101, la valeur est « UnhandledException ».
StartTime	Mappé à la colonne ASWfEvents.TimeCreated de la vue ASWfEvents. Il s'agit de l'heure de création (TimeCreated) de l'événement associé au numéro d'enregistrement (RecordNumber) le plus faible pour l'instance de flux de travail représentée par la colonne ASWfEvents.WorkflowInstanceId.
LastModifiedTime	Mappé à la colonne ASWfEvents.TimeCreated de la vue ASWfEvents. Mis à jour lorsque l'état change. Pour mettre à jour cette colonne, le numéro d'enregistrement (RecordNumber) de l'enregistrement de flux de travail (WorkflowRecord) doit être supérieur au numéro d'enregistrement précédent qui a mis à jour cette valeur. Une implémentation possible consiste à utiliser une table temporaire qui mappe l'ID d'instance dans cette table au numéro d'enregistrement (RecordNumber) de l'enregistrement d'événement de flux de travail dans la vue ASWfEvents qui l'a modifié. Lorsqu'un nouvel événement tente de mettre à jour cette ligne pour cette instance, vérifiez si le numéro d'enregistrement est supérieur à celui le plus récemment modifié.
CurrentDuration	Durée du flux de travail en cours d'exécution (LastModifiedTime – StartTime)
ExceptionCount	Nombre d'exceptions rencontrées par le flux de travail. Nombre d'événements 101 rencontrés par cette instance de flux de travail représentée par l'ID d'instance ASWfEvents. WorkflowInstanceId.
LastAbortedTime	Heure de fin de la vue ASWfEvents pour l'événement associé à l'ID 101 ou 102. Pour l'instance du flux de travail représentée par ASWfEvents.WorkflowInstanceId.

Pour plus d'informations sur cet événement, consultez la page 103 - WorkflowInstanceRecord (https://go.microsoft.com/fwlink/?LinkId=187226).

ID d'événement 214

Outre les colonnes courantes, le service de collecte d'événements ; renseigne les colonnes suivantes de la table ASStagingTable pour l'ID d'événement 214.

Données de l'événement	Colonnes de la table ASStagingTable
MethodName	Data1Str
Duration	Data1Int

Les données de l'événement 214 renseignent les vues suivantes : ASEventSources, ASWcfEvents, ASEvents. Le mappage des données de la table ASStagingTable aux vues courantes ASEventSources et ASEvents est spécifié dans les mappages courants.

Vue ASWcfEvents

Nom de colonne	Données renseignées
Id	ID unique généré
EventTypeId	214 (mappé à la colonne EventTypeId de la table ASStagingTable)
EventType	““OperationCompleted”
EventVersion	0
EventSourceId	ID dans la vue ASEventSources
ProcessId	Mappé à la colonne ASStagingTable-> : ProcessId
TraceLevelId	Mappé à la colonne ASStagingTable-> : TraceLevelId
TraceLevel	Dépendant de TraceLevelId: 0:”LogAlways”1:”Critical”2:”Error”3:”Warning”4:”Information”5:”Verbose”
E2EActivityId	Mappé à la colonne ASStagingTable-> : ASStagingTable.E2EActivityId
TimeCreated	Mappé à la colonne ASStagingTable-> : ASStagingTable.TimeCreated
OperationName	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1Str
Duration	Mappé à la colonne ASStagingTable-> : ASStagingTable.Data1Int

Pour plus d'informations sur cet événement, consultez la page 214 - WorkflowInstanceRecord (https://go.microsoft.com/fwlink/?LinkId=187225).

ID d'événement 219