Marc Mintel
5397309103
Some checks failed
Build & Deploy / 🔍 Prepare (push) Successful in 20s
Build & Deploy / 🧪 QA (push) Failing after 34s
Build & Deploy / 🏗️ Build (push) Has started running
Build & Deploy / 🚀 Deploy (push) Has been cancelled
Build & Deploy / 🧪 Smoke Test (push) Has been cancelled
Build & Deploy / ⚡ Lighthouse (push) Has been cancelled
Build & Deploy / 🔔 Notify (push) Has been cancelled
71 lines
2.6 KiB
Plaintext
71 lines
2.6 KiB
Plaintext
import { Context } from '../context/types';
|
|
import { Span } from './span';
|
|
import { SpanOptions } from './SpanOptions';
|
|
/**
|
|
* Tracer provides an interface for creating {@link Span}s.
|
|
*/
|
|
export interface Tracer {
|
|
/**
|
|
* Starts a new {@link Span}. Start the span without setting it on context.
|
|
*
|
|
* This method do NOT modify the current Context.
|
|
*
|
|
* @param name The name of the span
|
|
* @param [options] SpanOptions used for span creation
|
|
* @param [context] Context to use to extract parent
|
|
* @returns Span The newly created span
|
|
* @example
|
|
* const span = tracer.startSpan('op');
|
|
* span.setAttribute('key', 'value');
|
|
* span.end();
|
|
*/
|
|
startSpan(name: string, options?: SpanOptions, context?: Context): Span;
|
|
/**
|
|
* Starts a new {@link Span} and calls the given function passing it the
|
|
* created span as first argument.
|
|
* Additionally the new span gets set in context and this context is activated
|
|
* for the duration of the function call.
|
|
*
|
|
* @param name The name of the span
|
|
* @param [options] SpanOptions used for span creation
|
|
* @param [context] Context to use to extract parent
|
|
* @param fn function called in the context of the span and receives the newly created span as an argument
|
|
* @returns return value of fn
|
|
* @example
|
|
* const something = tracer.startActiveSpan('op', span => {
|
|
* try {
|
|
* do some work
|
|
* span.setStatus({code: SpanStatusCode.OK});
|
|
* return something;
|
|
* } catch (err) {
|
|
* span.setStatus({
|
|
* code: SpanStatusCode.ERROR,
|
|
* message: err.message,
|
|
* });
|
|
* throw err;
|
|
* } finally {
|
|
* span.end();
|
|
* }
|
|
* });
|
|
*
|
|
* @example
|
|
* const span = tracer.startActiveSpan('op', span => {
|
|
* try {
|
|
* do some work
|
|
* return span;
|
|
* } catch (err) {
|
|
* span.setStatus({
|
|
* code: SpanStatusCode.ERROR,
|
|
* message: err.message,
|
|
* });
|
|
* throw err;
|
|
* }
|
|
* });
|
|
* do some more work
|
|
* span.end();
|
|
*/
|
|
startActiveSpan<F extends (span: Span) => unknown>(name: string, fn: F): ReturnType<F>;
|
|
startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, fn: F): ReturnType<F>;
|
|
startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, context: Context, fn: F): ReturnType<F>;
|
|
}
|
|
//# sourceMappingURL=tracer.d.ts.map |