KPI Alert Response Procedures#
DAU/MAU Drop Investigation#
Detection Criteria#
- DAU drops > 10% day-over-day
- MAU drops > 20% month-over-month
- 7-day rolling average trending down
Investigation Steps#
-
Immediate Checks (0-10 minutes)
bash# Check system health curl "$OBSERVABILITY_URL/v1/health" # Verify analytics ingestion curl "$OBSERVABILITY_URL/v1/analytics/health" # Check recent user activity curl "$OBSERVABILITY_URL/v1/metrics/dashboards/business" -
Traffic Analysis (10-30 minutes)
bash# Check CDN traffic aws cloudwatch get-metric-statistics --namespace AWS/CloudFront \ --metric-name Requests --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \ --end-time $(date -u +%Y-%m-%dT%H:%M:%S) --period 300 # Check application errors kubectl logs -n lilith deployment/bff-service | grep ERROR # Verify service availability kubectl get pods -n lilith -
User Experience Review (30-60 minutes)
- Check user support tickets
- Review app store ratings
- Analyze user feedback
Potential Causes & Solutions#
| Cause | Detection | Solution |
|---|---|---|
| Service outage | Error rate spike | Restore service, investigate |
| App store issue | Platform-specific drop | Contact app store, fix issue |
| Feature regression | Feature usage drop | Rollback, hotfix |
| Marketing change | Traffic source shift | Adjust acquisition strategy |
Conversion Rate Drop#
Detection Criteria#
- Signup conversion < 1.5% (threshold: 2.5%)
- 7-day rolling conversion trending down
- Signup funnel abandonment increasing
Response Actions#
-
Funnel Analysis
bash# Check signup endpoint health curl "$AUTH_URL/v1/auth/signup/health" # Analyze signup completion rates curl "$OBSERVABILITY_URL/v1/metrics/conversion/funnel" -
User Experience Testing
- Test signup flow on all platforms
- Check form validation messages
- Verify email delivery
-
Technical Investigation
bash# Check auth service logs kubectl logs -n lilith deployment/auth-service # Verify database connectivity kubectl exec -n lilith deployment/auth-service -- pg_isready
Revenue Drop Investigation#
Detection Criteria#
- 30-day revenue drops > 5%
- ARPU declining > 2 consecutive periods
- Payment failure rate > 2%
Investigation Process#
-
Payment System Health
bash# Check payment service curl "$PAYMENT_URL/v1/payments/health" # Verify Stripe integration curl "$PAYMENT_URL/v1/payments/providers/stripe/status" -
Revenue Attribution Analysis
bash# Get revenue breakdown curl "$OBSERVABILITY_URL/v1/metrics/revenue/breakdown?period=30d" # Check payment failure patterns curl "$OBSERVABILITY_URL/v1/metrics/payments/failures"
Automated Alerting#
Alert Configuration#
javascript
const alertRules = {
dau_drop: {
condition: 'dau_change_percentage < -10',
severity: 'high',
cooldown: '1h',
channels: ['slack', 'pagerduty']
},
conversion_drop: {
condition: 'signup_conversion_24h < 1.5',
severity: 'medium',
cooldown: '4h',
channels: ['slack', 'email']
},
revenue_drop: {
condition: 'revenue_30d_change < -5',
severity: 'high',
cooldown: '24h',
channels: ['slack', 'executive_email']
}
};
Alert Integration#
javascript
// KPI monitoring service
class KPIMonitor {
async checkAlerts() {
const dashboard = await this.getDashboard();
for (const [kpi, rule] of Object.entries(this.alertRules)) {
const currentValue = this.extractKPIValue(dashboard, kpi);
const shouldAlert = this.evaluateCondition(rule.condition, currentValue);
if (shouldAlert) {
await this.sendAlert(kpi, rule, currentValue);
}
}
}
}
Generated automatically by business-metrics-docs-generator.js Last updated: 2025-09-26T09:29:19.732Z