49 lines
1.4 KiB
TypeScript
49 lines
1.4 KiB
TypeScript
|
/**
|
||
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
||
|
|
*
|
||
|
|
* This source code is licensed under the MIT license found in the
|
||
|
|
* LICENSE file in the root directory of this source tree.
|
||
|
|
*
|
||
|
|
* @format
|
||
|
|
*/
|
||
|
|
|
||
|
|
export type Timespan = {
|
||
|
|
startTime: number;
|
||
|
|
endTime?: number | undefined;
|
||
|
|
totalTime?: number | undefined;
|
||
|
|
startExtras?: Extras | undefined;
|
||
|
|
endExtras?: Extras | undefined;
|
||
|
|
};
|
||
|
|
|
||
|
|
// Extra values should be serializable primitives
|
||
|
|
export type ExtraValue = number | string | boolean;
|
||
|
|
|
||
|
|
export type Extras = {[key: string]: ExtraValue};
|
||
|
|
|
||
|
|
export interface IPerformanceLogger {
|
||
|
|
addTimespan(
|
||
|
|
key: string,
|
||
|
|
startTime: number,
|
||
|
|
endTime: number,
|
||
|
|
startExtras?: Extras,
|
||
|
|
endExtras?: Extras,
|
||
|
|
): void;
|
||
|
|
append(logger: IPerformanceLogger): void;
|
||
|
|
clear(): void;
|
||
|
|
clearCompleted(): void;
|
||
|
|
close(): void;
|
||
|
|
currentTimestamp(): number;
|
||
|
|
getExtras(): {[key: string]: ExtraValue | null};
|
||
|
|
getPoints(): {[key: string]: number | null};
|
||
|
|
getPointExtras(): {[key: string]: Extras | null};
|
||
|
|
getTimespans(): {[key: string]: Timespan | null};
|
||
|
|
hasTimespan(key: string): boolean;
|
||
|
|
isClosed(): boolean;
|
||
|
|
logEverything(): void;
|
||
|
|
markPoint(key: string, timestamp?: number, extras?: Extras): void;
|
||
|
|
removeExtra(key: string): ExtraValue | null;
|
||
|
|
setExtra(key: string, value: ExtraValue): void;
|
||
|
|
startTimespan(key: string, timestamp?: number, extras?: Extras): void;
|
||
|
|
stopTimespan(key: string, timestamp?: number, extras?: Extras): void;
|
||
|
|
}
|