PerformanceTrace interface

The interface representing a Trace.

Signature:

export interface PerformanceTrace 

Methods

Method	Description
getAttribute(attr)	Retrieves the value which a custom attribute is set to.
getAttributes()	Returns a map of all custom attributes of a trace instance.
getMetric(metricName)	Returns the value of the custom metric by that name. If a custom metric with that name does not exist will return zero.
incrementMetric(metricName, num)	Adds to the value of a custom metric. If a custom metric with the provided name does not exist, it creates one with that name and the value equal to the given number. The value will be floored down to an integer.
putAttribute(attr, value)	Set a custom attribute of a trace to a certain value.
putMetric(metricName, num)	Sets the value of the specified custom metric to the given number regardless of whether a metric with that name already exists on the trace instance or not. The value will be floored down to an integer.
record(startTime, duration, options)	Records a trace from given parameters. This provides a direct way to use trace without a need to start/stop. This is useful for use cases in which the trace cannot directly be used (e.g. if the duration was captured before the Performance SDK was loaded).
removeAttribute(attr)	Removes the specified custom attribute from a trace instance.
start()	Starts the timing for the trace instance.
stop()	Stops the timing of the trace instance and logs the data of the instance.

PerformanceTrace.getAttribute()

Retrieves the value which a custom attribute is set to.

Signature:

getAttribute(attr: string): string | undefined;

Parameters

Parameter	Type	Description
attr	string	Name of the custom attribute.

Returns:

string | undefined

PerformanceTrace.getAttributes()

Returns a map of all custom attributes of a trace instance.

Signature:

getAttributes(): {
        [key: string]: string;
    };

Returns:

{ [key: string]: string; }

PerformanceTrace.getMetric()

Returns the value of the custom metric by that name. If a custom metric with that name does not exist will return zero.

Signature:

getMetric(metricName: string): number;

Parameters

Parameter	Type	Description
metricName	string	Name of the custom metric.

Returns:

number

PerformanceTrace.incrementMetric()

Adds to the value of a custom metric. If a custom metric with the provided name does not exist, it creates one with that name and the value equal to the given number. The value will be floored down to an integer.

Signature:

incrementMetric(metricName: string, num?: number): void;

Parameters

Parameter	Type	Description
metricName	string	The name of the custom metric.
num	number	The number to be added to the value of the custom metric. If not provided, it uses a default value of one.

Returns:

void

PerformanceTrace.putAttribute()

Set a custom attribute of a trace to a certain value.

Signature:

putAttribute(attr: string, value: string): void;

Parameters

Parameter	Type	Description
attr	string	Name of the custom attribute.
value	string	Value of the custom attribute.

Returns:

void

PerformanceTrace.putMetric()

Sets the value of the specified custom metric to the given number regardless of whether a metric with that name already exists on the trace instance or not. The value will be floored down to an integer.

Signature:

putMetric(metricName: string, num: number): void;

Parameters

Parameter	Type	Description
metricName	string	Name of the custom metric.
num	number	Value to of the custom metric.

Returns:

void

PerformanceTrace.record()

Records a trace from given parameters. This provides a direct way to use trace without a need to start/stop. This is useful for use cases in which the trace cannot directly be used (e.g. if the duration was captured before the Performance SDK was loaded).

Signature:

record(startTime: number, duration: number, options?: {
        metrics?: {
            [key: string]: number;
        };
        attributes?: {
            [key: string]: string;
        };
    }): void;

Parameters

Parameter	Type	Description
startTime	number	trace start time since epoch in millisec.
duration	number	The duration of the trace in millisec.
options	{ metrics?: { [key: string]: number; }; attributes?: { [key: string]: string; }; }	An object which can optionally hold maps of custom metrics and custom attributes.

Returns:

void

PerformanceTrace.removeAttribute()

Removes the specified custom attribute from a trace instance.

Signature:

removeAttribute(attr: string): void;

Parameters

Parameter	Type	Description
attr	string	Name of the custom attribute.

Returns:

void

PerformanceTrace.start()

Starts the timing for the trace instance.

Signature:

start(): void;

Returns:

void

PerformanceTrace.stop()

Stops the timing of the trace instance and logs the data of the instance.

Signature:

stop(): void;

Returns:

void