[jboss-user] [JBoss Tools] - What can we track with JBoss Tools usage reporting?

[Andre Dietisheim]

Andre Dietisheim [http://community.jboss.org/people/adietish] modified the document:

"What can we track with JBoss Tools usage reporting?"

To view the document, visit: http://community.jboss.org/docs/DOC-15798

--------------------------------------------------------------
h1. Preface
We maintain a Google Analytics account to track JBoss Tools usage. Google Analytics is designed to track web page usage but it might be adapted to track other applications. That's what we did for JBoss Tools and implemented an Eclipse plugin that shall help us to gather userfull informations about our users in an anonymous manner.
h1. How do we track users?
When a JBoss Tools user starts its eclipse he triggers a hit to  *http:///tools/usage/action/wsstartup /tools/usage/action/wsstartup* in our Google Analytics Account*.* There are other urls that are tracked (for instance /pureTest)*,* but these are not triggered by JBoss Tools users** and they're not relevant to our use case though*.* 


 http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-7-6353/Picture+2.png  http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-7-6353/441-116/Picture+2.png 


|| Url || *Event* ||
| *  /tools/usage/action/wsstartup (http://tools/usage/action/wsstartup)* | A JBoss Tools user starts its Eclipse |
| */pureTest* (http:///pureTest) | Test plugin JUnit tests are run |
|  */tools/usage.html*  (https://www.google.com/analytics/reporting/content?id=35061163&pdr=20100808-20100907&cmp=average&trows=10&gdfmt=nth_day#lts=1283955501535) | Users browse our usage page on jboss.org http://jboss.org/tools/usage.html |
h1. *What are the user values we track?*
Google Analytics is designed to track browsers and users browsing web sites. Our Eclipse plugin emulates a browser and reports values the way a browser would. Of course using JBoss Tools in Eclipse does not match the use case of browsing web pages at 100%. It's very close to it though. There are values that are unique to our use case (to track application usage) and are not present in browsers. We map those to values to settings Google Analytics tracks for browsers and misuse their original intent.

|| *Google Analytics Field* || Information
 || *Values* || Example ||
| *Keyword* | What are the *JBoss Tools components* that are installed? | * archives
* as
* birt
* bpel
* cdi
* deltacloud
* drools
* esb
* flow
* freemarker
* gwt
* hibernatetools
* jbpm
* jmx
* jsf
* jst
* labs
* maven
* modeshape
* portlet
* profiler
* runtime
* seam
* smooks
* struts
* tptp
* vpe
* workingset
* ws
* xulrunner
 |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6331/keyword.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6331/keyword.png) |
| *Visitor Type* | Is it a *new or a returning* User? | * New Visitor
* Returning Visitor |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6332/visitor-type.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6332/visitor-type.png) |
| *Language* | What *Locale* is Eclipse (Java Locale) set to? | * en-US
* de-DE
* fr-FR
* etc. |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6333/language.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6333/language.png) |
| *Locations*
(Continent, Sub-, Region, City, etc.) | *Where* is Eclipse run (geographical location)? |  |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6334/city.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6334/city.png) |
| *Browser* | What's the *Eclipse product* the user is running? | * JBoss Developer Studio
* JEE Eclipse
* etc.

Individual Versions are tracked in *Visitors* (Google Analytics section) |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6335/browser.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6335/browser.png)
 http://community.jboss.org/servlet/JiveServlet/downloadImage/6339/browser-versions.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6339/browser-versions.png) |
| *Operating System* | What *OS* is JBoss Tools running on? | * Linux
* Macintosh
* Windows |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6336/operating-systems.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6336/operating-systems.png) |
| *Screen Colors* | What is the *screen color depth* the user's using? | * 32-bit
* 24-bit
* etc. |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6337/screen-colors.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6337/screen-colors.png) |
| *Screen Resolution* | What's the *screen resolution* the user's using? | * 1920x1080
* etc |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6340/screen-resolution.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6340/screen-resolution.png) |
| *Connection Speed* | What *internet connection* is he using? | * T1
* Cable
* etc. |  http://community.jboss.org/servlet/JiveServlet/downloadImage/6341/connection-speed.png  (http://community.jboss.org/servlet/JiveServlet/showImage/6341/connection-speed.png) |
*
*
--------------------------------------------------------------

Comment by going to Community
[http://community.jboss.org/docs/DOC-15798]

Create a new document in JBoss Tools at Community
[http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2128]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-user/attachments/20100909/54385f33/attachment-0018.html