Function initPostHogErrorTracking

server/src/utils/posthog.ts:140–210

()

 * @returns true if PostHog error tracking was enabled, false if POSTHOG_API_KEY is not set
 */
export function initPostHogErrorTracking(): boolean {
  if (!POSTHOG_API_KEY) {
    return false;
  }

  // Ensure client is initialized
  getPostHog();

  // Set up the error hook in the logger
  setErrorHook((message, error, context, level) => {
    const client = getPostHog();
    if (!client) return;

    const now = Date.now();

    // Rate limit: skip if too soon after last error
    if (now - lastErrorTime < ERROR_RATE_LIMIT_MS) {
      return;
    }

    // Dedupe: skip if same error message within window
    const errorKey = `${message}:${error?.name || 'Error'}`;
    const lastSeen = recentErrors.get(errorKey);
    if (lastSeen && now - lastSeen < ERROR_DEDUP_WINDOW_MS) {
      return;
    }

    lastErrorTime = now;
    recentErrors.set(errorKey, now);

    // Clean up old entries periodically
    if (recentErrors.size > 100) {
      const cutoff = now - ERROR_DEDUP_WINDOW_MS;
      for (const [key, time] of recentErrors) {
        if (time < cutoff) recentErrors.delete(key);
      }
    }

    // Extract module from context if available (set by createLogger)
    const module = (context?.module as string) || 'unknown';

    client.capture({
      distinctId: 'server-logs',
      event: '$exception',
      properties: {
        $exception_message: message,
        $exception_type: error?.name || 'Error',
        $exception_stack_trace_raw: error?.stack,
        // Include context for debugging
        module,
        ...context,
        $lib: 'posthog-node',
        source: 'server-logger',
      },
    });

    // Fatal-level errors get an immediate Slack notification to ops channel.
    if (level && level >= 60) {