Class PerformanceLogger

Performance monitoring utilities for tracking operation timing and memory usage.

Index

Constructors

Accessors

Methods

calculateMemoryDelta categorizePerformance createTimer formatBytes getMemorySnapshot trackOperation trackSync

Constructors

constructor

new PerformanceLogger(): PerformanceLogger
Returns PerformanceLogger

Accessors

`Private` `Static`logger

get logger(): ILogger
Returns ILogger
- Defined in src/services/logging/performanceLogger.ts:20

Methods

`Private` `Static`calculateMemoryDelta

calculateMemoryDelta(start: MemorySnapshot, end: MemorySnapshot): MemoryDelta
Calculate memory usage delta between two snapshots.
Parameters
- start: MemorySnapshot
- end: MemorySnapshot
Returns MemoryDelta
- Defined in src/services/logging/performanceLogger.ts:216

`Private` `Static`categorizePerformance

categorizePerformance(durationMs: number): string
Categorize performance based on duration.
Parameters
- durationMs: number
Returns string
- Defined in src/services/logging/performanceLogger.ts:231

`Static`createTimer

createTimer(
operationName: string,
context?: Record<string, unknown>,
): PerformanceTimer
Create a performance timer that can be manually controlled. Useful for tracking operations that span multiple function calls.
Parameters
- operationName: string
  Human-readable name for the operation
- Optionalcontext: Record<string, unknown>
  Additional context information
Returns PerformanceTimer
PerformanceTimer instance
Example
```
const timer = PerformanceLogger.createTimer("multi_step_operation", { userId: "123" });
timer.start();
// ... do some work
timer.checkpoint("step_1_complete");
// ... do more work
timer.end("success");
```
- Defined in src/services/logging/performanceLogger.ts:193

`Private` `Static`formatBytes

formatBytes(bytes: number): string
Format bytes into human-readable format.
Parameters
- bytes: number
Returns string
- Defined in src/services/logging/performanceLogger.ts:247

`Private` `Static`getMemorySnapshot

getMemorySnapshot(): MemorySnapshot
Get current memory usage snapshot.

Returns MemorySnapshot
- Defined in src/services/logging/performanceLogger.ts:203

`Static`trackOperation

trackOperation<T>(
    operationName: string,
    operation: () => Promise<T>,
    context?: Record<string, unknown>,
): Promise<T>
Track operation performance with automatic logging and memory monitoring. Logs start, completion, and failure with detailed performance metrics.
Type Parameters
- T
Parameters
- operationName: string
  Human-readable name for the operation
- operation: () => Promise<T>
  Async function to execute and monitor
- Optionalcontext: Record<string, unknown>
  Additional context information
Returns Promise<T>
Promise that resolves with the operation result
Example
```
const result = await PerformanceLogger.trackOperation(
  "notebook_save",
  () => saveNotebook(notebook),
  { notebookId: notebook.id, cellCount: notebook.cells.length }
);
```
- Defined in src/services/logging/performanceLogger.ts:53

`Static`trackSync

trackSync<T>(
    operationName: string,
    operation: () => T,
    context?: Record<string, unknown>,
): T
Track synchronous operation performance. For operations that don't return promises but still need timing.
Type Parameters
- T
Parameters
- operationName: string
  Human-readable name for the operation
- operation: () => T
  Synchronous function to execute and monitor
- Optionalcontext: Record<string, unknown>
  Additional context information
Returns T
The operation result
- Defined in src/services/logging/performanceLogger.ts:124