phil/StarPunk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

0 Releases 48 Tags

RSS Feed
  • v1.1.2-rc.2 1e2135a49a
    Compare

    StarPunk v1.1.2-rc.2 - Production Hotfix Release Candidate

    phil released this 2025-11-28 17:48:11 +01:00 | 50 commits to main since this release

    This release candidate fixes two critical production issues discovered in v1.1.2-rc.1:

    • Problem: All static files (CSS, JS, images) returned 500 errors, making site unusable

    • Root Cause: HTTP monitoring middleware accessed response.data on streaming responses

    • Solution: Added direct_passthrough check before accessing response data

    • Impact: Site now fully functional with all assets loading correctly

    • Problem: Admin dashboard showed 0 for all database metrics despite active queries

    • Root Cause: Configuration key mismatch (METRICS_SAMPLING_RATE vs METRICS_SAMPLING_RATES)
      caused fallback to 10% sampling, combined with low traffic resulted in zero captured metrics

    • Solution:

      • Standardized on singular config key (METRICS_SAMPLING_RATE)
      • Modified MetricsBuffer to accept both float and dict for flexibility
      • Changed default sampling from 10% to 100% for better visibility on low-traffic sites

    • Impact: Database metrics now display immediately and accurately

    • Default metrics sampling rate: 10% → 100% (better for low-traffic deployments)

    • HTTP middleware now handles both buffered and streaming responses correctly

    • MetricsBuffer accepts flexible sampling configuration (float or dict)

    • Modified Files:

      • starpunk/monitoring/http.py - Streaming response handling
      • starpunk/monitoring/metrics.py - Config key fix + flexible sampling
      • starpunk/init.py - Version bump
      • CHANGELOG.md - Release notes

    • Documentation:

      • Investigation: docs/reports/2025-11-28-v1.1.2-rc.1-production-issues.md
      • Review: docs/reviews/2025-11-28-v1.1.2-rc.1-architect-review.md
      • Implementation: docs/reports/2025-11-28-v1.1.2-rc.2-fixes.md

    • Testing: All monitoring tests pass (28/28), no regressions

    • Safe to deploy immediately (fixes critical production issues)

    • No database migrations required

    • Backwards compatible

    • Monitor for 24 hours before promoting to stable v1.1.2

    Deploy to production and verify:

    1. Static files load without 500 errors (especially /static/css/style.css)
    2. Database metrics show non-zero values in admin dashboard
    3. Site functionality fully restored

    🤖 Generated with Claude Code

    Downloads