_private/qwestly-docs/Engineering/Monitoring/index.md

Monitoring System Overview

The Qwestly Monitoring System provides comprehensive real-time visibility into our internal systems, log shipping operations, and operational health metrics.

System Architecture

graph TB A[Qwestly Status Dashboard] -->|HTTPS| B[Monitoring API] B -->|System Metrics| C[psutil Library] B -->|Log Shipping| D[AWS S3] B -->|Health Checks| E[Environment Validation] F[Operations Team] -->|Monitor| A G[Alert Systems] -->|Query| B H[CI/CD Pipeline] -->|Deploy| I[Vercel Infrastructure] I -->|Hosts| A I -->|Hosts| B

Components

Status Dashboard

React-based real-time dashboard for operations team monitoring

Monitoring API

FastAPI backend providing system health and log shipping endpoints

Log Shipping

Automated daily log collection and storage system

Deployment

Production deployment and configuration guide

Key Features

  • Real-time System Health: CPU, memory, and disk monitoring
  • Log Shipping Management: Daily log collection with manual triggers
  • Operational Insights: Environment validation and deployment tracking
  • Responsive Design: Mobile-friendly dashboard for on-call monitoring
  • Auto-refresh: Live updates every 30-60 seconds
  • Error Handling: Graceful degradation and recovery

Getting Started

For development setup and deployment instructions, see the individual component documentation linked above.

Support

For issues or questions about the monitoring system:

  1. Check the component-specific documentation
  2. Contact the engineering team via Slack