Skip to main content

Prometheus Instrumentation

If the controller is started with the –prometheus PASSPHRASE command line parameter, MistServer makes Prometheus-compatible instrumentation available.

Once used as a command line parameter, the PASSPHRASE is stored into the configuration file, and need not be given again over the command line. It can be cleared by using the same parameter again, and providing an empty string instead: –prometheus "".

Alternatively the PASSPHRASE can be set up through the user interface by enabling the Prometheus stats output in the General tab.

The instrumentation can be accessed over the API port (by default 4242) by requesting the path /PASSPHRASE. Documentation of this instrumentation itself is present inside the output, so not repeated here.

Alternatively, the same data can also be accessed in JSON format as the path /PASSPHRASE.json. This format does not contain any documentation, but the same data is used, so please refer to the Prometheus-style output for details.

Some of the data is stream-bound, and only available while a stream is active (has at least one session associated with it).

The configuration of Prometheus or some other statistics gathering software is beyond the scope of this manual. Please see the documentation of your statistics gathering software for further details. The same goes for visualization of the gathered data.