Debugging Guide

Debugging is an essential part of development. Kaizen AI provides tools and logs to help pinpoint and resolve issues quickly.

Log Analysis

• Use logs/ directory or Docker stdout for system-wide logs

• Filter logs by service name or timestamp

• Enable debug mode via environment variable DEBUG=true

Error Codes

• 4xx: Authentication, rate limits, invalid queries

• 5xx: Internal errors or upstream failures

• Error responses include code, message, and traceId for debugging

Diagnostic Tools

• API Explorer: Test endpoints with live feedback

• DB Inspector: Validate schema integrity and data mapping

• Score Simulator: Replay past token events and score transitions

Performance Monitoring

• Integrated Prometheus/Grafana for real-time metrics

• Watch memory, CPU, and response times per endpoint

System Health Checks

• Internal /status endpoints for each service

• Cron-based heartbeat pings and uptime logs