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: Global webhooks and Manual 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.

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 Global from Manual webhooks, look into the Group Description. All manual webhooks will indicate 'event management'. In the example below, the first three logs are Manual webhooks(i.e., 'Failed delivery', 'Returned', and 'Full Delivery'), and the last log is a Global webhook.

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

Duration and behaviour

1

0 Seconds

2

0.5 seconds

3

10 seconds

4

Within the first 24 hours, every minute

5

After the first 24 hours, every hour

6

The system will 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.

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.

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