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-15-635... http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-15... || 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=20...) | 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 we report || *Values* || Example || | *Content/* *Landing Page* | What *JBoss Tools version* is reporting? | * 1.0.0.v20100916-0700-H62-Beta1 * 1.0.0.v20100918-0552-H72-Beta1 * etc. | http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-15... (http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-15-946...) | | *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... (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... (http://community.jboss.org/servlet/JiveServlet/showImage/6332/visitor-typ...) | | *Language* | What *Locale* is Eclipse (Java Locale) set to? | * en-US * de-DE * fr-FR * etc. | http://community.jboss.org/servlet/JiveServlet/downloadImage/6333/languag... (http://community.jboss.org/servlet/JiveServlet/showImage/6333/language.png) | | *Locations* (Continent, Sub-, Region, City, etc.) | *Where* is Eclipse run (geographical location)? | * Europe (Continent) * Germany (Country) * Munich (City) | 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... (http://community.jboss.org/servlet/JiveServlet/showImage/6335/browser.png) http://community.jboss.org/servlet/JiveServlet/downloadImage/6339/browser... (http://community.jboss.org/servlet/JiveServlet/showImage/6339/browser-ver...) | | *Operating System* | What *OS* is JBoss Tools running on? | * Linux * Macintosh * Windows Individual Versions are tracked and might be queried in *Visitors* Unfortunately Linux versions do not get reported. You'll find this information in the *User Defined Value* * * | http://community.jboss.org/servlet/JiveServlet/downloadImage/6336/operati... (http://community.jboss.org/servlet/JiveServlet/showImage/6336/operating-s...) http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-15... (http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-15-934...) | | *User Defined Value* | What Linux distro is JBoss Tools running on | * Fedora13 * Ubuntu9.04 * etc. | http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-15... (http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-15-958...) | | *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-... (http://community.jboss.org/servlet/JiveServlet/showImage/6337/screen-colo...) | | *Screen Resolution* | What's the *screen resolution* the user's using? | * 1920x1080 * etc | http://community.jboss.org/servlet/JiveServlet/downloadImage/6340/screen-... (http://community.jboss.org/servlet/JiveServlet/showImage/6340/screen-reso...) | | *Flash Version* | What *Java Version* is Eclipse (and hence JBoss Tools) running on? | * 1.6.0_20 * 1.5.0_9 * etc. | http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-15... (http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-15-722...) | | *Connection Speed* | What *internet connection* is he using? | * T1 * Cable * etc. | http://community.jboss.org/servlet/JiveServlet/downloadImage/6341/connect... (http://community.jboss.org/servlet/JiveServlet/showImage/6341/connection-...) | * * -------------------------------------------------------------- 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&am...]