Eve library

KPI Monitoring & Response Playbooks

Guide

Revision 1

On this page

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#

  1. 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"
    
  2. 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
    
  3. 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#

  1. 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"
    
  2. User Experience Testing

    • Test signup flow on all platforms
    • Check form validation messages
    • Verify email delivery
  3. 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#

  1. Payment System Health

    bash
    # Check payment service
    curl "$PAYMENT_URL/v1/payments/health"
    
    # Verify Stripe integration
    curl "$PAYMENT_URL/v1/payments/providers/stripe/status"
    
  2. 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