Changes

270 bytes added ,  17:26, 24 June 2014
Line 8: Line 8:  
=== Concepts ===
 
=== Concepts ===
   −
[[File:Harvest-diagram.png]]
+
[[File:Harvest-diagram-4.png]]
    
* Activities refers to the sugar applications that are being used.
 
* Activities refers to the sugar applications that are being used.
Line 14: Line 14:  
* Instances refers to the different entries of an particular activity, owned by one learner.
 
* Instances refers to the different entries of an particular activity, owned by one learner.
 
* Launches refers to the metadata associated with each time the instance is started.
 
* Launches refers to the metadata associated with each time the instance is started.
* Counters refers to the network traffic measurements being done by harvest-monitor.
+
* Counters refers to the network traffic measurements.
* Laptops refers to the miscellaneous system information.
      
=== Metadata ===
 
=== Metadata ===
Line 37: Line 36:  
|-
 
|-
 
|gender
 
|gender
|Gender of the user
+
|Gender of the user (either male, female, or unspecified by the user)
 
|String
 
|String
 
|-
 
|-
|Grouping
+
|grouping
 
|Custom group associated with his learner (see [[#Custom_Groups|Custom Groups]])
 
|Custom group associated with his learner (see [[#Custom_Groups|Custom Groups]])
 
|String
 
|String
Line 92: Line 91:  
|-
 
|-
 
|spent_time
 
|spent_time
|Time spent since the activity was opened and until the activities was closed
+
|seconds that the activity was opened (see [[#Spent_time|Spent time]])
 
|Integer
 
|Integer
 
|-
 
|-
 
|rowspan="3"|Counters
 
|rowspan="3"|Counters
 
|timestamp
 
|timestamp
|Time stamp for the beginning of the day
+
|Time stamp for the beginning of the day (see [[#Network_traffic|Network traffic]])
 
|Unix time
 
|Unix time
 
|-
 
|-
Line 200: Line 199:  
  ]}
 
  ]}
   −
=== Network traffic measurements ===
+
=== Network traffic ===
   −
Harvest-monitor is a lightweight daemon which uses custom iptables counters to do measurements on network traffic. This is an optional feature. If available, harvest-client will collect these measurements and report it to the server.  
+
Harvest-monitor is a lightweight daemon which uses custom iptables counters to do measurements on network traffic. These counters are then accumulated in a SQLite database, where each row presents a day. This is an optional feature. If available, harvest-client will collect these measurements and report it to the server.  
    
*The source code can be found at: https://github.com/tchx84/harvest-monitor
 
*The source code can be found at: https://github.com/tchx84/harvest-monitor
 
*The RPM package can be downloaded from: http://www.sugarlabs.org/~tch/repos/f18/harvest-monitor-0.2.0-2.noarch.rpm
 
*The RPM package can be downloaded from: http://www.sugarlabs.org/~tch/repos/f18/harvest-monitor-0.2.0-2.noarch.rpm
   −
=== Spent time tracking ===
+
=== Spent time ===
   −
This is based on downstream sugar-toolkit and sugar-toolkit-gtk3 patches by Manuel Quiñones and Martin Abente.
+
This is based on downstream sugar-toolkit and sugar-toolkit-gtk3 patches by Manuel Quiñones and Martin Abente. These patches allow the activities to count the time (in seconds) for when it was opened. Only takes into account the time for when activity is the main screen. This is also a optional feature.
    
* sugar-toolkit downstream pathches: https://github.com/manuq/sugar-toolkit/tree/spent-time
 
* sugar-toolkit downstream pathches: https://github.com/manuq/sugar-toolkit/tree/spent-time
 
* sugar-toolkit-gtk3 downstream patches: https://github.com/manuq/sugar-toolkit-gtk3/tree/spent-time-3
 
* sugar-toolkit-gtk3 downstream patches: https://github.com/manuq/sugar-toolkit-gtk3/tree/spent-time-3
   −
The precision of the time tracking can be improved by taking into account power management events and other sugar UI events. In order to do so, harvest-tracker must be used.
+
The precision of the time tracking can be improved by taking into account power management events and other sugar UI events. In order to do so, harvest-tracker must be installed.
    
* harvest-tracker source code: https://github.com/tchx84/harvest-tracker
 
* harvest-tracker source code: https://github.com/tchx84/harvest-tracker
* harvest-tracker package: http://www.sugarlabs.org/~tch/repos/f18/harvest-tracker-0.3.0-1.noarch.rpm
+
* harvest-tracker RPM package: http://www.sugarlabs.org/~tch/repos/f18/harvest-tracker-0.3.0-1.noarch.rpm
    
== RPMs ==
 
== RPMs ==
572

edits