Files
n8n-mcp/src/telemetry/telemetry-types.ts
czlonkowski e14c647b7d fix: refactor telemetry system with critical improvements (v2.14.1)
Major improvements to telemetry system addressing code review findings:

Architecture & Modularization:
- Split 636-line TelemetryManager into 7 focused modules
- Separated concerns: event tracking, batch processing, validation, rate limiting
- Lazy initialization pattern to avoid early singleton creation
- Clean separation of responsibilities

Security & Privacy:
- Added comprehensive input validation with Zod schemas
- Sanitization of sensitive data (URLs, API keys, emails)
- Expanded sensitive key detection patterns (25+ patterns)
- Row Level Security on Supabase backend
- Added data deletion contact info (romuald@n8n-mcp.com)

Performance & Reliability:
- Sliding window rate limiter (100 events/minute)
- Circuit breaker pattern for network failures
- Dead letter queue for failed events
- Exponential backoff with jitter for retries
- Performance monitoring with overhead tracking (<5%)
- Memory-safe array limits in rate limiter

Testing:
- Comprehensive test coverage (87%+ for core modules)
- Unit tests for all new modules
- Integration tests for MCP telemetry
- Fixed test isolation issues

Data Management:
- Clear user consent in welcome message
- Batch processing with deduplication
- Automatic workflow flushing

BREAKING CHANGE: TelemetryManager constructor is now private, use getInstance()

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-26 16:10:54 +02:00

87 lines
2.3 KiB
TypeScript

/**
* Telemetry Types and Interfaces
* Centralized type definitions for the telemetry system
*/
export interface TelemetryEvent {
user_id: string;
event: string;
properties: Record<string, any>;
created_at?: string;
}
export interface WorkflowTelemetry {
user_id: string;
workflow_hash: string;
node_count: number;
node_types: string[];
has_trigger: boolean;
has_webhook: boolean;
complexity: 'simple' | 'medium' | 'complex';
sanitized_workflow: any;
created_at?: string;
}
export interface SanitizedWorkflow {
nodes: any[];
connections: any;
nodeCount: number;
nodeTypes: string[];
hasTrigger: boolean;
hasWebhook: boolean;
complexity: 'simple' | 'medium' | 'complex';
workflowHash: string;
}
export const TELEMETRY_CONFIG = {
// Batch processing
BATCH_FLUSH_INTERVAL: 5000, // 5 seconds
EVENT_QUEUE_THRESHOLD: 10, // Batch events for efficiency
WORKFLOW_QUEUE_THRESHOLD: 5, // Batch workflows
// Retry logic
MAX_RETRIES: 3,
RETRY_DELAY: 1000, // 1 second base delay
OPERATION_TIMEOUT: 5000, // 5 seconds
// Rate limiting
RATE_LIMIT_WINDOW: 60000, // 1 minute
RATE_LIMIT_MAX_EVENTS: 100, // Max events per window
// Queue limits
MAX_QUEUE_SIZE: 1000, // Maximum events to queue
MAX_BATCH_SIZE: 50, // Maximum events per batch
} as const;
export const TELEMETRY_BACKEND = {
URL: 'https://ydyufsohxdfpopqbubwk.supabase.co',
ANON_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InlkeXVmc29oeGRmcG9wcWJ1YndrIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTg3OTYyMDAsImV4cCI6MjA3NDM3MjIwMH0.xESphg6h5ozaDsm4Vla3QnDJGc6Nc_cpfoqTHRynkCk'
} as const;
export interface TelemetryMetrics {
eventsTracked: number;
eventsDropped: number;
eventsFailed: number;
batchesSent: number;
batchesFailed: number;
averageFlushTime: number;
lastFlushTime?: number;
rateLimitHits: number;
}
export enum TelemetryErrorType {
VALIDATION_ERROR = 'VALIDATION_ERROR',
NETWORK_ERROR = 'NETWORK_ERROR',
RATE_LIMIT_ERROR = 'RATE_LIMIT_ERROR',
QUEUE_OVERFLOW_ERROR = 'QUEUE_OVERFLOW_ERROR',
INITIALIZATION_ERROR = 'INITIALIZATION_ERROR',
UNKNOWN_ERROR = 'UNKNOWN_ERROR'
}
export interface TelemetryErrorContext {
type: TelemetryErrorType;
message: string;
context?: Record<string, any>;
timestamp: number;
retryable: boolean;
}