Logs and Troubleshooting

View webhook logs and retry or delete webhook activities on queue

All webhook activities are can be viewed through a log in the enterprise web portal.

Remember that there are two sources of webhook events: the standard Webhooks and Legacy Webhooks. If you are using both, the logs will contain the activities for both. All webhook events triggered from either sources goes to queue, which can be seen on the logs. You can use these logs for troubleshooting or retrying failed webhooks.

On the web portal, there are 2 places where you can find webhook logs:

  • Webhook Engine - displays webhooks in groups and allows you to retry or delete events
  • Webhook Logs - displays webhooks events individually

Webhook Engine

To access the webhook engine:

  1. Log in to your enterprise web portal (e.g., example.zyllem.com)
  2. Go to Settings > Engine > Webhooks. To see the individual events on queue, click on the group key. From here, you can identify the webhook events and the specifics of the events that failed.

To identify standard from Legacy Webhooks, look into the Group Description. All Legacy Webhooks will indicate 'event management'. In the example below, the first three logs are Legacy Webhooks(i.e., 'Failed delivery', 'Returned', and 'Full Delivery'), and the last log is a Global webhook.

10661066

Event Count is the number of unique events in that group. Fail Count is the number of times the events failed.

Retrying Events

To retrigger all events in the group, click Wake Up.
The Wake Up function retries the processing of the event. The system will keep on retrying in the following pattern:

Retry (Wakeup)

Frequency and behavior

1

Retry every 0 seconds

2

Retry every 0.5 seconds

3

Retry every 10 seconds

4

Retry every minute within the first 24 hours

5

Retry every every hour after the first 24 hours,

6

Discard the event after 48 hours

🚧

Clearing webhook events stuck on queue

If a certain event fails, all succeeding events in that group will be stuck in the queue. To delete all events in the group, click Delete Events. To retry the event, click Retry.

Webhook Logs

To access the Webhook logs:

  1. Log in to your enterprise web portal (e.g., example.zyllem.com)
  2. Go to Settings > Logs.
  3. Click on Webhook tab.
    Here you can search for the Shift ID, Activity ID, Activity Type, Lane name, User ID, Vehicle ID.
15551555

To view the details of the failed event, click Show Detail.

838838