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
Private
Get the configured logger instance. Returns a no-op logger if ServiceLoggers is not yet initialized.

Returns ILogger
Logger instance with trace, debug, info, warn, and error methods
- Defined in src/services/logging/performanceLogger.ts:27

Methods

`Private` `Static`calculateMemoryDelta

calculateMemoryDelta(start: MemorySnapshot, end: MemorySnapshot): MemoryDelta
Private
Calculate memory usage delta between two snapshots.
Parameters
- start: MemorySnapshot
  Starting memory snapshot
- end: MemorySnapshot
  Ending memory snapshot
Returns MemoryDelta
Memory delta with human-readable formatted values
- Defined in src/services/logging/performanceLogger.ts:231

`Private` `Static`categorizePerformance

categorizePerformance(durationMs: number): string
Private
Categorize performance based on duration in milliseconds.
Parameters
- durationMs: number
  Duration in milliseconds
Returns string
Performance category: 'fast', 'normal', 'slow', or 'very_slow'
- Defined in src/services/logging/performanceLogger.ts:250

`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:200

`Private` `Static`formatBytes

formatBytes(bytes: number): string
Private
Format bytes into human-readable format with sign and unit.
Parameters
- bytes: number
  Byte count to format
Returns string
Formatted string with sign ('+' or '-'), value, and unit (B, KB, MB, GB)
- Defined in src/services/logging/performanceLogger.ts:270

`Private` `Static`getMemorySnapshot

getMemorySnapshot(): MemorySnapshot
Private
Get current memory usage snapshot.

Returns MemorySnapshot
Current process memory usage snapshot
- Defined in src/services/logging/performanceLogger.ts:213

`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:60

`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:131