<div class="markdown">
<p dir="auto">On 11 Mar 2016, at 22:33, Brian Fitzpatrick wrote:</p>
<blockquote>
<p dir="auto">Thanks guys for updating the docs - that helps a ton. And I'll get this<br>
into SwitchYard soon. :)</p>
</blockquote>
<p dir="auto">Great!</p>
<p dir="auto">And I just did a small edit to clarify we are <em>not</em> tracking users we are tracking usage.<br>
Meaning users optin to submit statistics/events - they are not opting in to be tracked.</p>
<p dir="auto">Subtle, but very important distinction on what we are doing here.</p>
<p dir="auto">/max</p>
<blockquote>
<p dir="auto">On Fri, Mar 11, 2016 at 1:15 PM, Alexey Kazakov <a href="mailto:alkazako@redhat.com">alkazako@redhat.com</a> wrote:</p>
<blockquote>
<p dir="auto">Lars, you are correct.<br>
Having a dependency to the usage plugin in your manifest is enough to<br>
enable usage tracking itself (if users agreed to enable it).<br>
The snippet Max mentioned is needed to track some specific events (and<br>
that's snippet is not complete btw, see the doc). I guess Max just meant<br>
that if you have code like that it means you already have all needed<br>
dependencies etc, so the usage should work :)</p>
<p dir="auto">If you just added the needed dependencies then Usage will start tracking<br>
all basic stuff (startups, OSs, etc.) including all Wizards IDs. When a<br>
user click Finish on the Wizard then we count this event. So we have all<br>
used wizard IDs and how many times there were used.<br>
But if you need to track something else then you have to register a new<br>
event type and track it where needed. See the doc.</p>
<p dir="auto">I've updated the doc and removed this confusing stuff about the<br>
"UsageReporter.getInstance().countEvent(eventType.event(label,<br>
value));" snippet.<br>
I also added the section about the Wizard IDs tracking.</p>
<p dir="auto">Thanks.</p>
<p dir="auto">On 03/11/2016 02:03 PM, Lars Heinemann wrote:</p>
<blockquote>
<p dir="auto">From what I read here I can say we do not have a line<br>
like UsageReporter.getInstance().countEvent(...) anywhere in the Fuse<br>
Tooling. Back in time when asking how to get tracked if our tooling is<br>
installed / used the answer was put dependency to usage bundle into<br>
manifest. I did that and nothing more so far.</p>
<p dir="auto">Lars</p>
<p dir="auto">-------- Weitergeleitete Nachricht --------<br>
Von: Nick Boldt <a href="mailto:nboldt@redhat.com">nboldt@redhat.com</a><br>
An: Max Rydahl Andersen <a href="mailto:manderse@redhat.com">manderse@redhat.com</a><br>
Kopie: tools-dev <a href="mailto:jbosstools-dev@lists.jboss.org">jbosstools-dev@lists.jboss.org</a><br>
Betreff: Re: [jbosstools-dev] Hooking up Fuse Tools and SwitchYard with<br>
usage tracking<br>
Datum: Fri, 11 Mar 2016 13:44:48 -0500</p>
<p dir="auto">I have digested Max's comments here into the doc:</p>
<p dir="auto"><a href="https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/usage/u">https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/usage/u</a><br>
sage_api.adoc#enabling-usage-tracking-in-your-plugin</p>
<p dir="auto">Feel free to contribute fixes to that doc if you encounter more stuff<br>
you feel needs to be there.</p>
<p dir="auto">On Fri, Mar 11, 2016 at 12:47 PM, Max Rydahl Andersen<br>
<a href="mailto:manderse@redhat.com">manderse@redhat.com</a> wrote:</p>
<blockquote>
<p dir="auto">On 11 Mar 2016, at 18:31, Brian Fitzpatrick wrote:</p>
<blockquote>
<p dir="auto">Awesome. Thanks Max! Appreciate the guidance.</p>
</blockquote>
<p dir="auto">tip - if its the first time you are adding counting to a plugin for<br>
usage tracking<br>
I recommend you ask Alexey, Fred or me to review it to catch too<br>
aggressive or too passive counting issues.</p>
<p dir="auto">/max</p>
<blockquote>
<p dir="auto">On Fri, Mar 11, 2016 at 10:23 AM, Max Rydahl Andersen<br>
<a href="mailto:manderse@redhat.com">manderse@redhat.com</a><br>
wrote:</p>
<blockquote>
<p dir="auto">On 11 Mar 2016, at 18:12, Brian Fitzpatrick wrote:</p>
<p dir="auto">When you say "Wizards should already be there as long as SY and<br>
Fuse<br>
depend<br>
on the usage plug-in." what do you mean?</p>
<p dir="auto">hmm - just realised that is missing from the docs...pretty sure<br>
it<br>
was<br>
there at some point.</p>
<p dir="auto">For basic enablement add dependency to: org.jboss.tools.usage<br>
like in<br>
<a href="https://github.com/jbosstools/jbosstools-server/blob/jbosstools-4">https://github.com/jbosstools/jbosstools-server/blob/jbosstools-4</a><br>
.2.0.Beta1x/as/plugins/org.jboss.ide.eclipse.as.ui/META-<br>
INF/MANIFEST.MF#L67</p>
<p dir="auto">Can I interpret that as meaning if our tools ping for daily<br>
events as<br>
in<br>
the example below, our wizard usage will already be recorded?</p>
<p dir="auto">Wizard usage will be recorded as soon as the usage reporter is<br>
installed<br>
(and of course if the user said yes to be tracked)</p>
<p dir="auto">UsageReporter.getInstance().countEvent(eventType.event(label,<br>
value));</p>
<p dir="auto">If you have code like the above then you for sure should already<br>
be<br>
covered for sure ;)</p>
<p dir="auto">/max</p>
<p dir="auto">On Fri, Mar 11, 2016 at 10:08 AM, Max Rydahl Andersen<br>
<a href="mailto:manderse@redhat.com">manderse@redhat.com</a><br>
wrote:</p>
<p dir="auto">On 11 Mar 2016, at 18:01, Brian Fitzpatrick wrote:</p>
<p dir="auto">Hi all,</p>
<p dir="auto">Back in January I received great help from Alexey and Max to help<br>
me<br>
take<br>
a<br>
look at the usage data we've been tracking for JBDS. It really<br>
helped<br>
get<br>
some baseline numbers for ESB usage so we could justify<br>
deprecation<br>
of the<br>
older tooling going forward (still supporting, just not actively<br>
updating,<br>
which is how it's been for a few years now anyway).</p>
<p dir="auto">Now we'd like to hook SwitchYard and Fuse Tools wizards and<br>
editors<br>
up to<br>
get them into the tracking data as well.</p>
<p dir="auto">Wizards should already be there as long as SY and Fuse depend on<br>
the<br>
usage<br>
plugin.</p>
<p dir="auto">For editors you will need to send specific events.</p>
<p dir="auto">Do we have anything written up on how to use the frameworks for<br>
the<br>
usage</p>
<p dir="auto">tooling in JBDS? Or can you point me at some examples of how<br>
you've<br>
done<br>
it<br>
for wizards and editors in the main JBoss Tools code?</p>
<p dir="auto">Docs:</p>
<p dir="auto"><a href="https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/u">https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/u</a><br>
sage/usage_api.adoc</p>
<p dir="auto">Please be aware to not send a ping for every little thing - we<br>
don't<br>
want<br>
to overload with data.</p>
<p dir="auto">But for example if you want to count the number of times the fuse<br>
editor<br>
is opened you can do that with a daily event counter.</p>
<p dir="auto">To find examples - search for .countEvent() in JBoss Tools Server<br>
and<br>
I<br>
think Forge has some too.</p>
<p dir="auto">/max<br>
<a href="http://about.me/maxandersen">http://about.me/maxandersen</a></p>
<p dir="auto">/max<br>
<a href="http://about.me/maxandersen">http://about.me/maxandersen</a></p>
</blockquote>
</blockquote>
<p dir="auto">/max<br>
<a href="http://about.me/maxandersen">http://about.me/maxandersen</a></p>
<hr>
<p dir="auto">jbosstools-dev mailing list<br>
<a href="mailto:jbosstools-dev@lists.jboss.org">jbosstools-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/jbosstools-dev">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a></p>
</blockquote>
<hr>
<p dir="auto">jbosstools-dev mailing list<br>
<a href="mailto:jbosstools-dev@lists.jboss.org">jbosstools-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/jbosstools-dev">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a></p>
</blockquote>
<hr>
<p dir="auto">jbosstools-dev mailing list<br>
<a href="mailto:jbosstools-dev@lists.jboss.org">jbosstools-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/jbosstools-dev">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a></p>
</blockquote>
<hr>
<p dir="auto">jbosstools-dev mailing list<br>
<a href="mailto:jbosstools-dev@lists.jboss.org">jbosstools-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/jbosstools-dev">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a></p>
</blockquote>
<p dir="auto">/max<br>
<a href="http://about.me/maxandersen">http://about.me/maxandersen</a></p>
</div>