Performance

Track response time trends, health grades, and spot regressions across sessions.

Health Grades

Brakit assigns a health grade to each endpoint based on its p95 response time. This gives you an at-a-glance view of which endpoints are performing well and which need attention.

Fast
< 100ms
Good
100–299ms
OK
300–799ms
Slow
800ms–2s
Critical
≥ 2s

P95 Response Times

For each endpoint, brakit tracks the 95th percentile response time. This means 95% of requests are faster than the displayed value, giving you a realistic view of how your endpoints perform under normal conditions, without outliers skewing the average.

Metrics Persistence

Performance metrics are automatically saved to .brakit/metrics.json in your project root. This means your performance data survives across brakit restarts, so you can track trends over time.

The metrics file is created automatically. You may want to add .brakit/ to your .gitignore to keep local metrics out of version control.

Slow Thresholds

Brakit uses two separate thresholds:

  • Slow requests: HTTP requests taking longer than 2 seconds are flagged
  • Slow queries: Database queries taking longer than 100ms are flagged (stricter, since individual queries should be fast)
  • Slow endpoints: Endpoints averaging over 1 second are surfaced in Overview insights

Performance Tab

The Performance tab in the dashboard shows:

  • Endpoint list: Every endpoint with its health grade and p95 time
  • Trend indicators: Whether an endpoint is getting faster or slower compared to previous sessions
  • Request count: Total number of requests per endpoint