Difference between revisions of "Platform Team/Usage Statistics"

From Sugar Labs
Jump to navigation Jump to search
Line 30: Line 30:
 
== Implementation ==
 
== Implementation ==
  
=== Monitor ===
+
* [[Sugar_Server_Kit/sugar-stats|sugar-stats]] library.
 
+
* [[Sugar_Server_Kit/sugar-client|sugar-client]], Sugar client complex solution that uses [[Sugar_Server_Kit/sugar-stats|sugar-stats]] library.
The usage statistics will be gathered by sniffing DBus and X11 messages in the [[Sugar_Server_Kit/sugar-client|sugar-client]] program launched with the {{Code|monitor}} command. The {{Code|sugar-client}} will stay in daemon mode, and send collected and filtered data to the [[Sugar_Server_Kit/sugar-server#collector|sugar-server]], or, will keep it for later collection in server-less environments.
 
 
 
=== Journal crawler ===
 
 
 
In addition to the realtime monitoring, it might be useful to collect some stats from the Journal. It should be possible to run this code on a client side, or, on school servers using Journal backups.
 
 
 
This feature was implemented in [http://wiki.paraguayeduca.org/index.php/Analisis_de_Uso_de_Actividades Paraguay], but is not being used right now.
 
 
 
=== Collector ===
 
 
 
=== Analyzer ===
 
  
 
== See also ==
 
== See also ==

Revision as of 23:17, 11 January 2012

Summary

Sugar usage statistics might be very useful from, e.g., an educational or research point of view. Statistics might be anonymous or personalized (by taking special efforts to keep information secure and local for use only by a particular deployment).

Statistics

All types of statistics are identified by IDs in a dot separated hierarchy. This makes it possible to refer to the particular type or level of data.

  • shell
    Shell related stats.
    • shell.uptime
      How long Shell is running.
    • shell.active
      How long Shell window is on top.
    • shell.friends
      Number of buddies in the Groups view.
  • journal
    Journal related activity.
    • journal.uptime
      How long Journal is running.
    • journal.active
      How long Journal window is on top.
    • journal.creates
      Number of create requests sent from the Journal window.
    • journal.updates
      Number of update requests sent from the Journal window.
    • journal.deletes
      Number of delete requests sent from the Journal window.
  • activity
    Activities related stats; specified only for the particular activity.
    • activity.uptime
      How long Activity is running.
    • activity.active
      How long Activity window is on top.
    • activity.instances
      How many instances launched.
    • activity.new
      How many running instances with new Journal entity.
    • activity.resumed
      How many running instances with resumed Journal entity.
    • activity.buddies
      Number of buddies Activity is interacting with for all running instances.
  • system
    System related stats.
    • system.uptime
      System uptime value.
    • system.diskfree
      How many storage space is free, in kilobytes, for the home directory.

Implementation

See also

  • Paraguayan Activity usage analysis basing on Journal records.
  • Australian request for statistics gathering.