<div dir="ltr">Thanks guys for updating the docs - that helps a ton. And I'll get this into SwitchYard soon. :)<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Mar 11, 2016 at 1:15 PM, Alexey Kazakov <span dir="ltr"><<a href="mailto:alkazako@redhat.com" target="_blank">alkazako@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">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 :)<br>
<br>
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.<br>
<br>
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.<br>
<br>
Thanks.<br>
<div class="HOEnZb"><div class="h5"><br>
On 03/11/2016 02:03 PM, Lars Heinemann wrote:<br>
> 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.<br>
><br>
> Lars<br>
><br>
> -------- 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<br>
><br>
> I have digested Max's comments here into the doc:<br>
><br>
> <a href="https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/usage/u" rel="noreferrer" target="_blank">https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/usage/u</a><br>
> sage_api.adoc#enabling-usage-tracking-in-your-plugin<br>
><br>
> Feel free to contribute fixes to that doc if you encounter more stuff<br>
> you feel needs to be there.<br>
><br>
> On Fri, Mar 11, 2016 at 12:47 PM, Max Rydahl Andersen<br>
> <<a href="mailto:manderse@redhat.com">manderse@redhat.com</a>> wrote:<br>
>> On 11 Mar 2016, at 18:31, Brian Fitzpatrick wrote:<br>
>><br>
>>> Awesome. Thanks Max! Appreciate the guidance.<br>
>> 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.<br>
>><br>
>> /max<br>
>><br>
>>><br>
>>> 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:<br>
>>><br>
>>>> On 11 Mar 2016, at 18:12, Brian Fitzpatrick wrote:<br>
>>>><br>
>>>> 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?<br>
>>>><br>
>>>> hmm - just realised that is missing from the docs...pretty sure<br>
>>>> it<br>
>>>> was<br>
>>>> there at some point.<br>
>>>><br>
>>>> 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" rel="noreferrer" target="_blank">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<br>
>>>><br>
>>>> 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?<br>
>>>><br>
>>>> 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)<br>
>>>><br>
>>>> UsageReporter.getInstance().countEvent(eventType.event(label,<br>
>>>> value));<br>
>>>><br>
>>>> If you have code like the above then you for sure should already<br>
>>>> be<br>
>>>> covered for sure ;)<br>
>>>><br>
>>>> /max<br>
>>>><br>
>>>> 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:<br>
>>>><br>
>>>> On 11 Mar 2016, at 18:01, Brian Fitzpatrick wrote:<br>
>>>><br>
>>>> Hi all,<br>
>>>><br>
>>>> 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).<br>
>>>><br>
>>>> 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.<br>
>>>><br>
>>>> Wizards should already be there as long as SY and Fuse depend on<br>
>>>> the<br>
>>>> usage<br>
>>>> plugin.<br>
>>>><br>
>>>> For editors you will need to send specific events.<br>
>>>><br>
>>>> Do we have anything written up on how to use the frameworks for<br>
>>>> the<br>
>>>> usage<br>
>>>><br>
>>>> 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?<br>
>>>><br>
>>>> Docs:<br>
>>>><br>
>>>> <a href="https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/u" rel="noreferrer" target="_blank">https://github.com/jbosstools/jbosstools-devdoc/blob/master/api/u</a><br>
>>>> sage/usage_api.adoc<br>
>>>><br>
>>>> Please be aware to not send a ping for every little thing - we<br>
>>>> don't<br>
>>>> want<br>
>>>> to overload with data.<br>
>>>><br>
>>>> 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.<br>
>>>><br>
>>>> To find examples - search for .countEvent() in JBoss Tools Server<br>
>>>> and<br>
>>>> I<br>
>>>> think Forge has some too.<br>
>>>><br>
>>>> /max<br>
>>>> <a href="http://about.me/maxandersen" rel="noreferrer" target="_blank">http://about.me/maxandersen</a><br>
>>>><br>
>>>> /max<br>
>>>> <a href="http://about.me/maxandersen" rel="noreferrer" target="_blank">http://about.me/maxandersen</a><br>
>>>><br>
>> /max<br>
>> <a href="http://about.me/maxandersen" rel="noreferrer" target="_blank">http://about.me/maxandersen</a><br>
>><br>
>> _______________________________________________<br>
>> 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" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a><br>
><br>
> _______________________________________________<br>
> 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" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a><br>
<br>
_______________________________________________<br>
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" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/jbosstools-dev</a><br>
</div></div></blockquote></div><br></div>