DiagnosticSource.OnActivityExport(Activity, Object) Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Quelle:

DiagnosticSourceActivity.cs

Überträgt den Status von einer Aktivität auf außerhalb des Prozesses stattfindende Ereignisse oder Vorgänge, wie z.B. eine ausgehende HTTP-Anfrage.

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

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

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

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

Parameter

activity

Activity

Die Aktivität, die von einem externen Ereignis betroffen ist.

payload

Object

Ein Objekt, das die ausgehende Anforderung darstellt

Hinweise

Wenn sich ein Instrumentierungsstandort an einem Ort befindet, an dem Aktivitäten den Prozess verlassen (z. B. ausgehende HTTP-Anforderungen), möchte dieser Standort den Zustand von der Aktivität in die ausgehende Anforderung übertragen.

Soweit möglich, sollte dies vom Instrumentierungsstandort erfolgen, da es einen Vertrag zwischen einer Activity und der Ougoing-Anforderungslogik am Instrumentierungsstandort gibt. Die Instrumentierungswebsite kann jedoch keine Richtlinie verarbeiten (z. B. ob Aktivitätsinformationen aus Kompatibilitätsgründen deaktiviert oder in einem älteren Format geschrieben werden sollen). Dazu muss der Instrumentierungsstandort das Protokollierungssystem zurückrufen und zum Auflösen der Richtlinie auffordern. Dies ist der Zweck der OnActivityExport -Methode.

Der OnActivityExport -Methode wird das Activity -Objekt sowie ein Nutzlastobjekt zur Verfügung gestellt, das die ausgehende Anforderung darstellt. Ein DiagnosticSource Abonnent hat dann die Möglichkeit, die ausgehende Anforderung zu aktualisieren, bevor sie gesendet wird.

Beachten Sie, dass diese Methode selten an Instrumentierungsstandorten verwendet wird (nur an Standorten, die sich an einer ausgehenden Grenze des Prozesses befinden). Darüber hinaus ist die Standardrichtlinie, die vom Instrumentierungsstandort ausgeführt wird (z. B. zum Übertragen des gesamten Aktivitätszustands in einer bestimmten ausgehenden Konvention), wahrscheinlich in Ordnung. Diese Methode gilt nur für Fälle, in denen dies ein Problem ist. Daher sollte diese Methode sehr selten verwendet werden und ist meist hier für die Symetrie mit OnActivityImport und zukunftssicher.

Beachten Sie, dass payload hier als Object typisiert wird, aber jeder bestimmte Instrumentierungsstandort und Abonnent sollte den Typ der Nutzlast kennen und sie bei Bedarf umwandeln und decodieren.