All files / src/lib/observability index.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/**
 * Observability Module
 *
 * Comprehensive observability including:
 * - Distributed tracing with OpenTelemetry
 * - Metrics collection
 * - Structured logging
 * - Real User Monitoring (RUM)
 * - SLO tracking
 *
 * NOTE: OpenTelemetry setup (otel.ts) is server-only due to Node.js dependencies.
 * Import directly: import { initTelemetry } from '@/lib/observability/otel';
 *
 * NOTE: RUM is client-side only.
 * Import directly: import { initRUM } from '@/lib/observability/rum';
 */

// Tracing utilities
export {
  createSpan,
  createDbSpan,
  createHttpSpan,
  extractTraceContext,
  injectTraceContext,
  getCurrentTraceId,
  getCurrentSpanId,
  addSpanAttributes,
  addSpanEvent,
  recordException,
  withTracing,
  getTraceContextString,
} from './tracing';

// Metrics
export {
  // Counters
  httpRequestCounter,
  ordersCounter,
  cartAbandonmentCounter,
  userRegistrationCounter,
  loginCounter,
  productViewCounter,
  addToCartCounter,
  databaseErrorCounter,
  cacheHitCounter,
  cacheMissCounter,
  // Histograms
  httpRequestDuration,
  httpRequestSize,
  httpResponseSize,
  orderValueHistogram,
  databaseQueryDuration,
  cacheOperationDuration,
  externalApiDuration,
  // UpDownCounters
  activeConnections,
  websocketConnections,
  // Helper functions
  recordHttpRequest,
  recordDatabaseQuery,
  recordCacheOperation,
  recordExternalApiCall,
  recordOrder,
  recordLogin,
  recordProductView,
  recordAddToCart,
  recordCartAbandonment,
  incrementConnections,
  decrementConnections,
} from './metrics';

// Logging
export {
  logger,
  Logger,
  createRequestLogger,
  createOperationLogger,
} from './logger';
export type { LogContext } from './logger';

// SLO
export {
  calculateSLO,
  calculateAllSLOs,
  getSLOsByCategory,
  checkSLOsForAlerts,
  sloDefinitions,
  getSLOStatusColor,
  getSLOStatusText,
  formatWindow,
} from './slo';
export type { SLO, SLOResult } from './slo';

// Note: RUM is client-side only, import directly from './rum' in client components