Skip to main content

Metrics and Analytics

This guide explains how to monitor and analyze your app updates using Source Push metrics and analytics.

Overview​

Source Push provides comprehensive metrics to help you:

  • Track update deployment success rates
  • Monitor download and installation performance
  • Analyze user adoption patterns
  • Identify potential issues early

Available Metrics​

Deployment Metrics​

  1. Update Status

    • Download success rate
    • Installation success rate
    • Rollback frequency
    • Error rates

  2. Performance Metrics

    • Download time
    • Installation time
    • Network bandwidth usage
    • Storage impact

  3. User Metrics

    • Active users
    • Update adoption rate
    • Version distribution
    • Geographic distribution

Accessing Metrics​

Console Dashboard​

Access metrics through the Source Push Console:

  1. Navigate to your app in the console
  2. Select "Metrics" from the sidebar
  3. Choose the deployment environment
  4. Select the time range

API Access​

Fetch metrics programmatically:

# Get deployment metrics
srcpush metrics get-deployment MyApp Production

# Get specific metric
srcpush metrics get MyApp --metric download_success_rate

Setting Up Alerts​

Alert Configuration​

{
  "alerts": {
    "errorRate": {
      "threshold": 5,
      "timeWindow": "1h"
    },
    "rollbackRate": {
      "threshold": 2,
      "timeWindow": "24h"
    }
  }
}

Notification Channels​

Configure alerts through various channels:

  • Email notifications
  • Slack integration
  • Webhook callbacks
  • SMS alerts

Custom Metrics​

Implementing Custom Tracking​

import { MetricsService } from "@srcpush/metrics";

// Track custom events
MetricsService.trackEvent("custom_update_event", {
  updateVersion: "1.2.3",
  deviceType: "ios",
  customData: {
    feature: "newUI",
    userSegment: "beta",
  },
});

Custom Dashboards​

Create custom dashboards using the metrics API:

const customMetrics = await MetricsService.query({
  timeRange: "7d",
  metrics: ["download_time", "install_time"],
  dimensions: ["app_version", "device_type"],
  filters: {
    deployment: "Production",
    country: "US",
  },
});

Best Practices​

1. Regular Monitoring​

  • Set up daily/weekly metric reviews
  • Establish baseline metrics
  • Track trends over time
  • Document anomalies

2. Performance Optimization​

  • Monitor bundle sizes
  • Track download speeds
  • Analyze installation times
  • Optimize based on metrics

3. User Impact Analysis​

  • Track user segments
  • Monitor device types
  • Analyze geographic patterns
  • Measure user engagement

Troubleshooting​

Common Issues​

  1. High Error Rates

    • Check network conditions
    • Verify bundle integrity
    • Review device compatibility
    • Analyze error patterns

  2. Slow Performance

    • Monitor bundle size
    • Check CDN performance
    • Analyze device metrics
    • Review network metrics

Debug Logging​

Enable detailed metric logging:

MetricsService.setLogLevel("debug");
MetricsService.enableDetailedLogging();

Integration Examples​

CI/CD Integration​

# GitHub Actions example
steps:
  - name: Check Deployment Metrics
    run: |
      srcpush metrics check \
        --app MyApp \
        --deployment Production \
        --threshold error_rate=5

Monitoring Integration​

// Prometheus integration
const metrics = new PrometheusMetrics();
metrics.trackSourcePush({
  app: "MyApp",
  deployment: "Production",
  metrics: ["error_rate", "download_time"],
});

Next Steps​