Difference between revisions of "Sugar Network/Node Statistics"

From Sugar Labs
Jump to navigation Jump to search
Line 1: Line 1:
 
== Summary ==
 
== Summary ==
  
This page describes the statistics that [[Sugar Network]] node [[Platform_Team/Sugar_Network/Implementation|servers]] generate. The statistics are about the entire node server and not [[Platform_Team/Usage_Statistics|personalized]]. Note that the statistics are targeted for the interests of educational researchers rather than service maintainers, thus, technical details that are important only for node maintaining are excluded.
+
This page describes the statistics that [[Sugar Network]] nodes generate. The statistics are about the entire server and not [[Platform_Team/Usage_Statistics|personalized]]. Note that the statistics are targeted for the interests of educational researchers rather than service maintainers, for technical details look for [http://jita.sugarlabs.org/node.sugarlabs.org/ 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 [[Platform_Team/Sugar_Network/API|API]]. In addition, slave node statistics will be uploaded to the master server.
+
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 [[Sugar_Network/API#Node_statistics|API]].
  
 
== Common statistics ==
 
== Common statistics ==
  
Statistics will be collected per Sugar Network [[Platform_Team/Sugar_Network/Objects_model|object type]].
+
Statistics will be collected per Sugar Network [[Sugar_Network/Resources|resource type]].
  
* ''User''<br>
+
''User''<br>
** '''user.total'''<br>Total number of existing objects.
+
* '''user.total'''<br>Total number of existing objects.
  
* ''Context''<br>
+
''Context''<br>
** '''context.total'''<br>Total number of existing objects.
+
* '''context.total'''<br>Total number of existing objects.
** '''context.released'''<br>Number of newly uploaded ''Implementations''; the value is only growing.
+
* '''context.released'''<br>Number of newly uploaded releases for specified time frame;
** '''context.failed'''<br>Number of newly uploaded failure ''Reports''; the value is only growing.
+
* '''context.retrieved'''<br>Number of retrieving of ''Context'' releases for specified time frame;
** '''context.downloaded'''<br>Number of ''Implementation'' downloads; the value is only growing.
+
* '''context.reported'''<br>Number of newly uploaded failure ''Reports'' for specified time frame;
  
* ''Review''<br>
+
''Post''<br>
** '''review.total'''<br>Total number of existing objects.
+
* '''post.total'''<br>Total number of existing objects.
 
 
* ''Feedback''<br>
 
** '''feedback.total'''<br>Total number of existing objects.
 
 
 
* ''Solution''<br>
 
** '''solution.total'''<br>Total number of existing objects.
 
 
 
* ''Artifact''<br>
 
** '''artifact.total'''<br>Total number of existing objects.
 
** '''artifact.downloaded'''<br>Number of downloads; the value is only growing.
 
 
 
* ''Comment''<br>
 
** '''comment.total'''<br>Total number of existing objects.
 
  
 
== Per object statistics ==
 
== Per object statistics ==
  
While calculating [[#Common_statistics|common]] statistics, the node will generate per object sums as well.
+
While calculating [[#Common_statistics|common]] statistics, nodes generate per object sums as well.
  
These are the Sugar Network [[Platform_Team/Sugar_Network/Objects_model|objects]] that will be affected:
+
These are the Sugar Network [[Sugar_Network/Resources|resources]] that will be affected:
  
* ''Context'' properties:
+
''Context'' properties:
** '''Context.downloads'''<br>Number of total downloads for the ''Context''.
+
* '''Context.rating'''<br>Average rating given to the ''Context'' while reviewing, rating value is a tuple of votes sum and number of reviews;
** '''Context.rating'''<br>Average rating given to the ''Context'' while reviewing.
+
* '''Context.retrieves'''<br>Number of retrieves of ''Context'' releases.
** '''Context.reviews'''<br>Number of ''Reviews''.
 
  
* ''Artifact'' properties:
+
''Post'' properties:
** '''Artifact.downloads'''<br>Number of total downloads for the ''Artifact''.
+
* '''Post.rating'''<br>Average rating given to the ''Post'' while reviewing, rating value is a tuple of votes sum and number of reviews.
** '''Artifact.rating'''<br>Average rating given to the ''Artifact'' while reviewing.
 
** '''Artifact.reviews'''<br>Number of ''Reviews''.
 
  
 
== Getting involved ==
 
== Getting involved ==
  
 
{{:Sugar_Network/Feedback}}
 
{{:Sugar_Network/Feedback}}

Revision as of 05:29, 8 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.

User

  • user.total
    Total number of existing objects.

Context

  • context.total
    Total number of existing objects.
  • context.released
    Number of newly uploaded releases for specified time frame;
  • context.retrieved
    Number of retrieving of Context releases for specified time frame;
  • context.reported
    Number of newly uploaded failure Reports for specified time frame;

Post

  • post.total
    Total number of existing 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.)