Difference between revisions of "Sugar Network/Node Statistics"

From Sugar Labs
Jump to navigation Jump to search
Line 9: Line 9:
 
Statistics will be collected per Sugar Network [[Sugar_Network/Resources|resource type]].
 
Statistics will be collected per Sugar Network [[Sugar_Network/Resources|resource type]].
  
''User''<br>
+
* '''users'''<br>Total number of existing ''User'' objects;
* '''user.total'''<br>Total number of existing objects.
+
* '''contexts'''<br>Total number of existing ''Context'' objects;
 
+
* '''released'''<br>Average number of newly uploaded ''Context.releases'' for specified time frame;
''Context''<br>
+
* '''solved'''<br>Average number of requested ''Context'' [[Sugar_Network/API#GET-solve|solutions]] for specified time frame; note that this stats value does not equal to the number of solution usages on client side since solutions might be cached;
* '''context.total'''<br>Total number of existing objects.
+
* '''reported'''<br>Average number of newly uploaded failure ''Reports'' objects for specified time frame;
* '''context.released'''<br>Average number of newly uploaded releases for specified time frame;
+
* '''topics'''<br>Total number of top-level ''Post'' objects;
* '''context.solved'''<br>Average number of requested [[Sugar_Network/API#GET-solve|solutions]] for specified time frame; note that this stats value does not equal to the number of solution usages on client side since solutions might be cached;
+
* '''feedback'''<br>Total number of dependent ''Post'' objects.
* '''context.reported'''<br>Average number of newly uploaded failure ''Reports'' for specified time frame;
 
 
 
''Post''<br>
 
* '''post.topics'''<br>Total number of top-level ''Post'' objects;
 
* '''post.feedback'''<br>Total number of dependent ''Post'' objects.
 
  
 
== Per object statistics ==
 
== Per object statistics ==

Revision as of 04:44, 12 May 2014

Summary

This page describes the statistics that Sugar Network nodes generate. The statistics are about the entire server and not personalized. Note that the statistics are targeted for the interests of educational researchers rather than service maintainers, for technical details look for HTTP stats.

Statistics will be collected by analyzing regular requests to an API server and stored for each Sugar Network node. It will be possible to get direct access to these stats using node's API.

Common statistics

Statistics will be collected per Sugar Network resource type.

  • users
    Total number of existing User objects;
  • contexts
    Total number of existing Context objects;
  • released
    Average number of newly uploaded Context.releases for specified time frame;
  • solved
    Average number of requested Context solutions for specified time frame; note that this stats value does not equal to the number of solution usages on client side since solutions might be cached;
  • reported
    Average number of newly uploaded failure Reports objects for specified time frame;
  • topics
    Total number of top-level Post objects;
  • feedback
    Total number of dependent Post objects.

Per object statistics

While calculating common statistics, nodes generate per object sums as well.

These are the Sugar Network resources that will be affected:

Context properties:

  • Context.rating
    Average rating given to the Context while reviewing, rating value is a tuple of votes sum and number of reviews;
  • Context.retrieves
    Number of retrieves of Context releases.

Post properties:

  • Post.rating
    Average rating given to the Post while reviewing, rating value is a tuple of votes sum and number of reviews.

Getting involved

  • Submit your bug report or feature request.
  • Browse our implementation discussions, and post your feedback. (You should join this discussion list in order to avoid having your messages postponed for moderation.)