Skip to content

Operations Guide

Guide for deploying, monitoring, and maintaining the Fleet Decision Platform.

Overview

This guide covers:

  • Deployment - How to deploy the platform
  • Monitoring - Observability and alerting
  • Troubleshooting - Common issues and solutions

Quick Reference

Health Check

curl http://localhost:8000/health

View Logs

# Follow application logs
tail -f logs/fleet_cascade.log

# Filter error logs
grep "ERROR" logs/fleet_cascade.log

Restart Services

# Restart API server
make restart

# Restart with clean state
make clean-restart

Environment Checklist

Development

  • Python 3.9+ installed
  • uv package manager
  • Pre-commit hooks installed
  • Local configuration (.env)

Staging

  • Docker/containers set up
  • PostgreSQL database
  • Redis cache (optional)
  • Environment variables configured

Production

  • Load balancer configured
  • SSL/TLS certificates
  • Database backups
  • Monitoring and alerting
  • Log aggregation
  • Auto-scaling (optional)

System Requirements

Minimum (Development)

Component Requirement
CPU 2 cores
RAM 4 GB
Storage 10 GB
Component Requirement
CPU 8+ cores
RAM 16+ GB
Storage 100+ GB SSD
Network 1 Gbps

Next Steps