Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

feat(errors): add ErrorLog model with fingerprint dedup fields and migration

Juan Denise401f382c321
diff --git a/backend/app/models/__init__.py b/backend/app/models/__init__.py
index 36e13567..ef78f06a 100644
--- a/backend/app/models/__init__.py
+++ b/backend/app/models/__init__.py
@@ -15,6 +15,7 @@ from app.models.deployment_job import DeploymentJob, DeploymentJobLog
from app.models.linked_panel import LinkedPanelConfig
from app.models.system_settings import SystemSettings
from app.models.audit_log import AuditLog
+from app.models.error_log import ErrorLog
from app.models.metrics_history import MetricsHistory
from app.models.workflow import Workflow, WorkflowExecution, WorkflowLog
from app.models.webhook import GitWebhook, WebhookLog, GitDeployment
@@ -87,6 +88,7 @@ __all__ = [
'User', 'Application', 'Domain', 'EnvironmentVariable', 'EnvironmentVariableHistory',
'NotificationPreferences', 'Deployment', 'DeploymentDiff', 'DeploymentSnapshot', 'DeploymentJob', 'DeploymentJobLog', 'SystemSettings', 'AuditLog',
'MetricsHistory', 'Workflow', 'WorkflowExecution', 'WorkflowLog', 'GitWebhook', 'WebhookLog', 'GitDeployment',
+ 'ErrorLog',
'Server', 'ServerGroup', 'ServerMetrics', 'ServerCommand', 'AgentSession', 'AgentVersion', 'AgentRollout', 'ServerOnboardingLog', 'SecurityAlert',
'WordPressSite', 'DatabaseSnapshot', 'SyncJob', 'WordPressVulnerability',
'WordPressCustomPlugin', 'WordPressSitePlugin',
diff --git a/backend/app/models/error_log.py b/backend/app/models/error_log.py
new file mode 100644
index 00000000..caa741dc
--- /dev/null
+++ b/backend/app/models/error_log.py
@@ -0,0 +1,66 @@
+from datetime import datetime
+from app import db
+import json
+
+
+class ErrorLog(db.Model):
+ """Centralized error log with fingerprint-based dedup."""
+ __tablename__ = 'error_logs'
+
+ id = db.Column(db.Integer, primary_key=True)
+ fingerprint = db.Column(db.String(64), nullable=False, index=True) # sha256 hex
+ source = db.Column(db.String(20), nullable=False, index=True) # backend | frontend
+ level = db.Column(db.String(20), nullable=False, default='error')
+ exception_type = db.Column(db.String(200), nullable=True)
+ message = db.Column(db.Text, nullable=False)
+ traceback = db.Column(db.Text, nullable=True)
+ endpoint = db.Column(db.String(255), nullable=True) # API path / page URL
+ method = db.Column(db.String(10), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ context_json = db.Column(db.Text, nullable=True) # JSON string
+ count = db.Column(db.Integer, nullable=False, default=1) # dedup hit counter
+ first_seen = db.Column(db.DateTime, default=datetime.utcnow)
+ last_seen = db.Column(db.DateTime, default=datetime.utcnow, index=True)
+ resolved = db.Column(db.Boolean, default=False, index=True)
+
+ # Relationship to user
+ user = db.relationship('User', foreign_keys=[user_id])
+
+ def get_context(self):
+ """Return parsed context JSON."""
+ if self.context_json:
+ try:
+ return json.loads(self.context_json)
+ except (json.JSONDecodeError, TypeError):
+ return {}
+ return {}
+
+ def set_context(self, context_dict):
+ """Set context from a dictionary."""
+ if context_dict:
+ self.context_json = json.dumps(context_dict)
+ else:
+ self.context_json = None
+
+ def to_dict(self):
+ return {
+ 'id': self.id,
+ 'fingerprint': self.fingerprint,
+ 'source': self.source,
+ 'level': self.level,
+ 'exception_type': self.exception_type,
+ 'message': self.message,
+ 'traceback': self.traceback,
+ 'endpoint': self.endpoint,
+ 'method': self.method,
+ 'user_id': self.user_id,
+ 'username': self.user.username if self.user else None,
+ 'context': self.get_context(),
+ 'count': self.count,
+ 'first_seen': self.first_seen.isoformat() if self.first_seen else None,
+ 'last_seen': self.last_seen.isoformat() if self.last_seen else None,
+ 'resolved': self.resolved,
+ }
+
+ def __repr__(self):
+ return f'<ErrorLog {self.source}:{self.exception_type} x{self.count}>'
diff --git a/backend/migrations/versions/085_error_logs.py b/backend/migrations/versions/085_error_logs.py
new file mode 100644
index 00000000..dd6b8e54
--- /dev/null
+++ b/backend/migrations/versions/085_error_logs.py
@@ -0,0 +1,62 @@
+"""Centralized error log tracking: new `error_logs` table.
+
+Fingerprint-deduped store for unhandled backend exceptions (500 handler) and
+frontend-reported client errors. Indexes match the access patterns: dedup
+lookup by fingerprint, admin list filtering by source/resolved, ordering by
+last_seen.
+
+Revision ID: 085_error_logs
+Revises: 084_soft_delete_applications
+"""
+import sqlalchemy as sa
+from alembic import op
+
+revision = '085_error_logs'
+down_revision = '084_soft_delete_applications'
+branch_labels = None
+depends_on = None
+
+
+def _has_table(name):
+ bind = op.get_bind()
+ return name in sa.inspect(bind).get_table_names()
+
+
+def upgrade():
+ if _has_table('error_logs'):
+ return
+ op.create_table(
+ 'error_logs',
+ sa.Column('id', sa.Integer(), primary_key=True),
+ sa.Column('fingerprint', sa.String(length=64), nullable=False),
+ sa.Column('source', sa.String(length=20), nullable=False),
+ sa.Column('level', sa.String(length=20), nullable=False),
+ sa.Column('exception_type', sa.String(length=200), nullable=True),
+ sa.Column('message', sa.Text(), nullable=False),
+ sa.Column('traceback', sa.Text(), nullable=True),
+ sa.Column('endpoint', sa.String(length=255), nullable=True),
+ sa.Column('method', sa.String(length=10), nullable=True),
+ sa.Column('user_id', sa.Integer(), nullable=True),
+ sa.Column('context_json', sa.Text(), nullable=True),
+ sa.Column('count', sa.Integer(), nullable=False),
+ sa.Column('first_seen', sa.DateTime(), nullable=True),
+ sa.Column('last_seen', sa.DateTime(), nullable=True),
+ sa.Column('resolved', sa.Boolean(), nullable=True),
+ sa.ForeignKeyConstraint(['user_id'], ['users.id']),
+ )
+ op.create_index('ix_error_logs_fingerprint', 'error_logs', ['fingerprint'])
+ op.create_index('ix_error_logs_source', 'error_logs', ['source'])
+ op.create_index('ix_error_logs_last_seen', 'error_logs', ['last_seen'])
+ op.create_index('ix_error_logs_resolved', 'error_logs', ['resolved'])
+
+
+def downgrade():
+ if not _has_table('error_logs'):
+ return
+ for name in ('ix_error_logs_resolved', 'ix_error_logs_last_seen',
+ 'ix_error_logs_source', 'ix_error_logs_fingerprint'):
+ try:
+ op.drop_index(name, table_name='error_logs')
+ except Exception: # noqa: BLE001
+ pass
+ op.drop_table('error_logs')