Check out the newest issue of our WebRTC Metrics Report series!

Integrating with Jitsi Meet

Introduction

Jitsi Meet is an open source WebRTC application. It is an easy way to get started with building a scalable WebRTC-based communication service.

WebRTC conference star topology

Star topology: Jitsi Video Bridge behaves as a Selective Forwarding Unit (SFU).

Integration Steps

Jitsi Meet Web Client

If you are installing the jitsi-meet using the via debian package (e.g., apt-get), the config file needs to be updated to enable callstats.

$ sudo apt-get update
$ sudo apt-get -y install jitsi-meet
$ vi /etc/jitsi/meet/hostname-config.js

In the config file uncomment the lines related to callstats.io.

// To enable sending statistics to callstats.io you should provide Applicaiton ID and Secret.
    callStatsID: "", //Application ID for callstats.io API
    callStatsSecret: "" //Secret for callstats.io API

To build from Jitsi Meet from source, the instructions are detailed in the README.md file and the same lines related to callstats in config.js need to be updated.

Jitsi Video Bridge (JVB)

callstats.java library is already integrated into the Jitsi Videobridge. It is an essential server component of the Jitsi Meet client and would not work without the bridge. With the callstats.java library, WebRTC developers using Jitsi products can now monitor WebRTC traffic also from the Jitsi Videobridge.

To enable callstats on JVB, the following properties needs to be set in /etc/jitsi/videobridge/sip-communicator.properties, also documented on JVB’s Github page.


# the callstats credentials
io.callstats.sdk.CallStats.appId=
io.callstats.sdk.CallStats.appSecret=

# the id of the videobridge
io.callstats.sdk.CallStats.bridgeId=

# enable statistics and callstats statistics and the report interval
org.jitsi.videobridge.ENABLE_STATISTICS=true
org.jitsi.videobridge.STATISTICS_INTERVAL.callstats.io=30000
org.jitsi.videobridge.STATISTICS_TRANSPORT=callstats.io

If you make any changes to this file, then make sure you restart the videobridge ($ /etc/init.d/jitsi-videobridge restart).

callstats Bridge Logs

callstats.io stores callstats bridge logs and they are located at /var/log/jitsi/{yyyy-mm}/. The name of the log is cs-MM-DD-YYYY-#.log.gz. Please include callstats bridge log when requesting support on issues related to the bridge.

Reference Implementation

Details of the callstats.java API are documented at http://callstats-io.github.io/callstats.java/.

Feedback

Send your comments and feedback to our groups/callstats-dev.