DiagnosticSource.OnActivityExport(Activity, Object) Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.DiagnosticSource.dll

Sumber:

DiagnosticSourceActivity.cs

Mentransfer status dari aktivitas ke beberapa peristiwa atau operasi, seperti permintaan HTTP keluar, yang akan terjadi di luar proses.

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

Aktivitas yang dipengaruhi oleh peristiwa eksternal.

payload

Object

Objek yang mewakili permintaan keluar.

Keterangan

Jika situs instrumentasi berada di lokasi di mana aktivitas meninggalkan proses (seperti permintaan HTTP keluar), situs tersebut akan ingin mentransfer status dari aktivitas ke permintaan keluar.

Sejauh mungkin, ini harus dilakukan oleh situs instrumentasi, karena ada kontrak antara logika permintaan dan Activity unit organisasi di situs instrumentasi. Namun, situs instrumentasi tidak dapat menangani kebijakan (misalnya, apakah informasi aktivitas harus dinonaktifkan atau ditulis dalam format yang lebih lama karena alasan kompatibilitas). Untuk ini, situs instrumentasi perlu memanggil kembali ke sistem pengelogan dan memintanya untuk menyelesaikan kebijakan. Ini adalah tujuan dari OnActivityExport metode ini.

Metode OnActivityExport ini diberikan Activity serta objek payload yang mewakili permintaan keluar. DiagnosticSource Pelanggan kemudian memiliki kemampuan untuk memperbarui permintaan keluar sebelum dikirim.

Perhatikan bahwa metode ini jarang digunakan di situs instrumentasi (hanya situs-situs yang berada di batas keluar dari proses). Selain itu, biasanya kebijakan default yang dilakukan situs instrumentasi (misalnya, untuk mentransfer semua status aktivitas dalam konvensi keluar tertentu) kemungkinan akan baik-baik saja. Metode ini hanya untuk kasus di mana itu adalah masalah. Dengan demikian, metode ini harus digunakan sangat jarang dan sebagian besar di sini untuk simetri dengan OnActivityImport dan pemeriksa masa depan.

Perhatikan bahwa payload diketik sebagai Object di sini, tetapi situs instrumentasi dan pelanggan tertentu harus mengetahui jenis payload dan dengan demikian mentransmisikan dan mendekodenya jika perlu.