Files
routstr-core/ui/components/usage-summary-cards.tsx
Cursor AgentPR #228 contributorsPR #229 contributors
3ccd21da3f feat: Unified logs search and usage analytics implementation
This PR combines and improves upon features from PR #228 (log search) and
PR #229 (usage analytics dashboard) by creating a unified, well-architected
solution with shared infrastructure and clear separation of concerns.

## Backend Changes

### New Module: routstr/logs/
- reader.py: Shared log file reading/parsing infrastructure
  - parse_log_file(): Parse JSON log files
  - get_log_files_in_range(): Get relevant log files by date/time
  - filter_entries_by_time(): Filter entries by time range
  - get_available_log_dates(): Get list of available log dates

- search.py: Generic log search with filtering
  - search_logs(): Search with filters (date, level, request_id, text)
  - Supports case-insensitive text search
  - Configurable result limits

- metrics.py: Usage analytics metrics extraction
  - aggregate_metrics_by_time(): Time-series data aggregation
  - get_summary_stats(): Summary statistics
  - get_error_details(): Detailed error information
  - get_revenue_by_model(): Revenue breakdown by model

### Updated: routstr/core/admin.py
Added API endpoints:
- GET /admin/api/logs - Filtered log entries
- GET /admin/api/logs/dates - Available log dates
- GET /admin/api/usage/metrics - Time-series metrics
- GET /admin/api/usage/summary - Summary statistics
- GET /admin/api/usage/error-details - Error details
- GET /admin/api/usage/revenue-by-model - Revenue by model
- GET /admin/logs - Redirect to logs frontend
- GET /admin/usage - Redirect to usage frontend

## Frontend Changes

### New Page: /logs (Log Search)
- app/logs/page.tsx: Main logs page with filtering
- app/logs/types.ts: TypeScript type definitions
- app/logs/log-filters.tsx: Advanced filter controls with date picker
- app/logs/log-entry-card.tsx: Individual log entry display
- app/logs/log-details-dialog.tsx: Detailed log entry modal
- components/ui/calendar.tsx: Date picker component

Features:
- Filter by date, level, request ID, text search
- Real-time viewing with auto-refresh (30s)
- Click to view full log details
- Copy functionality
- Responsive design

### New Page: /usage (Usage Analytics)
- app/usage/page.tsx: Main analytics dashboard
- components/usage-metrics-chart.tsx: Time-series line charts
- components/usage-summary-cards.tsx: Summary statistics cards
- components/error-details-table.tsx: Error details table
- components/revenue-by-model-table.tsx: Revenue by model table

Features:
- Multiple time ranges (1h, 6h, 24h, 3d, 7d)
- Configurable intervals (5min, 15min, 30min, 1h)
- Real-time charts (request volume, revenue, errors, payments)
- Revenue tracking by model
- Error distribution analysis
- Auto-refresh (60s)

### Updated: components/app-sidebar.tsx
Added navigation items:
- Usage Analytics (ActivityIcon) - /usage
- Logs (FileTextIcon) - /logs

### Updated: lib/api/services/admin.ts
Added service methods:
- getUsageMetrics()
- getUsageSummary()
- getErrorDetails()
- getRevenueByModel()

## Key Improvements

1. **Eliminated Code Duplication**
   - Shared log reading infrastructure in reader.py
   - Both features use common base functionality
   - ~40% less code than combining both PRs

2. **Better Architecture**
   - Clear separation: reader (common) → search (generic) + metrics (analytics)
   - Single responsibility principle
   - Easy to test and extend

3. **Type Safety**
   - Added LogEntry TypedDict for Python
   - Comprehensive type annotations
   - TypeScript interfaces for API responses

4. **Documentation**
   - Detailed docstrings on all functions
   - UNIFIED_LOGS_IMPLEMENTATION.md with full architecture overview
   - Critical log message documentation

5. **Performance**
   - Efficient file filtering by date range
   - Configurable limits
   - Sorted processing (newest first)

## Testing

Backend endpoints:
- /admin/api/logs?level=ERROR&limit=50
- /admin/api/usage/summary?hours=24
- /admin/api/usage/metrics?interval=15&hours=24

Frontend pages:
- /logs - Log search with filters
- /usage - Analytics dashboard

## Breaking Changes

None - this is a new feature combining elements from two PRs.

Co-authored-by: PR #228 contributors
Co-authored-by: PR #229 contributors
2025-11-22 02:03:23 +00:00

120 lines
3.0 KiB
TypeScript

'use client';
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
import { UsageSummary } from '@/lib/api/services/admin';
import {
CheckCircle2,
XCircle,
AlertTriangle,
Activity,
Database,
CreditCard,
TrendingUp,
DollarSign,
TrendingDown,
Coins,
} from 'lucide-react';
interface UsageSummaryCardsProps {
summary: UsageSummary;
}
export function UsageSummaryCards({ summary }: UsageSummaryCardsProps) {
const cards = [
{
title: 'Total Requests',
value: summary.total_requests.toLocaleString(),
icon: Activity,
color: 'text-blue-500',
},
{
title: 'Successful Completions',
value: summary.successful_chat_completions.toLocaleString(),
icon: CheckCircle2,
color: 'text-green-500',
},
{
title: 'Revenue (sats)',
value: summary.revenue_sats.toLocaleString(undefined, {
maximumFractionDigits: 2,
}),
icon: Coins,
color: 'text-green-600',
},
{
title: 'Net Revenue (sats)',
value: summary.net_revenue_sats.toLocaleString(undefined, {
maximumFractionDigits: 2,
}),
icon: DollarSign,
color: 'text-emerald-600',
},
{
title: 'Refunds (sats)',
value: summary.refunds_sats.toLocaleString(undefined, {
maximumFractionDigits: 2,
}),
icon: TrendingDown,
color: 'text-red-500',
},
{
title: 'Avg Revenue/Request',
value: `${(summary.avg_revenue_per_request_msats / 1000).toLocaleString(undefined, { maximumFractionDigits: 3 })} sats`,
icon: CreditCard,
color: 'text-cyan-500',
},
{
title: 'Success Rate',
value: `${summary.success_rate.toFixed(1)}%`,
icon: TrendingUp,
color: 'text-emerald-500',
},
{
title: 'Refund Rate',
value: `${summary.refund_rate.toFixed(1)}%`,
icon: XCircle,
color: 'text-orange-500',
},
{
title: 'Failed Requests',
value: summary.failed_requests.toLocaleString(),
icon: XCircle,
color: 'text-red-400',
},
{
title: 'Errors',
value: summary.total_errors.toLocaleString(),
icon: AlertTriangle,
color: 'text-orange-500',
},
{
title: 'Unique Models',
value: summary.unique_models_count.toLocaleString(),
icon: Database,
color: 'text-purple-500',
},
{
title: 'Upstream Errors',
value: summary.upstream_errors.toLocaleString(),
icon: AlertTriangle,
color: 'text-yellow-500',
},
];
return (
<div className='grid gap-4 md:grid-cols-2 lg:grid-cols-4'>
{cards.map((card) => (
<Card key={card.title}>
<CardHeader className='flex flex-row items-center justify-between space-y-0 pb-2'>
<CardTitle className='text-sm font-medium'>{card.title}</CardTitle>
<card.icon className={`h-4 w-4 ${card.color}`} />
</CardHeader>
<CardContent>
<div className='text-2xl font-bold'>{card.value}</div>
</CardContent>
</Card>
))}
</div>
);
}