Instrumenter interface

參考

套件:: @azure/core-tracing

表示與實作無關的檢測器。

方法

createRequestHeaders(TracingContext)	提供實作特定的方法，將序列化 TracingSpan 為一組標頭。
parseTraceparentHeader(string)	提供實作特定的方法，將剖析 https://www.w3.org/TR/trace-context/#traceparent-header 成 <xref:TracingSpanContext> ，可用來將非父系範圍連結在一起。
startSpan(string, InstrumenterSpanOptions)	使用指定的名稱和選項建立新的 TracingSpan ，並在新的內容上設定它。
withContext<CallbackArgs, Callback>(TracingContext, Callback, CallbackArgs)	使用使用中內容包裝回呼，並呼叫回呼。視實作而定，這可能會設定全域可用的使用中內容。

方法詳細資料

createRequestHeaders(TracingContext)

提供實作特定的方法，將序列化 TracingSpan 為一組標頭。

function createRequestHeaders(tracingContext?: TracingContext): Record<string, string>

參數

tracingContext: TracingContext

包含要序列化之範圍的內容。

傳回

Record<string, string>

parseTraceparentHeader(string)

提供實作特定的方法，將剖析 https://www.w3.org/TR/trace-context/#traceparent-header 成 <xref:TracingSpanContext> ，可用來將非父系範圍連結在一起。

function parseTraceparentHeader(traceparentHeader: string): TracingContext | undefined

參數

traceparentHeader: string

傳回

TracingContext | undefined

startSpan(string, InstrumenterSpanOptions)

使用指定的名稱和選項建立新的 TracingSpan ，並在新的內容上設定它。

function startSpan(name: string, spanOptions: InstrumenterSpanOptions): { span: TracingSpan, tracingContext: TracingContext }

參數

name: string

範圍的名稱。依照慣例，這應該是 ${className}.${methodName} 。

spanOptions: InstrumenterSpanOptions

建立範圍時要使用的選項。

傳回

{ span: TracingSpan, tracingContext: TracingContext }

TracingSpan，可用來結束範圍，並已設定此範圍的內容。

withContext<CallbackArgs, Callback>(TracingContext, Callback, CallbackArgs)

使用使用中內容包裝回呼，並呼叫回呼。視實作而定，這可能會設定全域可用的使用中內容。

function withContext<CallbackArgs, Callback>(context: TracingContext, callback: Callback, callbackArgs: CallbackArgs): ReturnType<Callback>

參數

context: TracingContext

， TracingContext 做為回呼範圍內的使用中內容。

callback: Callback

要以指定內容集為全域使用中內容的叫用回呼。

callbackArgs: CallbackArgs

回呼引數。

傳回

ReturnType<Callback>

共用方式為