Usage Monitoring
Track and analyze your organization's Girard usage
This guide covers how to monitor, analyze, and optimize your organization's usage of Girard resources.
Usage Dashboard
Accessing Usage Data
Navigate to Dashboard > Usage to see:
- Current period overview
- Credit consumption breakdown
- Feature usage statistics
- Team member activity
- Historical trends
Dashboard Sections
┌─────────────────────────────────────────────────────────┐
│ Credits Used This Period │
│ ████████████░░░░░░░░░░░░ 456 / 500 (91%) │
├─────────────────────────────────────────────────────────┤
│ Usage by Feature │ Usage by Day │
│ ───────────────── │ ─────────────── │
│ Images: 280 (61%) │ [Bar chart] │
│ Chat: 120 (26%) │ │
│ Voice: 56 (12%) │ │
├─────────────────────────────────────────────────────────┤
│ Top Users │ Recent Activity │
│ ────────── │ ──────────────── │
│ 1. john@co.com - 180 │ Image generated (2m ago) │
│ 2. jane@co.com - 156 │ Chat message (5m ago) │
│ 3. bob@co.com - 120 │ Voice TTS (10m ago) │
└─────────────────────────────────────────────────────────┘
Credit Tracking
Current Period
View real-time credit status:
| Metric | Description |
|---|---|
| Used | Credits consumed this period |
| Remaining | Credits available |
| Bonus | Purchased credits available |
| Reset Date | When credits refresh |
Credit Consumption Rate
Track daily averages:
Daily Average: 15 credits
Days Remaining: 20
Projected Usage: 300 credits
Status: On track ✅
Low Credit Alerts
Configure alerts at Settings > Billing > Alerts:
| Alert Type | Trigger |
|---|---|
| Warning | 80% consumed |
| Critical | 95% consumed |
| Depleted | 100% consumed |
Feature Analytics
Generation Statistics
Image Generation
| Metric | Description |
|---|---|
| Total Generations | Number of images created |
| Credits Used | Total credits for images |
| Avg per Day | Daily generation rate |
| By Quality | Standard/High/Ultra split |
| By Model | Usage per AI model |
| By Aspect Ratio | Popular dimensions |
Video Generation
| Metric | Description |
|---|---|
| Total Videos | Number of videos created |
| Total Duration | Combined video length |
| Credits Used | Total credits for video |
| Avg Duration | Average video length |
| By Model | Usage per model |
Music Generation
| Metric | Description |
|---|---|
| Total Tracks | Number of tracks created |
| Total Duration | Combined audio length |
| Credits Used | Total credits for music |
| Avg Duration | Average track length |
Chat & Agent Statistics
| Metric | Description |
|---|---|
| Total Messages | All chat messages |
| By Model | Gemini Flash vs Pro |
| With Tools | MCP tool usage |
| Avg per User | Messages per team member |
Voice Statistics
| Metric | Description |
|---|---|
| TTS Characters | Total characters converted |
| STT Minutes | Total audio transcribed |
| By Voice | Popular voice choices |
Team Usage
Per-User Breakdown
See individual usage:
┌──────────────────────────────────────────────────────┐
│ User │ Credits │ Images │ Chat │ Voice │
├──────────────────────────────────────────────────────┤
│ john@company.com │ 180 │ 45 │ 120 │ 15 │
│ jane@company.com │ 156 │ 78 │ 62 │ 16 │
│ bob@company.com │ 120 │ 30 │ 85 │ 5 │
└──────────────────────────────────────────────────────┘
Activity Patterns
Identify usage trends:
- Peak Hours - When is usage highest?
- Feature Preference - What do users prefer?
- Adoption - Are all users active?
User Engagement
| Engagement Level | Criteria |
|---|---|
| High | Daily active, multiple features |
| Medium | Weekly active, 1-2 features |
| Low | Monthly or less |
| Inactive | No activity in 30+ days |
Historical Analysis
Trend Reports
View usage over time:
- Daily - Last 30 days
- Weekly - Last 12 weeks
- Monthly - Last 12 months
Comparing Periods
Compare current vs previous:
This Month vs Last Month:
- Total Credits: +23% (456 vs 371)
- Image Generation: +35%
- Chat Usage: -5%
- New: Video Generation (started)
Growth Tracking
Monitor organization growth:
| Metric | This Month | Change |
|---|---|---|
| Active Users | 8 | +2 |
| Total Credits | 456 | +23% |
| Generations | 153 | +45% |
| API Calls | 234 | +12% |
API Usage
Request Metrics
| Metric | Description |
|---|---|
| Total Requests | All API calls |
| By Endpoint | Calls per API route |
| Success Rate | % successful |
| Avg Latency | Response time |
Rate Limiting
Monitor rate limit status:
Current: 245 / 300 requests per minute
Status: Normal
Error Tracking
Common error types:
| Error | Count | % of Total |
|---|---|---|
| Rate Limited | 12 | 2% |
| Auth Failed | 3 | 0.5% |
| Bad Request | 8 | 1.3% |
Workflow Analytics
Execution Metrics
| Metric | Description |
|---|---|
| Total Runs | All workflow executions |
| Success Rate | % completed successfully |
| Avg Duration | Time per execution |
| Credits Used | Total workflow credits |
Per-Workflow Stats
┌────────────────────────────────────────────────────┐
│ Workflow │ Runs │ Success │ Avg Time │
├────────────────────────────────────────────────────┤
│ Content Generator │ 45 │ 98% │ 12s │
│ Image Pipeline │ 23 │ 96% │ 45s │
│ Data Processor │ 12 │ 100% │ 8s │
└────────────────────────────────────────────────────┘
Exporting Data
Export Options
Export usage data for:
- Accounting and billing
- Internal reporting
- Compliance requirements
Available Exports
| Export | Format | Data Included |
|---|---|---|
| Usage Summary | CSV/PDF | Overview metrics |
| Detailed Usage | CSV | Line-by-line activity |
| Invoice Data | Billing information | |
| API Logs | JSON | Raw API activity |
How to Export
- Go to Usage
- Click Export
- Select date range
- Choose format
- Download file
Scheduled Reports
Set up automatic exports:
- Go to Settings > Reports
- Click New Scheduled Report
- Configure:
- Report type
- Frequency (daily/weekly/monthly)
- Recipients
- Save
Optimization Tips
Reducing Credit Usage
| Tip | Potential Savings |
|---|---|
| Use Standard quality when appropriate | 50-80% per image |
| Shorter video durations | Proportional savings |
| Efficient prompts (less retry) | 20-30% |
| Batch similar requests | Workflow efficiency |
Identifying Waste
Look for:
- Failed generation retries
- Unused generated content
- Redundant API calls
- Inefficient workflows
Right-Sizing Your Plan
Evaluate monthly:
- Review actual usage vs allocation
- Check if features match needs
- Consider team size requirements
- Adjust plan if needed
Alerts and Notifications
Setting Up Alerts
Configure at Settings > Notifications:
| Alert | Trigger | Action |
|---|---|---|
| Low Credits | 80% used | Email notification |
| Critical Credits | 95% used | Email + in-app |
| Daily Summary | End of day | Email digest |
| Weekly Report | End of week | Email report |
Notification Channels
- Email - Primary notifications
- In-App - Dashboard alerts
- Webhook - Custom integrations
Custom Alerts
Create custom alerts:
{
"name": "High Image Usage",
"condition": "usage.images.daily > 50",
"action": "email",
"recipients": ["admin@company.com"]
}
Best Practices
Regular Monitoring
| Frequency | Check |
|---|---|
| Daily | Credit balance, failed requests |
| Weekly | Feature usage trends, user activity |
| Monthly | Full usage review, plan evaluation |
| Quarterly | ROI analysis, optimization review |
Documentation
Keep records of:
- Usage patterns and trends
- Optimization actions taken
- Cost allocation by project/team
- Compliance requirements
Team Communication
- Share usage dashboards with team
- Set usage expectations
- Discuss optimization opportunities
- Celebrate efficiency wins
Troubleshooting
Unexpected High Usage
- Check recent activity log
- Identify unusual patterns
- Review API key usage
- Check for automated jobs
Missing Usage Data
- Verify date range selected
- Check user permissions
- Clear browser cache
- Contact support if persists
Incorrect Totals
- Ensure all users included
- Check for pending transactions
- Verify time zone settings
- Report discrepancies to support
Previous: Billing & Plans