libusermetrics
Welcome to Libusermetrics

Libusermetrics enables apps to locally store interesting numerical data for later presentation. For example in the Ubuntu Greeter "flower" infographic.

  • All data is stored locally in /var/usermetrics/.
  • No data is centrally collected via a web-serivice or otherwise, and no data is sent over the internet.

The only data that can be stored is numerical, for example "number of e-mails" or "number of pictures taken". No personally identifying information is stored using this library.

WARNING: This API should be considered private, and is only for use by first party applications at present. It may change or be removed at any time.

Getting and installing libusermetrics

Using pre-built packages

If you just want to try out libusermetrics, or write user metrics sources, then the easiest way is to use the pre-built packages.

Building and installing from source

If you are curious about libusermetrics's internals or intend to contribute to it, you should get the source and build it.

Getting involved

The best place to ask questions and discuss about libusermetrics is the #ubuntu-touch IRC channel on freenode.

The libusermetrics project is hosted on GitLab: https://gitlab.com/ubports/core/libusermetrics

Please file bug reports at: http://gitlab.com/ubports/core/libusermetrics/-/issues

Writing metric data sources

For simple metrics which only want to increment a counter, see the following examples:

For simple metrics which only want to update today's value, but cannot simply increment it, see the following examples:

For more sophisticated metrics, which wish to update the history of the metric, for example if the user has been offline for a week. Please see the following examples:

Writing a presentation application

To write a metric presentation application, there is a Qt API.