Instrumenter interface
Представляет инструментатор, не зависящий от реализации.
Методы
create |
Предоставляет зависящий от реализации метод для сериализации в TracingSpan набор заголовков. |
parse |
Предоставляет метод, зависящий от реализации, для анализа https://www.w3.org/TR/trace-context/#traceparent-header<xref:TracingSpanContext> в , который можно использовать для связывания несемеченных диапазонов. |
start |
Создает объект TracingSpan с заданным именем и параметрами и задает его в новом контексте. |
with |
Заключает обратный вызов в активный контекст и вызывает обратный вызов. В зависимости от реализации это может задать глобально доступный активный контекст. |
Сведения о методе
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>