Line 2: |
Line 2: |
| | | |
| 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). | | 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). |
| + | |
| + | == Counter types == |
| + | |
| + | [[#Statistics|Measured]] statistics values might be one of the following types: |
| + | |
| + | * ''absolute''<br>value to use as-is, e.g., amount of free disk space; |
| + | * ''uptime''<br>number of seconds since event start, e.g., how long window is active; if event is not active, value will be reset to zero; |
| + | * ''relative-count''<br>a counter, number of times event was registered since event start; if event is not active, value will be reset to zero; |
| + | * ''absolute-count''<br>counter value that is being incremented all time without resetting to zero. |
| | | |
| == Statistics == | | == Statistics == |
Line 8: |
Line 17: |
| | | |
| * '''''shell'''''<br>Shell related stats. | | * '''''shell'''''<br>Shell related stats. |
− | ** '''shell.uptime'''<br>How long Shell is running. | + | ** '''shell.uptime''' ''uptime''<br>How long Shell is running. |
− | ** '''shell.active'''<br>How long Shell window is on top. | + | ** '''shell.active''' ''uptime''<br>How long Shell window is on top. |
− | ** '''shell.friends'''<br>Number of buddies in the Groups view. | + | ** '''shell.friends''' ''absolute''<br>Number of buddies in the Groups view. |
| * '''''journal'''''<br>Journal related activity. | | * '''''journal'''''<br>Journal related activity. |
− | ** '''journal.uptime'''<br>How long Journal is running. | + | ** '''journal.uptime''' ''uptime''<br>How long Journal is running. |
− | ** '''journal.active'''<br>How long Journal window is on top. | + | ** '''journal.active''' ''uptime''<br>How long Journal window is on top. |
− | ** '''journal.creates'''<br>Number of create requests sent from the Journal window. | + | ** '''journal.creates''' ''relative-count''<br>Number of create requests sent from the Journal window. |
− | ** '''journal.updates'''<br>Number of update requests sent from the Journal window. | + | ** '''journal.updates''' ''relative-count''<br>Number of update requests sent from the Journal window. |
− | ** '''journal.deletes'''<br>Number of delete requests sent from the Journal window. | + | ** '''journal.deletes''' ''relative-count''<br>Number of delete requests sent from the Journal window. |
| * '''''activity'''''<br>Activities related stats; specified only for the particular activity. | | * '''''activity'''''<br>Activities related stats; specified only for the particular activity. |
− | ** '''activity.uptime'''<br>How long Activity is running. | + | ** '''activity.uptime''' ''uptime''<br>How long Activity is running. |
− | ** '''activity.active'''<br>How long Activity window is on top. | + | ** '''activity.active''' ''uptime''<br>How long Activity window is on top. |
− | ** '''activity.instances'''<br>How many instances launched. | + | ** '''activity.instances''' ''absolute-count''<br>How many instances launched. |
− | ** '''activity.new'''<br>How many running instances with new Journal entity. | + | ** '''activity.new''' ''relative-count''<br>How many running instances with new Journal entity. |
− | ** '''activity.resumed'''<br>How many running instances with resumed Journal entity. | + | ** '''activity.resumed''' ''relative-count''<br>How many running instances with resumed Journal entity. |
− | ** '''activity.buddies'''<br>Number of buddies Activity is interacting with for all running instances. | + | ** '''activity.buddies''' ''absolute-count''<br>Number of buddies Activity is interacting with for all running instances. |
| * '''''application'''''<br>Applications related stats in non-Sugar mode; specified only for the particular application. | | * '''''application'''''<br>Applications related stats in non-Sugar mode; specified only for the particular application. |
− | ** '''application.uptime'''<br>How long application is running. | + | ** '''application.uptime''' ''uptime''<br>How long application is running. |
− | ** '''application.active'''<br>How long application window is on top. | + | ** '''application.active''' ''uptime''<br>How long application window is on top. |
| * '''''network'''''<br>Network related stats. | | * '''''network'''''<br>Network related stats. |
− | ** '''network.uptime'''<br>How long client is connected to the Internet. | + | ** '''network.uptime''' ''uptime''<br>How long client is connected to the Internet. |
− | ** '''network.school'''<br>How long client is connected to school network. | + | ** '''network.school''' ''uptime''<br>How long client is connected to school network. |
| * '''''system'''''<br>System related stats. | | * '''''system'''''<br>System related stats. |
− | ** '''system.uptime'''<br>System uptime value. | + | ** '''system.uptime''' ''uptime''<br>System uptime value. |
− | ** '''system.diskfree'''<br>How many storage space is free, in kilobytes, for the home directory. | + | ** '''system.diskfree''' ''absolute''<br>How many storage space is free, in kilobytes, for the home directory. |
| | | |
| == Implementation == | | == Implementation == |