mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-03-20 09:23:07 +00:00
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>
This commit is contained in:
87
src/telemetry/telemetry-types.ts
Normal file
87
src/telemetry/telemetry-types.ts
Normal file
@@ -0,0 +1,87 @@
|
||||
/**
|
||||
* 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;
|
||||
}
|
||||
Reference in New Issue
Block a user