This project holds the set of applications which have been instrumented with OML. Whenever it is relevant, they also provide an up-to-date application definition for use with OMF (using the oml:app namespace).

These applications have some OML Measurement Points defined within their source code, which allows systematic collection and storage of measurement samples using the OML client library and the OML collection server. We currently provide the following applications:

We also have some work-in-progress applications being instrumented. They usually are based on upstream sources, and are therefore handled in separate repositories, so we can maintain the OML instrumenation only.

After installing the collectd-write-oml2 package, collectd has been pulled in as a dependency and is running already. To enable data collection with OML, the collectd plugin must be enabled and configured as described above and collectd must be restarted.

The GPS logger application makes use of the gpsd library and data structures. In addition to capturing latitude and longitude, it reads elevation, the fix type (none, 2D or 3D) and the timestamp sent from the satellite and reports these values back to an OML server. The current application definition is available an source:/gpslogger/gpslogger.rb.in. An example on how to use it in an OMF experiment can be found here.

With the -v flag, it also reports fixes on stdout as CSV. This can be handy for a quick test with gpsd's gpsfake:

Nmetrics is a simple command line program to capture some system statistics (CPU load, memory usage, network load, process information). It makes use of the Hyperic SIGAR library, which we also provide as a package in our Debian/Ubuntu repositories.

The current application definition is available an source:/nmetrics/nmetrics.rb.in. An example experiment using it monitoring only CPU, memory and network for 20s with OMF 5.4 could look as follows. Note the reliance on the oml:app:nmetrics application definition shipped with the binary.

The Linux utility from WattsUp? has been instrumented with OML, and can be used as follows, assuming the meter is connected via USB to the reporting computer as /dev/ttyUSB0, and that the current user has read/write permissions to that device (otherwise, sudo can be useful).

As for OML, we maintain packages for major distributions, they can be installed in the same way. Each application is available as a separate package for Debian/Ubuntu, under the names listed above. There also is an oml2-apps-omfdef package for easy integration with OMF.