Class TelemetryManager

Singleton manager for telemetry tracking and analysis.

Provides:

  • Event recording for various operation types with strongly-typed parameters
  • Pattern detection for identifying optimization opportunities
  • Pluggable analyzer system for custom rules
  • Integration with WarningManager for console output

Hierarchy (view full)

Constructors

constructor

Properties

_activeEvents _analyzers _events _insightDedupeWindow _insights _patterns _settings

Accessors

GlobalKey IsEnabled Settings Instance

Methods

Clear ClearInsights ClearPatterns EndEvent GetActiveEvents GetAnalyzers GetDuplicates GetEvents GetGlobalObjectStore GetInsights GetLevelForCategory GetLevelValue GetPatterns GetStats IsCategoryEnabled RecordEvent RegisterAnalyzer Reset SetEnabled StartEvent UnregisterAnalyzer UpdateSettings buildAnalyzerContext captureMemory captureStackTrace cleanStackTrace emitInsightWarning extractCallerLocation generateAIFingerprint generateCacheFingerprint generateEngineFingerprint generateFingerprint generateId generateNetworkFingerprint generateRunQueryFingerprint generateRunViewFingerprint getTimestamp loadSettings recordTelemetryInsightToWarningManager registerBuiltInAnalyzers runAnalyzers saveSettings shouldEmitInsight simpleHash trimIfNeeded updatePattern getInstance

Constructors

Protected constructor

Properties

Private _activeEvents

_activeEvents: Map<string, TelemetryEvent<TelemetryParamsUnion>> = ...

Private _analyzers

_analyzers: TelemetryAnalyzer[] = []

Private _events

_events: TelemetryEvent<TelemetryParamsUnion>[] = []

Private _insightDedupeWindow

_insightDedupeWindow: Map<string, number> = ...

Private _insights

_insights: TelemetryInsight[] = []

Private _patterns

_patterns: Map<string, TelemetryPattern> = ...

Private _settings

_settings: TelemetrySettings

Accessors

GlobalKey

  • get GlobalKey(): string

  • Returns string

IsEnabled

Settings

Static Instance

Methods

Clear

ClearInsights

ClearPatterns

EndEvent

GetActiveEvents

GetAnalyzers

GetDuplicates

GetEvents

GetGlobalObjectStore

  • GetGlobalObjectStore(): typeof globalThis

  • The Global Object Store is a place to store global objects that need to be shared across the application. Depending on the execution environment, this could be the window object in a browser, or the global object in a node environment, or something else in other contexts. The key here is that in some cases static variables are not truly shared because it is possible that a given class might have copies of its code in multiple paths in a deployed application. This approach ensures that no matter how many code copies might exist, there is only one instance of the object in question by using the Global Object Store.

    Returns typeof globalThis

GetInsights

GetLevelForCategory

GetLevelValue

GetPatterns

GetStats

  • GetStats(): {
        activeEvents: number;
        byCategory: Record<TelemetryCategory, {
            avgMs: number;
            events: number;
        }>;
        totalEvents: number;
        totalInsights: number;
        totalPatterns: number;
    }

  • Get summary statistics

    Returns {
        activeEvents: number;
        byCategory: Record<TelemetryCategory, {
            avgMs: number;
            events: number;
        }>;
        totalEvents: number;
        totalInsights: number;
        totalPatterns: number;
    }

    • activeEvents: number
    • byCategory: Record<TelemetryCategory, {
          avgMs: number;
          events: number;
      }>
    • totalEvents: number
    • totalInsights: number
    • totalPatterns: number

IsCategoryEnabled

RecordEvent

RegisterAnalyzer

Reset

SetEnabled

StartEvent

UnregisterAnalyzer

UpdateSettings

Private buildAnalyzerContext

Private captureMemory

Private captureStackTrace

Private cleanStackTrace

Private emitInsightWarning

Private extractCallerLocation

Private generateAIFingerprint

Private generateCacheFingerprint

Private generateEngineFingerprint

Private generateFingerprint

Private generateId

Private generateNetworkFingerprint

Private generateRunQueryFingerprint

Private generateRunViewFingerprint

Private getTimestamp

Private loadSettings

Private recordTelemetryInsightToWarningManager

Private registerBuiltInAnalyzers

Private runAnalyzers

Private saveSettings

Private shouldEmitInsight

Private simpleHash

  • simpleHash(str): string

  • Simple hash function for creating short fingerprints from long strings. Not cryptographic, just for deduplication purposes.

    Parameters

    • str: string

    Returns string

Private trimIfNeeded

Private updatePattern

Protected Static getInstance

  • getInstance<T>(this, className?): T

  • Returns the singleton instance of the class. If the instance does not exist, it is created and stored in the Global Object Store. If className is provided it will be used as part of the key in the Global Object Store, otherwise the actual class name will be used. NOTE: the class name used by default is the lowest level of the object hierarchy, so if you have a class that extends another class, the lowest level class name will be used.

    Type Parameters

    Parameters

    • this: (new () => T)
        • new (): T

        • Returns T

    • Optional className: string

    Returns T

Settings

Member Visibility

Theme

On This Page

constructor_activeEvents_analyzers_events_insightDedupeWindow_insights_patterns_settingsGlobalKeyIsEnabledSettingsInstanceClearClearInsightsClearPatternsEndEventGetActiveEventsGetAnalyzersGetDuplicatesGetEventsGetGlobalObjectStoreGetInsightsGetLevelForCategoryGetLevelValueGetPatternsGetStatsIsCategoryEnabledRecordEventRegisterAnalyzerResetSetEnabledStartEventUnregisterAnalyzerUpdateSettingsbuildAnalyzerContextcaptureMemorycaptureStackTracecleanStackTraceemitInsightWarningextractCallerLocationgenerateAIFingerprintgenerateCacheFingerprintgenerateEngineFingerprintgenerateFingerprintgenerateIdgenerateNetworkFingerprintgenerateRunQueryFingerprintgenerateRunViewFingerprintgetTimestamploadSettingsrecordTelemetryInsightToWarningManagerregisterBuiltInAnalyzersrunAnalyzerssaveSettingsshouldEmitInsightsimpleHashtrimIfNeededupdatePatterngetInstance