Instrumenter interface
Representa un instrumentador independiente de la implementación.
Métodos
create |
Proporciona un método específico de la implementación para serializar en TracingSpan un conjunto de encabezados. |
parse |
Proporciona un método específico de la implementación para analizar en https://www.w3.org/TR/trace-context/#traceparent-header un <xref:TracingSpanContext> que se puede usar para vincular intervalos no primarios juntos. |
start |
Crea un nuevo TracingSpan con el nombre y las opciones especificados y lo establece en un nuevo contexto. |
with |
Ajusta una devolución de llamada con un contexto activo y llama a la devolución de llamada. En función de la implementación, esto puede establecer el contexto activo disponible globalmente. |
Detalles del método
createRequestHeaders(TracingContext)
Proporciona un método específico de la implementación para serializar en TracingSpan un conjunto de encabezados.
function createRequestHeaders(tracingContext?: TracingContext): Record<string, string>
Parámetros
- tracingContext
- TracingContext
Contexto que contiene el intervalo que se va a serializar.
Devoluciones
Record<string, string>
parseTraceparentHeader(string)
Proporciona un método específico de la implementación para analizar en https://www.w3.org/TR/trace-context/#traceparent-header un <xref:TracingSpanContext> que se puede usar para vincular intervalos no primarios juntos.
function parseTraceparentHeader(traceparentHeader: string): TracingContext | undefined
Parámetros
- traceparentHeader
-
string
Devoluciones
TracingContext | undefined
startSpan(string, InstrumenterSpanOptions)
Crea un nuevo TracingSpan con el nombre y las opciones especificados y lo establece en un nuevo contexto.
function startSpan(name: string, spanOptions: InstrumenterSpanOptions): { span: TracingSpan, tracingContext: TracingContext }
Parámetros
- name
-
string
Nombre del intervalo. Por convención, debe ser ${className}.${methodName}
.
- spanOptions
- InstrumenterSpanOptions
Las opciones que se usarán al crear el intervalo.
Devoluciones
{ span: TracingSpan, tracingContext: TracingContext }
TracingSpan que se puede usar para finalizar el intervalo y el contexto en el que se ha establecido este intervalo.
withContext<CallbackArgs, Callback>(TracingContext, Callback, CallbackArgs)
Ajusta una devolución de llamada con un contexto activo y llama a la devolución de llamada. En función de la implementación, esto puede establecer el contexto activo disponible globalmente.
function withContext<CallbackArgs, Callback>(context: TracingContext, callback: Callback, callbackArgs: CallbackArgs): ReturnType<Callback>
Parámetros
- context
- TracingContext
que TracingContext se va a usar como contexto activo en el ámbito de la devolución de llamada.
- callback
-
Callback
Devolución de llamada que se va a invocar con el contexto especificado establecido como contexto activo globalmente.
- callbackArgs
-
CallbackArgs
Argumentos de devolución de llamada.
Devoluciones
ReturnType<Callback>