Search anything...
K
Back to Docs
  • Introduction
  • Quick Start
  • Account Setup
  • AI Studio
  • Chat
  • Agents
  • Voice
  • MCP Servers
  • Workflows
  • Authentication
  • Studio API
  • Chat API
  • Agents API
  • Voice API
  • Workflows API
  • Webhooks
  • Error Codes
  • Creating Custom Agents
  • MCP Integration
  • Building Workflows
  • Prompt Engineering
  • Team Management
  • Billing & Plans
  • Usage Monitoring
  • Single-Tenant Cloud
  • Private VPC Deployment
  • SSO Configuration
  • Security Policies
  • Compliance
  • Troubleshooting
  • API Versioning
DocsAdministrationUsage Monitoring

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:

MetricDescription
UsedCredits consumed this period
RemainingCredits available
BonusPurchased credits available
Reset DateWhen 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 TypeTrigger
Warning80% consumed
Critical95% consumed
Depleted100% consumed

Feature Analytics

Generation Statistics

Image Generation

MetricDescription
Total GenerationsNumber of images created
Credits UsedTotal credits for images
Avg per DayDaily generation rate
By QualityStandard/High/Ultra split
By ModelUsage per AI model
By Aspect RatioPopular dimensions

Video Generation

MetricDescription
Total VideosNumber of videos created
Total DurationCombined video length
Credits UsedTotal credits for video
Avg DurationAverage video length
By ModelUsage per model

Music Generation

MetricDescription
Total TracksNumber of tracks created
Total DurationCombined audio length
Credits UsedTotal credits for music
Avg DurationAverage track length

Chat & Agent Statistics

MetricDescription
Total MessagesAll chat messages
By ModelGemini Flash vs Pro
With ToolsMCP tool usage
Avg per UserMessages per team member

Voice Statistics

MetricDescription
TTS CharactersTotal characters converted
STT MinutesTotal audio transcribed
By VoicePopular 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 LevelCriteria
HighDaily active, multiple features
MediumWeekly active, 1-2 features
LowMonthly or less
InactiveNo 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:

MetricThis MonthChange
Active Users8+2
Total Credits456+23%
Generations153+45%
API Calls234+12%

API Usage

Request Metrics

MetricDescription
Total RequestsAll API calls
By EndpointCalls per API route
Success Rate% successful
Avg LatencyResponse time

Rate Limiting

Monitor rate limit status:

Current: 245 / 300 requests per minute
Status: Normal

Error Tracking

Common error types:

ErrorCount% of Total
Rate Limited122%
Auth Failed30.5%
Bad Request81.3%

Workflow Analytics

Execution Metrics

MetricDescription
Total RunsAll workflow executions
Success Rate% completed successfully
Avg DurationTime per execution
Credits UsedTotal 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

ExportFormatData Included
Usage SummaryCSV/PDFOverview metrics
Detailed UsageCSVLine-by-line activity
Invoice DataPDFBilling information
API LogsJSONRaw API activity

How to Export

  1. Go to Usage
  2. Click Export
  3. Select date range
  4. Choose format
  5. Download file

Scheduled Reports

Set up automatic exports:

  1. Go to Settings > Reports
  2. Click New Scheduled Report
  3. Configure:
    • Report type
    • Frequency (daily/weekly/monthly)
    • Recipients
  4. Save

Optimization Tips

Reducing Credit Usage

TipPotential Savings
Use Standard quality when appropriate50-80% per image
Shorter video durationsProportional savings
Efficient prompts (less retry)20-30%
Batch similar requestsWorkflow efficiency

Identifying Waste

Look for:

  • Failed generation retries
  • Unused generated content
  • Redundant API calls
  • Inefficient workflows

Right-Sizing Your Plan

Evaluate monthly:

  1. Review actual usage vs allocation
  2. Check if features match needs
  3. Consider team size requirements
  4. Adjust plan if needed

Alerts and Notifications

Setting Up Alerts

Configure at Settings > Notifications:

AlertTriggerAction
Low Credits80% usedEmail notification
Critical Credits95% usedEmail + in-app
Daily SummaryEnd of dayEmail digest
Weekly ReportEnd of weekEmail 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

FrequencyCheck
DailyCredit balance, failed requests
WeeklyFeature usage trends, user activity
MonthlyFull usage review, plan evaluation
QuarterlyROI 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

  1. Check recent activity log
  2. Identify unusual patterns
  3. Review API key usage
  4. Check for automated jobs

Missing Usage Data

  1. Verify date range selected
  2. Check user permissions
  3. Clear browser cache
  4. Contact support if persists

Incorrect Totals

  1. Ensure all users included
  2. Check for pending transactions
  3. Verify time zone settings
  4. Report discrepancies to support

Previous: Billing & Plans

Previous
Billing & Plans
Next
Single-Tenant Cloud