Compartilhar via

Instrumenter interface

  • Referência
Pacote:
@azure/core-tracing

Representa um instrumentador independente de implementação.

Métodos

createRequestHeaders(TracingContext)

Fornece um método específico da implementação para serializar um TracingSpan para um conjunto de cabeçalhos.
parseTraceparentHeader(string)

Fornece um método específico de implementação para analisar um https://www.w3.org/TR/trace-context/#traceparent-header em um <xref:TracingSpanContext> que pode ser usado para vincular intervalos não pai juntos.
startSpan(string, InstrumenterSpanOptions)

Cria um novo TracingSpan com o nome e as opções fornecidos e o define em um novo contexto.
withContext<CallbackArgs, Callback>(TracingContext, Callback, CallbackArgs)

Encapsula um retorno de chamada com um contexto ativo e chama o retorno de chamada. Dependendo da implementação, isso pode definir o contexto ativo disponível globalmente.

Detalhes do método

createRequestHeaders(TracingContext)

Fornece um método específico da implementação para serializar um TracingSpan para um conjunto de cabeçalhos.

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

Parâmetros

tracingContext
TracingContext

O contexto que contém o intervalo a ser serializado.

Retornos

Record<string, string>

parseTraceparentHeader(string)

Fornece um método específico de implementação para analisar um https://www.w3.org/TR/trace-context/#traceparent-header em um <xref:TracingSpanContext> que pode ser usado para vincular intervalos não pai juntos.

function parseTraceparentHeader(traceparentHeader: string): TracingContext | undefined

Parâmetros

traceparentHeader

string

Retornos

TracingContext | undefined

startSpan(string, InstrumenterSpanOptions)

Cria um novo TracingSpan com o nome e as opções fornecidos e o define em um novo contexto.

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

Parâmetros

name

string

O nome do intervalo. Por convenção, deve ser ${className}.${methodName}.

spanOptions
InstrumenterSpanOptions

As opções a serem usadas ao criar o intervalo.

Retornos

{ span: TracingSpan, tracingContext: TracingContext }

Um TracingSpan que pode ser usado para encerrar o intervalo e o contexto em que esse intervalo foi definido.

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

Encapsula um retorno de chamada com um contexto ativo e chama o retorno de chamada. Dependendo da implementação, isso pode definir o contexto ativo disponível globalmente.

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

Parâmetros

context
TracingContext

O TracingContext a ser usado como o contexto ativo no escopo do retorno de chamada.

callback

Callback

O retorno de chamada a ser invocado com o contexto determinado definido como o contexto globalmente ativo.

callbackArgs

CallbackArgs

Os argumentos de retorno de chamada.

Retornos

ReturnType<Callback>