feat(dashboard): add structured logging and error filtering for Sentry (#4584)

* feat(dashboard): add structured logging and error filtering for Sentry

- Add structured logger module with specialized methods for tRPC and user action logging
- Create error classification utilities to categorize and map tRPC errors to appropriate log levels
- Implement Sentry error filters to prevent expected tRPC errors from being reported as incidents
- Add logging index module to export logging utilities and error classification functions
- Update Sentry client and server configurations to use new error filtering
- Update tRPC client configuration to integrate structured logging
- Update instrumentation client to apply error filtering on client-side Sentry initialization
- Provides consistent attribute naming and context tracking across all log entries
- Improves observability by distinguishing between expected errors and actual issues

* feat(dashboard): implement dynamic trace sampling across Sentry configs

- Replace static tracesSampleRate with dynamic tracesSampler in client, edge, and server Sentry configurations
- Prioritize 100% sampling for error-prone operations (auth, payment, api/key, tRPC, HTTP 4xx/5xx)
- Reduce sampling to 1% for health checks and monitoring endpoints (healthcheck, health, ping, metrics)
- Eliminate sampling (0%) for static assets (_next/static, favicon, robots.txt, sitemap)
- Set default 10% sampling rate for general operations to reduce noise while maintaining observability
- Add null-safety check for transaction names with 10% fallback sampling
- Reduces Sentry quota usage while ensuring critical errors and operations are fully captured

* Make a reusable trace-sampler

Author: perkinsjr

web/apps/dashboard/instrumentation-client.ts

@@ -3,10 +3,14 @@
 // https://docs.sentry.io/platforms/javascript/guides/nextjs/
 
 import * as Sentry from "@sentry/nextjs";
+import { createClientErrorFilter, createTracesSampler } from "./lib/sentry";
 
 Sentry.init({
   dsn: "https://08589d17fe3b4b7e8b70b6c916123ee5@o4510544758046720.ingest.us.sentry.io/4510544758308864",
 
+  // Filter expected tRPC errors from being reported as Sentry errors
+  beforeSend: createClientErrorFilter(),
+
   // Add optional integrations for additional features
   integrations: [
     Sentry.replayIntegration({
@@ -42,8 +46,8 @@ Sentry.init({
     }),
   ],
 
-  // Define how likely traces are sampled. Adjust this value in production, or use tracesSampler for greater control.
-  tracesSampleRate: 1,
+  // Use dynamic sampling to reduce non-error traces while ensuring all errors are captured
+  tracesSampler: createTracesSampler(),
   // Enable logs to be sent to Sentry
   enableLogs: true,
 

web/apps/dashboard/lib/logging/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Logging module exports
+ *
+ * Provides structured logging capabilities for the dashboard application
+ * with consistent attribute naming and Sentry integration.
+ */
+
+export {
+  logTRPCError,
+  logUserAction,
+  logOperation,
+  type BaseLogAttributes,
+  type TRPCLogAttributes,
+  type UserActionAttributes,
+  type LogAttributes,
+  type LogContext,
+  type LogLevel,
+} from "./structured-logger";
+
+// Re-export error classification utilities for convenience
+export {
+  isExpectedTRPCError,
+  extractTRPCErrorInfo,
+  getErrorLogLevel,
+  classifyError,
+  type TRPCErrorInfo,
+  type ErrorClassification,
+} from "../utils/error-classification";