Developer Guide: Monitoring & Error Handling

import { logger } from '@/platform/monitoring';

// Info-level log with context
logger.info('Employee created', {
  module: 'hr',
  action: 'employee_create',
});

// Error-level log with error object
logger.error('Failed to save document', error, {
  module: 'pf',
  action: 'document_save_error',
});

// Set persistent context (e.g., after login)
logger.setContext({
  user_id: session.user.id,
  org_id: organizationId,
  correlation_id: crypto.randomUUID(),
});

// Clear context on logout
logger.clearContext();

import { ErrorBoundary } from '@/platform/monitoring';

// Feature-level boundary (recommended for route modules)
<ErrorBoundary level="feature">
  <MyFeatureModule />
</ErrorBoundary>

// Component-level boundary (for non-critical widgets)
<ErrorBoundary level="component" fallback={<p>Widget unavailable</p>}>
  <OptionalWidget />
</ErrorBoundary>

import { performanceMonitor } from '@/platform/monitoring';

// Measure a specific operation
const markId = performanceMonitor.startMark('heavy-calculation');
// ... do work ...
performanceMonitor.endMark(markId);

import * as Sentry from '@sentry/react';

// Capture an exception with context
Sentry.captureException(error, {
  tags: { module: 'hr', action: 'payroll_calc' },
});

// Capture a message
Sentry.captureMessage('Unexpected state', 'warning');