shopify-advanced-troubleshooting

# Shopify Advanced Troubleshooting ## Overview Deep debugging for complex Shopify API issues: cost analysis with debug headers, webhook delivery inspection, GraphQL query introspection, and systematic isolation of intermittent failures. ## Prerequisites - Access to Shopify admin and Partner Dashboard - Familiarity with GraphQL and HTTP debugging - `curl` and `jq` available ## Instructions ### Step 1: GraphQL Cost Analysis When queries THROTTLE unexpectedly, use the cost debug header: ```bash # Get detailed per-field cost breakdown curl -X POST "https://$STORE/admin/api/2024-10/graphql.json" \ -H "X-Shopify-Access-Token: $TOKEN" \ -H "Content-Type: application/json" \ -H "Shopify-GraphQL-Cost-Debug: 1" \ -d '{ "query": "{ products(first: 50) { edges { node { id title variants(first: 20) { edges { node { id price metafields(first: 5) { edges { node { key value } } } } } } } } } }" }' | jq '.extensions.cost' ``` Response shows why the cost is high: ```json { "requestedQueryCost": 1552, "actualQueryCost": 234, "throttleStatus": { "maximumAvailable": 1000.0, "currentlyAvailable": 766.0, "restoreRate": 50.0 } } ``` **Key:** `requestedQueryCost` is `first` multiplied through nested connections. `50 products * 20 variants * (1 + 5 metafields)` = high cost even if actual data is small. ### Step 2: Trace a Specific Request Every Shopify response includes `X-Request-Id`. Capture it for support: ```bash # Capture full response headers and bo...