Support & information center

Setting up custom notifications in watchRTC

You can setup your own custom notifications in watchRTC. This enables you to identify and troubleshoot connectivity and media quality issues faster.

What are custom notifications?

watchRTC has a mechanism called notifications. With this mechanism, whenever a session completes and its collected data gets analyzed, watchRTC will review it against its own internal logic as well as thresholds you configure manually.

These thresholds are called custom notifications. They are rules related to media metrics in WebRTC, where you can define for example that a packet loss above 4% in incoming video channels should be considered as an issue to review later – either setting it up as a warning or an error.

watchRTC checks these custom rules and marks the peers and the rooms with the relevant warning and error messages.

You can setup custom notifications on the following metrics:

  • Call score
  • Call setup time
  • Audio/video incoming/outgoing bitrate
  • Audio/video incoming/outgoing packet loss
  • Audio/video incoming/outgoing jitter
  • Audio/video round trip time

Notifications can be configured as errors or warnings. watchRTC makes no distinction of its own between the two – they are given as a means of providing different notification levels for your own monitoring logic.

Predefined notifications

watchRTC has its own predefined notifications. These will be automatically analyzed and available to you as well. They are focused around connectivity of sessions – mainly ICE failures and ICE restarts. You can filter these in the History view to understand such failure reasons.

Setting up custom notifications

To setup custom notifications, go to Settings | watchRTC and scroll down to the Notifications section at the bottom.

There, you can create or edit custom notifications for your account:

  1. Pick the metric you want to be notified about
  2. Decide on the operator to use (Greater, Lower, Equal)
  3. Pick the threshold for the metric
  4. Choose the type of notification – warning or error
  5. Give a verbose message for the notification
  6. And activate the notification

Once activated, all new sessions conducted and collected by watchRTC will start showing the notifications if needed. Older sessions will remain unaffected.

Reviewing notification highlights

At the bottom of the watchRTC | Highlights page you will find the notifications table.

This table will display how many sessions and peers were found with each of the notifications configured. The actual timeframe and filter used for these numbers are based on how you filter this page.

Clicking a specific notification in this table will take you to the watchRTC | History page with the same filter with the details of the notifications. Note that you will only see in the history view the data available from the retention period of your account.

History filtering for notifications

When you look at the watchRTC | History page, where all sessions are detailed, there is a Notifications column. You can use it to filter out and review rooms that had specific notifications on that. These notifications will include the automatic notifications available on watchRTC as well as the custom notifications you configure.

Individual room/peer notifications

Once you drill down into a specific room, the notifications of all the rooms will appear on the page. This includes a notification above the chart and as indicators in the peers table.

Drilling down to any of the peers will also show you the details of the notifications on that peer.

Was this article helpful?

Related Articles