If your app uses webhooks, then you should monitor for and respond to failed webhook delivery notifications. A webhook will be retried up to 8 times, after multiple failures in a 24 hour period the webhook subscription will be removed.

If your app was created in the Partner Dashboard or using Shopify CLI, then you can use the webhook delivery metrics report to troubleshoot delivery failures and get information on performance.


This guide shows you how to use the webhook metrics report to track any failed webhook deliveries and fix them before they affect app users.

> Info:
> Webhooks are divided by topic. Refer to the [Webhooks references](/docs/api/webhooks) for the complete list of supported webhook topics.



## View deliveries

You can view a report of your app's webhook deliveries from the past 7 days in the Partner Dashboard.

1. From your [Partner Dashboard](https://partners.shopify.com/), click **Apps**.
2. Click the name of your app.
3. In the sidebar, click **Insights** > **Webhook metrics**.

> Tip:
> You can manually trigger a webhook to check delivery metrics by updating your development store. For example, update a product to trigger `products/update`.

## View metrics

The **Webhook metrics** page shows failed deliveries over time. Each topic lists the following information for each of the app's webhook subscriptions:

<table>
  <caption>Webhook metrics</caption>
  <tr>
    <th scope="col">Field</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td>Failed delivery rate</td>
    <td>The percentage of unsuccessful delivery attempts out of the total number of delivery attempts</td>
  </tr>
  <tr>
    <td>Removed webhooks</td>
    <td>The number of removed webhook subscriptions. Webhooks are retries up to 8 times, after multiple failures in a 24 hour period the webhook subscription will be removed.</td>
  </tr>
  <tr>
    <td>Response time</td>
    <td>The 90th percentile of an app's webhook response time. This means that 90% of the app's responses were equal to or faster than the listed time.</td>
  </tr>
</table>

From the **Webhook metrics** page, you can view a webhook's [delivery logs](#view-logs) and [delivery details](#view-delivery-details).

## View logs

When you click a webhook topic on the **Webhook metrics** page, you can view the delivery logs for that topic. The delivery logs list the following information:

<table>
  <caption>Webhook metrics</caption>
  <tr>
    <th scope="col">Field</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td>Response</td>
    <td>The response code that your app sent when it received the webhook.</td>
  <tr>
    <td>Retries</td>
    <td>The number of delivery attempts that were made to deliver that particular payload. </td>
  </tr>
  </tr>
  <tr>
    <td>Shop</td>
    <td>The URL of the Shopify store that's associated with the delivery.</td>
  </tr>
  <tr>
    <td>Shop ID</td>
    <td>The ID of the Shopify store that's associated with the delivery.</td>
  </tr>
  <tr>
    <td>Subscription ID</td>
    <td>The unique ID of the subscription that's associated with the delivery.</td>
  </tr>
  <tr>
    <td>Time</td>
    <td>The date and time that the most recent delivery attempt was made.</td>
  </tr>
</table>

> Note:
> The delivery logs dashboard doesn't provide real-time updates. Data could be delayed up to several minutes.


### Responses and retries

A `200` series status response is considered successful. If your app has a high rate of successful responses, then the logs display a sample representation of successful responses.

If your app didn't respond with a `200` series status code, then the webhook delivery failed. If the delivery fails, then Shopify retries to deliver the webhook up to 8 times.

### Prioritize fixes

Use the response and the number of retries to help figure out which webhooks to fix first. Prioritize fixing the webhooks that have any of the following errors:

- **Removed response**: Removed webhook subscriptions won't receive any deliveries unless you create them again.

- **Delivery failed response and 8 retries**: After 8 failed delivery attempts, Shopify stops attempting to deliver the webhook. For webhooks with 8 failed delivery attempts, you might need to [import missing data](/docs/apps/build/webhooks/best-practices#recover-from-a-downtime-event). Webhooks that have failed multiple times in a row are likely to continue failing. You might miss data if these webhooks continue to fail.

## View delivery details

When you click a delivery on the **Delivery logs** page, you can view additional information about the delivery, including the following:

<table>
  <caption>Webhook metrics</caption>
  <tr>
    <th scope="col">Field</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td>Endpoint</td>
    <td>The endpoint that the delivery was sent to.</td>
  <tr>
    <td>HTTP headers</td>
    <td>The HTTP headers that are sent with the delivery.</td>
  </tr>
  </tr>
  <tr>
    <td>Payload size</td>
    <td>The size of the delivery's payload.</td>
  </tr>
  <tr>
    <td>Response time</td>
    <td>The time between the request and the response. If your app doesn't respond within five seconds, then the delivery fails.</td>
  </tr>
  <tr>
    <td>Retries</td>
    <td>The number of delivery attempts left. If there are no retries left and the latest attempt failed.</td>
  </tr>
</table>

## Troubleshooting failed deliveries

Delays in data processing that are caused by webhook failures can have an impact on users. Each time that a delivery fails, the time between retried deliveries increases. This can cause your data to become out of sync, especially if you process a lot of webhook events or time-sensitive data.

To identify failed deliveries, look for the following issues:

<table>
  <caption>Webhook metrics</caption>
  <tr>
    <th scope="col">Issue</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td>Failed delivery rates over 0.5%</td>
    <td><p>This is considered a higher-than-average failed delivery rate, and could mean that your webhook is failing across multiple stores, or has failed multiple times in a row.</p><p>A high failed delivery rate on one topic might indicate a store-specific or payload-specific error.</p></td>
  <tr>
    <td>Removed webhooks</td>
    <td><p>Your app isn't receiving data for subscriptions that have been removed after multiple failed delivery attempts.</p><p>You’ll need to fix the issue, then recreate the webhook subscriptions.</p></td>
  </tr>
  </tr>
  <tr>
    <td>Response times between four and five seconds</td>
    <td>The app must respond to the webhook within five seconds. If your app doesn't respond, then the delivery fails. To resolve timeout failures, delay processing your webhook until you've sent your response.</td>
  </tr>
  <tr>
    <td>Same failed delivery rates across all topics</td>
    <td><p>If your topics all have a high failed delivery rate, then your backend might not be responding.</p><p>To troubleshoot, use your monitoring tools.</p></td>
  </tr>
</table>