DiagnosticSource.OnActivityExport(Activity, Object) Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.DiagnosticSource.dll

Zdroj:

DiagnosticSourceActivity.cs

Přenese stav z aktivity na nějakou událost nebo operaci, například odchozí požadavek HTTP, která proběhne mimo proces.

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)

Parametry

activity

Activity

Aktivita ovlivněná externí událostí.

payload

Object

Objekt, který představuje odchozí požadavek.

Poznámky

Pokud je lokalita instrumentace v umístění, kde aktivity opouštějí proces (například odchozí požadavky HTTP), bude tato lokalita chtít přenést stav z aktivity do odchozího požadavku.

Pokud je to možné, mělo by to být provedeno lokalitou instrumentace, protože v lokalitě instrumentace existuje smlouva mezi logikou Activity požadavku a ougoing. Web instrumentace ale nemůže zpracovávat zásady (například to, jestli mají být informace o aktivitě zakázané nebo napsané ve starším formátu z důvodu kompatibility). Za tímto účelem musí lokalita instrumentace volat zpět do systému protokolování a požádat ho o vyřešení zásad. To je účel OnActivityExport metody.

Metoda OnActivityExport je přidělena Activity a objekt datové části, který představuje odchozí požadavek. Odběratel DiagnosticSource pak může před odesláním aktualizovat odchozí požadavek.

Všimněte si, že tato metoda se zřídka používá v lokalitách instrumentace (pouze ty lokality, které jsou na odchozí hranici procesu). Kromě toho je obvykle pravděpodobné, že výchozí zásady, které lokalita instrumentace provádí (například k přenosu všech stavů aktivit v určité odchozí konvenci), budou pravděpodobně v pořádku. Tato metoda je určena pouze pro případy, kdy se jedná o problém. Proto by se tato metoda měla používat velmi zřídka a je zde většinou určena pro symetrii s testováním OnActivityImport a testováním do budoucna.

Všimněte si, že payload je sem zadán Object , ale každý konkrétní instrumentační web a odběratel by měli znát typ datové části a v případě potřeby ji přetypovat a dekódovat.