Check jitsi-videobridge-stats

Overview

Returns a bunch of performance data on a Jitsi Videobridge (v2.1+) using the REST version of the COLIBRI protocol.

The statistics are available through the /colibri/stats endpoint on the private REST interface that must be activated first.

The check does not convert the total values into discrete values. Instead, all totals are reported as „continous counters“, otherwise the duration of the conferences will not be displayed nicely on the timeline, for example.

For a discussion on how many users Jitsi support see here1, here2 and here3

Hints:

  • DTLS: Datagram Transport Layer Security

  • MUC: Multi-User Channel

Fact Sheet

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/jitsi-videobridge-stats

Check Interval Recommendation

Once a minute

Can be called without parameters

Yes

Compiled for

Linux, Windows

Help

usage: jitsi-videobridge-stats [-h] [-V] [--always-ok] [--insecure]
                               [--no-proxy] [-p PASSWORD] [--test TEST]
                               [--timeout TIMEOUT] [--url URL]
                               [--username USERNAME]

Returns a bunch of performance data on a Jitsi Videobridge using the REST
version of the COLIBRI protocol.

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  --insecure            This option explicitly allows to perform "insecure"
                        SSL connections. Default: False
  --no-proxy            Do not use a proxy. Default: False
  -p PASSWORD, --password PASSWORD
                        Jitsi API password.
  --test TEST           For unit tests. Needs "path-to-stdout-file,path-to-
                        stderr-file,expected-retc".
  --timeout TIMEOUT     Network timeout in seconds. Default: 3 (seconds)
  --url URL             Jitsi API URL. Default: http://localhost:8080
  --username USERNAME   Jitsi API username. Default: None

Usage Examples

./jitsi-videobridge-stats

Output:

2 total participants, 1 conference, Stress Level 0.00848, 75 JVM threads, 1.4Mbps download, 961.3Kbps upload

States

  • Always returns OK.

Perfdata / Metrics

For details have a look here (not all make sense in PerfData).

Credits, License