shopify-incident-runbook

# Shopify Incident Runbook ## Overview Rapid incident response for Shopify API outages, authentication failures, and rate limit emergencies. Distinguish between Shopify-side issues and your app's integration issues. ## Prerequisites - Access to Shopify admin and status page - Application logs and metrics - Communication channels (Slack, PagerDuty) ## Instructions ### Step 1: Quick Triage (First 5 Minutes) ```bash #!/bin/bash echo "=== SHOPIFY INCIDENT TRIAGE ===" echo "Time: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # 1. Is Shopify itself down? echo "" echo "--- Shopify Status ---" echo "Check: https://www.shopifystatus.com" echo "API Status: https://www.shopifystatus.com/api/v2/status.json" curl -sf "https://www.shopifystatus.com/api/v2/status.json" 2>/dev/null \ | python3 -c "import json,sys; d=json.load(sys.stdin); print(f'Overall: {d[\"status\"][\"description\"]}')" \ 2>/dev/null || echo "Could not reach status page" # 2. Can we reach the Shopify API? echo "" echo "--- API Connectivity ---" echo -n "Admin API: " HTTP_CODE=$(curl -sf -o /dev/null -w "%{http_code}" \ -H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \ "https://$SHOPIFY_STORE/admin/api/2024-10/shop.json" 2>/dev/null) echo "$HTTP_CODE" # 3. Rate limit state echo "" echo "--- Rate Limit State ---" curl -sI -H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \ "https://$SHOPIFY_STORE/admin/api/2024-10/shop.json" 2>/dev/null \ | grep -i "x-shopify-shop-api-call-limit" # 4. GraphQL rate limit echo ""...