DiagnosticSource.OnActivityImport(Activity, Object) Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Source:

DiagnosticSourceActivity.cs

Transfère l’état à une activité depuis un événement ou une opération, comme une requête HTTP entrante, qui s’est produite en dehors du processus.

public:
 virtual void OnActivityImport(System::Diagnostics::Activity ^ activity, System::Object ^ payload);

public virtual void OnActivityImport (System.Diagnostics.Activity activity, object? payload);

abstract member OnActivityImport : System.Diagnostics.Activity * obj -> unit
override this.OnActivityImport : System.Diagnostics.Activity * obj -> unit

Public Overridable Sub OnActivityImport (activity As Activity, payload As Object)

Paramètres

activity

Activity

Activité affectée par un événement externe.

payload

Object

Charge utile qui représente la requête entrante.

Remarques

Si un site d’instrumentation crée une activité en réponse à un événement en dehors du processus, tel qu’une requête HTTP entrante), la OnActivityImport méthode permet à ce site de créer une activité et de transférer l’état de la demande entrante à l’activité.

Dans la mesure du possible, cela doit être effectué par le site d’instrumentation, car il existe un contrat entre la Activity logique de requête entrante et sur le site d’instrumentation. Toutefois, le site d’instrumentation ne peut pas gérer la stratégie. (Par exemple, si l’échantillonnage est effectué, quelles demandes doivent être échantillonnées exactement ?) Dans ce cas, le site d’instrumentation doit rappeler le système de journalisation et lui demander de résoudre la stratégie (par exemple, pour décider si le bit « d’échantillonnage » de l’activité doit être défini). C’est l’objectif de la OnActivityImport méthode. On lui donne l’activité ainsi qu’un objet de charge utile qui représente la requête entrante. Les abonnés au DiagnosticSource ont alors la possibilité de mettre à jour cette activité comme ils le souhaitent.

Cette méthode est rarement utilisée sur les sites d’instrumentation (uniquement les sites qui se trouvent à la limite du processus), et le site d’intrumetation implémente une stratégie par défaut (elle définit l’activité d’une manière ou d’une autre ), et il n’est donc pas nécessaire de remplacer cette méthode si cette stratégie par défaut est correcte. En d’autres termes, cette méthode doit être remplacée dans des cas très rares (mais souvent importants).

Notez que payload est tapé comme Object ici, mais tout site d’instrumentation et abonné particulier connaîtra le type de la charge utile et, par conséquent, la caster et la décoder si nécessaire.