<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
What can we track with JBoss Tools usage reporting?
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/adietish">Andre Dietisheim</a> in <i>JBoss Tools</i> - <a href="http://community.jboss.org/docs/DOC-15798">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><h1>Preface</h1><p>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.</p><h1>How do we track users?</h1><p>When a JBoss Tools user starts its eclipse he triggers a hit to <strong style="font-weight: bold;"><a class="jive-link-external-small" href="http:///tools/usage/action/wsstartup"><strong style="font-weight: bold;"><strong style="font-weight: bold;">/tools/usage/action/wsstartup</strong></strong></a> </strong>in our Google Analytics Account<strong style="font-weight: bold;">. </strong>There are other urls that are tracked (for instance /pureTest)<strong style="font-weight: bold;">, </strong>but these are not triggered by JBoss Tools users<strong style="font-weight: bold;"> </strong>and they're not relevant to our use case though<strong style="font-weight: bold;">. </strong></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="text-align: center;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-8-6353/Picture+2.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-8-6353/441-116/Picture+2.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 100%; border: 1px solid #999999; background-color: #eaeaea;"><tbody><tr><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Url</th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong style="font-weight: bold;">Event</strong></span></th></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;"> <a class="jive-link-external-small" href="http://tools/usage/action/wsstartup"><strong style="font-weight: bold;"><strong style="font-weight: bold;"> /tools/usage/action/wsstartup</strong></strong></a></strong></td><td style=" border: 1px solid #999999;">A JBoss Tools user starts its Eclipse</td></tr><tr><td style=" border: 1px solid #999999;"><a class="jive-link-external-small" href="http:///pureTest"><strong style="font-weight: bold;">/pureTest</strong></a></td><td style=" border: 1px solid #999999;">Test plugin JUnit tests are run</td></tr><tr><td style=" border: 1px solid #999999;"><div class="text_wrapper" title="/tools/usage.html"><div class="text_wrapper"><a class="jive-link-external-small" href="https://www.google.com/analytics/reporting/content?id=35061163&pdr=20100808-20100907&cmp=average&trows=10&gdfmt=nth_day#lts=1283955501535"> <strong style="font-weight: bold;">/tools/usage.html </strong></a></div></div></td><td style=" border: 1px solid #999999;">Users browse our usage page on jboss.org <a class="jive-link-external-small" href="http://jboss.org/tools/usage.html">http://jboss.org/tools/usage.html</a></td></tr></tbody></table><h1><strong style="font-weight: bold;">What are the user values we track?</strong></h1><p>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.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 100%; border: 1px solid #999999; background-color: #eaeaea;"><tbody><tr><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong style="font-weight: bold;">Google Analytics Field</strong></span></th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Information we report</th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong style="font-weight: bold;">Values</strong></span></th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Example</th></tr><tr><td align="left" style=" border: 1px solid #999999;" valign="top"><strong style="font-weight: bold;">Keyword</strong></td><td align="left" style=" border: 1px solid #999999;" valign="top">What are the <strong style="font-weight: bold;">JBoss Tools components</strong> that are installed?</td><td align="left" style=" border: 1px solid #999999;" valign="top"><ul><li>archives</li><li>as</li><li>birt</li><li>bpel</li><li>cdi</li><li>deltacloud</li><li>drools</li><li>esb</li><li>flow</li><li>freemarker</li><li>gwt</li><li>hibernatetools</li><li>jbpm</li><li>jmx</li><li>jsf</li><li>jst</li><li>labs</li><li>maven</li><li>modeshape</li><li>portlet</li><li>profiler</li><li>runtime</li><li>seam</li><li>smooks</li><li>struts</li><li>tptp</li><li>vpe</li><li>workingset</li><li>ws</li><li>xulrunner</li></ul><ul></ul></td><td align="left" style=" border: 1px solid #999999;" valign="top"><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6331/keyword.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6331/keyword.png </span></a></p></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Visitor Type</strong></td><td style=" border: 1px solid #999999;">Is it a <strong style="font-weight: bold;">new or a returning</strong> User?</td><td style=" border: 1px solid #999999;"><ul><li>New Visitor</li><li>Returning Visitor</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6332/visitor-type.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6332/visitor-type.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Language</strong></td><td style=" border: 1px solid #999999;">What <strong style="font-weight: bold;">Locale</strong> is Eclipse (Java Locale) set to?</td><td style=" border: 1px solid #999999;"><ul><li>en-US</li><li>de-DE</li><li>fr-FR</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6333/language.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6333/language.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><p><strong style="font-weight: bold;">Locations</strong></p><p>(Continent, Sub-, Region, City, etc.)</p></td><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Where</strong> is Eclipse run (geographical location)?</td><td style=" border: 1px solid #999999;"></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6334/city.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6334/city.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Browser</strong></td><td style=" border: 1px solid #999999;">What's the <strong style="font-weight: bold;">Eclipse product</strong> the user is running?</td><td style=" border: 1px solid #999999;"><ul><li>JBoss Developer Studio</li><li>JEE Eclipse</li><li>etc.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Individual Versions are tracked in <strong style="font-weight: bold;">Visitors </strong>(Google Analytics section)</p></td><td style=" border: 1px solid #999999;"><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6335/browser.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6335/browser.png </span></a></p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6339/browser-versions.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6339/browser-versions.png </span></a></p></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Operating System</strong></td><td style=" border: 1px solid #999999;">What <strong style="font-weight: bold;">OS</strong> is JBoss Tools running on?</td><td style=" border: 1px solid #999999;"><ul><li>Linux</li><li>Macintosh</li><li>Windows</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6336/operating-systems.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6336/operating-systems.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Screen Colors</strong></td><td style=" border: 1px solid #999999;">What is the <strong style="font-weight: bold;">screen color depth</strong> the user's using?</td><td style=" border: 1px solid #999999;"><ul><li>32-bit</li><li>24-bit</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6337/screen-colors.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6337/screen-colors.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Screen Resolution</strong></td><td style=" border: 1px solid #999999;">What's the <strong style="font-weight: bold;">screen resolution</strong> the user's using?</td><td style=" border: 1px solid #999999;"><ul><li>1920x1080</li><li>etc</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6340/screen-resolution.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6340/screen-resolution.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Flash Version</strong></td><td style=" border: 1px solid #999999;">What <strong>Java Version </strong>is Eclipse (and hence JBoss Tools) running on?</td><td style=" border: 1px solid #999999;"><ul><li>1.6.0_20</li><li>1.5.0_9</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-8-7224/flash-version.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-8-7224/350-70/flash-version.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong style="font-weight: bold;">Connection Speed</strong></td><td style=" border: 1px solid #999999;">What <strong style="font-weight: bold;">internet connection</strong> is he using?</td><td style=" border: 1px solid #999999;"><ul><li>T1</li><li>Cable</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6341/connection-speed.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6341/connection-speed.png </span></a></td></tr></tbody></table><p><strong style="font-weight: bold;"><br/></strong></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-15798">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Tools at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2128">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>