Troubleshoot delayed or stuck Mechanic tasks — check queue status, Shopify webhook delivery, and concurrency limits.
In general, there are two reasons why a task might be delayed, or might not be appearing to run:
Your Mechanic queue is backed up
The upstream service (like Shopify) is delayed in sending notifications to Mechanic
Using Mechanic for a business-critical purpose? Learn about monitoring Mechanic.
... then you'll see a steady stream of incoming activity, in your account's activity log, but you might not see activity corresponding to the very latest events in your store. Mechanic has some concurrency limits that determine how much can happen in your account at once, and if you reach those limits, processing of new events will be delayed until Mechanic catches up.
If it's useful, you can consider disabling unnecessary tasks, which let each emerging task run fail instantly instead of running normally. It won't clear the event queue, but it'll let the event queue run more quickly. More on that here: How do I stop a large batch of runs?
... then you won't see anything appearing in Mechanic's activity log. If that service is Shopify, you might see something reported on Shopify's status page.
In most cases, delays are resolved in time, and the delayed events are later on sent to Mechanic, where they can be processed.
In very rare cases, Shopify may erroneously miss an event entirely. This is a documented behavior of Shopify's webhook system. To learn more about this, see Reconciling missing events.
So as to avoid sending out floods of notifications, Shopify waits a few seconds before sending notifications for update events, to see if any other updates occur that should be included in the notification.
For example, if you change a product's title, then save it, then notice a mistake and change the title again, Shopify may only send a single update instead of two. This means that update events take a little longer to arrive than other events.
Last updated
Was this helpful?
Was this helpful?
