# Automated KPI Catalog

Generated automatically from business metrics configuration.

## Catalog Metadata
- **Generated**: 2025-09-26T09:29:19.732Z
- **Total KPIs**: 12
- **Categories**: 5

## KPI Categories

### USER ENGAGEMENT

#### Daily Active Users
- **Description**: Unique users with session.started events in past 24 hours
- **Calculation**: `COUNT(DISTINCT user_hash) WHERE event_type = "session.started" AND timestamp >= NOW() - INTERVAL 1 DAY`
- **Target**: Growing 15% month-over-month
- **Alert Threshold**: Drop > 10% day-over-day

#### Weekly Active Users
- **Description**: Unique users with session.started events in past 7 days
- **Calculation**: `COUNT(DISTINCT user_hash) WHERE event_type = "session.started" AND timestamp >= NOW() - INTERVAL 7 DAY`
- **Target**: Growing 10% month-over-month
- **Alert Threshold**: Drop > 15% week-over-week

#### Monthly Active Users
- **Description**: Unique users with session.started events in past 30 days
- **Calculation**: `COUNT(DISTINCT user_hash) WHERE event_type = "session.started" AND timestamp >= NOW() - INTERVAL 30 DAY`
- **Target**: Growing 5% month-over-month
- **Alert Threshold**: Drop > 20% month-over-month

### CONVERSION

#### 24-Hour Signup Conversion Rate
- **Description**: Percentage of visitors who complete signup within 24 hours
- **Calculation**: `(COUNT(DISTINCT user_hash WHERE event_type = "signup.completed") / DAU) * 100`
- **Target**: > 2.5%
- **Alert Threshold**: < 1.5%

#### Chat Engagement Rate
- **Description**: Percentage of sessions that include chat interactions
- **Calculation**: `(Sessions with chat.message_sent / Total sessions) * 100`
- **Target**: > 60%
- **Alert Threshold**: < 40%

#### Voice Feature Adoption
- **Description**: Percentage of users using voice features monthly
- **Calculation**: `(MAU with voice.session_started / MAU) * 100`
- **Target**: > 25%
- **Alert Threshold**: < 15%

### REVENUE

#### 30-Day Revenue
- **Description**: Total revenue in USD over past 30 days
- **Calculation**: `SUM(payment.amount_usd) WHERE timestamp >= NOW() - INTERVAL 30 DAY`
- **Target**: Growing 20% month-over-month
- **Alert Threshold**: Drop > 5% month-over-month

#### Average Revenue Per User
- **Description**: Monthly recurring revenue divided by active paying users
- **Calculation**: `Monthly Revenue / COUNT(DISTINCT paying_users)`
- **Target**: > $15/month
- **Alert Threshold**: < $10/month

### CONTENT

#### Content Engagement Score
- **Description**: Average session duration and completion rates
- **Calculation**: `AVG(session_duration_minutes) * completion_rate_percentage`
- **Target**: > 15 minutes with >70% completion
- **Alert Threshold**: < 8 minutes or <50% completion

#### Meditation Completion Rate
- **Description**: Percentage of meditation sessions completed
- **Calculation**: `(meditation.completed / meditation.started) * 100`
- **Target**: > 80%
- **Alert Threshold**: < 60%

### TECHNICAL

#### API Performance Score
- **Description**: Composite score of latency, error rate, and throughput
- **Calculation**: `(100 - error_rate_percentage) * latency_score * throughput_score`
- **Target**: > 95
- **Alert Threshold**: < 85

#### Service Uptime
- **Description**: Percentage of time services are available
- **Calculation**: `(Total time - Downtime) / Total time * 100`
- **Target**: > 99.9%
- **Alert Threshold**: < 99.5%

## API Integration Examples

### Accessing KPI Data

```javascript
// Get all KPIs
const dashboard = await fetch('/v1/metrics/dashboards/business');
const kpis = await dashboard.json();

// Access specific KPI
const dau = kpis.kpis.user_engagement.dau;
console.log(`Current DAU: ${dau}`);
```

### KPI Monitoring

```bash
# Get business dashboard
curl "$OBSERVABILITY_URL/v1/metrics/dashboards/business"

# Get specific KPI report
curl "$OBSERVABILITY_URL/v1/metrics/reports/business?period=30d"
```

---
*Generated automatically by business-metrics-docs-generator.js*
*Last updated: 2025-09-26T09:29:19.733Z*
