* [lttng-dev] LTTng Tools 2.1 streaming commands @ 2012-10-03 18:17 Bernd Hufmann 2012-10-03 18:27 ` David Goulet 2012-10-09 19:08 ` David Goulet 0 siblings, 2 replies; 7+ messages in thread From: Bernd Hufmann @ 2012-10-03 18:17 UTC (permalink / raw) Hello For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to understand how to use the configuration for network streaming with the updated "lttng create"-command and new "enable-consumer"-command. a) lttng enable-consumer I find this command confusing because this command does not always enables the consumer, even if the command name implies so. The enabling actually depends on how the command is executed. Examples: * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" don't enable the consumer. You need to either add option --enable or execute subsequently "lttng enable-consumer --enable" * lttng enable-consumer -k net://<remote_addr> does enable the consumer. I took me a while to figure out the difference to the example above: The option -U is omitted. What the command actually provides, is 2 features: A way to configure streaming (e.g. remote_addr) and a way to enable the consumer. Would it be better to name it to "lttng configure-consumer"? Also, remove the support of the possibility to not specify -U, -C or -D. The following variants of this command should be enough: lttng configure-consumer -k -U <remote_addr> [--enable] lttng configure-consumer -k -C <remote_addr> -D <remote_addr> [--enable] lttng configure-consumer -k --enable lttng configure-consumer -u -U <remote_addr> [--enable] lttng configure-consumer -u -C <remote_addr> -D <remote_addr> [--enable] lttng configure-consumer -u --enable Please let me know what you think. b) lttng create [-U <remote_addr>] | [-C <remote_addr> -D <remote_addr>] [--no-consumer] [--disable-consumer] * Are options --no-consumer or --disable-consumer only applicable for streaming? * I'm not sure what is the purpose of the options --no-consumer or --disable-consumer. Could you please explain the use cases for using --no-consumer or --disable-consumer? Thanks Bernd This Communication is Confidential. We only send and receive email on the basis of the terms set out at www.ericsson.com/email_disclaimer -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.lttng.org/pipermail/lttng-dev/attachments/20121003/15b1fc14/attachment-0001.html> ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-03 18:17 [lttng-dev] LTTng Tools 2.1 streaming commands Bernd Hufmann @ 2012-10-03 18:27 ` David Goulet 2012-10-05 11:44 ` eamcs/eedbhu 2012-10-09 19:08 ` David Goulet 1 sibling, 1 reply; 7+ messages in thread From: David Goulet @ 2012-10-03 18:27 UTC (permalink / raw) Hi Bernd, The enable-consumer, by default, always enable a consumer. We added the "extended options" such as the -U/-C/-D/-e to control each part of the API. So let say, $ lttng enable-consumer -k net://localhost This command does two API calls underneath which are lttng_set_consumer_uri and lttng_enable_consumer. However, the set_consumer_uri can be arbitrary long because it has to connect to the relayd (if remote) and set the session. It adds "unknown" latency to the command. So, for someone willing to control the full time window of the streaming setup using the API, it is divided in two calls. This is why we added the extended options so the command line UI could also be controlled on a per API call basis. Is it clear enough? Reply continues below: Bernd Hufmann: > Hello > > For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to > understand how to use the configuration for network streaming with the > updated "lttng create"-command and new "enable-consumer"-command. > > a) lttng enable-consumer > I find this command confusing because this command does not always > enables the consumer, even if the command name implieeees so. The enabling > actually depends on how the command is executed. > Examples: > > * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng > enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" > don't enable the consumer. You need to either add option --enable or > execute subsequently "lttng enable-consumer --enable" > * lttng enable-consumer -k net://<remote_addr> does enable the > consumer. I took me a while to figure out the difference to the > example above: The option -U is omitted. > > > What the command actually provides, is 2 features: A way to configure > streaming (e.g. remote_addr) and a way to enable the consumer. Would it > be better to name it to "lttng configure-consumer"? Also, remove the > support of the possibility to not specify -U, -C or -D. The following > variants of this command should be enough: > lttng configure-consumer -k -U <remote_addr> [--enable] > lttng configure-consumer -k -C <remote_addr> -D <remote_addr> [--enable] > lttng configure-consumer -k --enable > lttng configure-consumer -u -U <remote_addr> [--enable] > lttng configure-consumer -u -C <remote_addr> -D <remote_addr> [--enable] > lttng configure-consumer -u --enable > > Please let me know what you think. > > b) lttng create [-U <remote_addr>] | [-C <remote_addr> -D <remote_addr>] > [--no-consumer] [--disable-consumer] > > * Are options --no-consumer or --disable-consumer only applicable for > streaming? No, also for local consumer. > * I'm not sure what is the purpose of the options --no-consumer or > --disable-consumer. Could you please explain the use cases for using > --no-consumer or --disable-consumer? This basically disable the consumer for a tracing session. It's not very useful for now but for upcoming snapshots and live tracing, it will make way more sense! :). Again, same idea, the API can control the consumer "state" (enable/disable), so we added these options for the UI. Cheers! David > > > Thanks > Bernd > > This Communication is Confidential. We only send and receive email on > the basis of the terms set out at _www.ericsson.com/email_disclaimer_ > > > > > This body part will be downloaded on demand. ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-03 18:27 ` David Goulet @ 2012-10-05 11:44 ` eamcs/eedbhu 2012-10-05 13:13 ` David Goulet 0 siblings, 1 reply; 7+ messages in thread From: eamcs/eedbhu @ 2012-10-05 11:44 UTC (permalink / raw) Hi David thanks for the detailed explanation. I'm not debating the purpose of the command or that a 2 step approach is supported for enabling the consumer. As you described it makes sense to have this possibility. However I'm debating mainly the name of the command "enable-consumer". The command suggests that the consumer will be enabled when executing the command. I foresee that a lot of users expect that the consumer is enabled after the command execution. I think, a different name would improve the user experience. Best Regards Bernd On 10/03/2012 02:27 PM, David Goulet wrote: > Hi Bernd, > > The enable-consumer, by default, always enable a consumer. We added the > "extended options" such as the -U/-C/-D/-e to control each part of the > API. So let say, > > $ lttng enable-consumer -k net://localhost > > This command does two API calls underneath which are > lttng_set_consumer_uri and lttng_enable_consumer. > > However, the set_consumer_uri can be arbitrary long because it has to > connect to the relayd (if remote) and set the session. It adds "unknown" > latency to the command. So, for someone willing to control the full time > window of the streaming setup using the API, it is divided in two calls. > > This is why we added the extended options so the command line UI could > also be controlled on a per API call basis. > > Is it clear enough? > > Reply continues below: > > Bernd Hufmann: >> Hello >> >> For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to >> understand how to use the configuration for network streaming with the >> updated "lttng create"-command and new "enable-consumer"-command. >> >> a) lttng enable-consumer >> I find this command confusing because this command does not always >> enables the consumer, even if the command name implieeees so. The enabling >> actually depends on how the command is executed. >> Examples: >> >> * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng >> enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" >> don't enable the consumer. You need to either add option --enable or >> execute subsequently "lttng enable-consumer --enable" >> * lttng enable-consumer -k net://<remote_addr> does enable the >> consumer. I took me a while to figure out the difference to the >> example above: The option -U is omitted. >> >> >> What the command actually provides, is 2 features: A way to configure >> streaming (e.g. remote_addr) and a way to enable the consumer. Would it >> be better to name it to "lttng configure-consumer"? Also, remove the >> support of the possibility to not specify -U, -C or -D. The following >> variants of this command should be enough: >> lttng configure-consumer -k -U<remote_addr> [--enable] >> lttng configure-consumer -k -C<remote_addr> -D<remote_addr> [--enable] >> lttng configure-consumer -k --enable >> lttng configure-consumer -u -U<remote_addr> [--enable] >> lttng configure-consumer -u -C<remote_addr> -D<remote_addr> [--enable] >> lttng configure-consumer -u --enable >> >> Please let me know what you think. >> >> b) lttng create [-U<remote_addr>] | [-C<remote_addr> -D<remote_addr>] >> [--no-consumer] [--disable-consumer] >> >> * Are options --no-consumer or --disable-consumer only applicable for >> streaming? > No, also for local consumer. > >> * I'm not sure what is the purpose of the options --no-consumer or >> --disable-consumer. Could you please explain the use cases for using >> --no-consumer or --disable-consumer? > This basically disable the consumer for a tracing session. It's not very > useful for now but for upcoming snapshots and live tracing, it will make > way more sense! :). > > Again, same idea, the API can control the consumer "state" > (enable/disable), so we added these options for the UI. > > Cheers! > David > >> >> Thanks >> Bernd >> >> This Communication is Confidential. We only send and receive email on >> the basis of the terms set out at _www.ericsson.com/email_disclaimer_ >> >> >> >> >> This body part will be downloaded on demand. ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-05 11:44 ` eamcs/eedbhu @ 2012-10-05 13:13 ` David Goulet 0 siblings, 0 replies; 7+ messages in thread From: David Goulet @ 2012-10-05 13:13 UTC (permalink / raw) Right. I guess this discussion can continue and we can come up with a community consensus. This is a matter of UI naming so it should be decided now before we release stable since for the complete 2.x cycle we'll have to support this. Anyone wants to ship in here? Thanks! David eamcs/eedbhu: > Hi David > > thanks for the detailed explanation. > > I'm not debating the purpose of the command or that a 2 step approach is > supported for enabling the consumer. As you described it makes sense to > have this possibility. > > However I'm debating mainly the name of the command "enable-consumer". > The command suggests that the consumer will be enabled when executing > the command. I foresee that a lot of users expect that the consumer is > enabled after the command execution. I think, a different name would > improve the user experience. > > Best Regards > Bernd > > On 10/03/2012 02:27 PM, David Goulet wrote: >> Hi Bernd, >> >> The enable-consumer, by default, always enable a consumer. We added the >> "extended options" such as the -U/-C/-D/-e to control each part of the >> API. So let say, >> >> $ lttng enable-consumer -k net://localhost >> >> This command does two API calls underneath which are >> lttng_set_consumer_uri and lttng_enable_consumer. >> >> However, the set_consumer_uri can be arbitrary long because it has to >> connect to the relayd (if remote) and set the session. It adds "unknown" >> latency to the command. So, for someone willing to control the full time >> window of the streaming setup using the API, it is divided in two calls. >> >> This is why we added the extended options so the command line UI could >> also be controlled on a per API call basis. >> >> Is it clear enough? >> >> Reply continues below: >> >> Bernd Hufmann: >>> Hello >>> >>> For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to >>> understand how to use the configuration for network streaming with the >>> updated "lttng create"-command and new "enable-consumer"-command. >>> >>> a) lttng enable-consumer >>> I find this command confusing because this command does not always >>> enables the consumer, even if the command name implieeees so. The >>> enabling >>> actually depends on how the command is executed. >>> Examples: >>> >>> * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng >>> enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" >>> don't enable the consumer. You need to either add option >>> --enable or >>> execute subsequently "lttng enable-consumer --enable" >>> * lttng enable-consumer -k net://<remote_addr> does enable the >>> consumer. I took me a while to figure out the difference to the >>> example above: The option -U is omitted. >>> >>> >>> What the command actually provides, is 2 features: A way to configure >>> streaming (e.g. remote_addr) and a way to enable the consumer. Would it >>> be better to name it to "lttng configure-consumer"? Also, remove the >>> support of the possibility to not specify -U, -C or -D. The following >>> variants of this command should be enough: >>> lttng configure-consumer -k -U<remote_addr> [--enable] >>> lttng configure-consumer -k -C<remote_addr> -D<remote_addr> [--enable] >>> lttng configure-consumer -k --enable >>> lttng configure-consumer -u -U<remote_addr> [--enable] >>> lttng configure-consumer -u -C<remote_addr> -D<remote_addr> [--enable] >>> lttng configure-consumer -u --enable >>> >>> Please let me know what you think. >>> >>> b) lttng create [-U<remote_addr>] | [-C<remote_addr> -D<remote_addr>] >>> [--no-consumer] [--disable-consumer] >>> >>> * Are options --no-consumer or --disable-consumer only applicable for >>> streaming? >> No, also for local consumer. >> >>> * I'm not sure what is the purpose of the options --no-consumer or >>> --disable-consumer. Could you please explain the use cases for >>> using >>> --no-consumer or --disable-consumer? >> This basically disable the consumer for a tracing session. It's not very >> useful for now but for upcoming snapshots and live tracing, it will make >> way more sense! :). >> >> Again, same idea, the API can control the consumer "state" >> (enable/disable), so we added these options for the UI. >> >> Cheers! >> David >> >>> >>> Thanks >>> Bernd >>> >>> This Communication is Confidential. We only send and receive email on >>> the basis of the terms set out at _www.ericsson.com/email_disclaimer_ >>> >>> >>> >>> >>> This body part will be downloaded on demand. > > > _______________________________________________ > lttng-dev mailing list > lttng-dev at lists.lttng.org > http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-03 18:17 [lttng-dev] LTTng Tools 2.1 streaming commands Bernd Hufmann 2012-10-03 18:27 ` David Goulet @ 2012-10-09 19:08 ` David Goulet 2012-10-09 21:18 ` Matthew Khouzam 2012-10-10 13:20 ` Bernd Hufmann 1 sibling, 2 replies; 7+ messages in thread From: David Goulet @ 2012-10-09 19:08 UTC (permalink / raw) After talking a bit about this issue with other LTTng devs, it turns out that it makes more sense to have a "set-consumer" command and remove enable/disable-consumer from the cmd UI. I'll send a proposal on lttng-dev in the next days and please, everyone, feel free to give feedbacks on this. Thanks! David Bernd Hufmann: > Hello > > For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to > understand how to use the configuration for network streaming with the > updated "lttng create"-command and new "enable-consumer"-command. > > a) lttng enable-consumer > I find this command confusing because this command does not always > enables the consumer, even if the command name implies so. The enabling > actually depends on how the command is executed. > Examples: > > * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng > enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" > don't enable the consumer. You need to either add option --enable or > execute subsequently "lttng enable-consumer --enable" > * lttng enable-consumer -k net://<remote_addr> does enable the > consumer. I took me a while to figure out the difference to the > example above: The option -U is omitted. > > > What the command actually provides, is 2 features: A way to configure > streaming (e.g. remote_addr) and a way to enable the consumer. Would it > be better to name it to "lttng configure-consumer"? Also, remove the > support of the possibility to not specify -U, -C or -D. The following > variants of this command should be enough: > lttng configure-consumer -k -U <remote_addr> [--enable] > lttng configure-consumer -k -C <remote_addr> -D <remote_addr> [--enable] > lttng configure-consumer -k --enable > lttng configure-consumer -u -U <remote_addr> [--enable] > lttng configure-consumer -u -C <remote_addr> -D <remote_addr> [--enable] > lttng configure-consumer -u --enable > > Please let me know what you think. > > b) lttng create [-U <remote_addr>] | [-C <remote_addr> -D <remote_addr>] > [--no-consumer] [--disable-consumer] > > * Are options --no-consumer or --disable-consumer only applicable for > streaming? > * I'm not sure what is the purpose of the options --no-consumer or > --disable-consumer. Could you please explain the use cases for using > --no-consumer or --disable-consumer? > > > Thanks > Bernd > > This Communication is Confidential. We only send and receive email on > the basis of the terms set out at _www.ericsson.com/email_disclaimer_ > > > > > This body part will be downloaded on demand. ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-09 19:08 ` David Goulet @ 2012-10-09 21:18 ` Matthew Khouzam 2012-10-10 13:20 ` Bernd Hufmann 1 sibling, 0 replies; 7+ messages in thread From: Matthew Khouzam @ 2012-10-09 21:18 UTC (permalink / raw) I actually like this suggestion, it is less ambiguous... the last thing we want is for an enable-xyz to disable-xyz... Unless we want to frustrate the users. Cheers, Matthew On 12-10-09 03:08 PM, David Goulet wrote: > After talking a bit about this issue with other LTTng devs, it turns out > that it makes more sense to have a "set-consumer" command and remove > enable/disable-consumer from the cmd UI. > > I'll send a proposal on lttng-dev in the next days and please, everyone, > feel free to give feedbacks on this. > > Thanks! > David > > Bernd Hufmann: >> Hello >> >> For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to >> understand how to use the configuration for network streaming with the >> updated "lttng create"-command and new "enable-consumer"-command. >> >> a) lttng enable-consumer >> I find this command confusing because this command does not always >> enables the consumer, even if the command name implies so. The enabling >> actually depends on how the command is executed. >> Examples: >> >> * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng >> enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" >> don't enable the consumer. You need to either add option --enable or >> execute subsequently "lttng enable-consumer --enable" >> * lttng enable-consumer -k net://<remote_addr> does enable the >> consumer. I took me a while to figure out the difference to the >> example above: The option -U is omitted. >> >> >> What the command actually provides, is 2 features: A way to configure >> streaming (e.g. remote_addr) and a way to enable the consumer. Would it >> be better to name it to "lttng configure-consumer"? Also, remove the >> support of the possibility to not specify -U, -C or -D. The following >> variants of this command should be enough: >> lttng configure-consumer -k -U <remote_addr> [--enable] >> lttng configure-consumer -k -C <remote_addr> -D <remote_addr> [--enable] >> lttng configure-consumer -k --enable >> lttng configure-consumer -u -U <remote_addr> [--enable] >> lttng configure-consumer -u -C <remote_addr> -D <remote_addr> [--enable] >> lttng configure-consumer -u --enable >> >> Please let me know what you think. >> >> b) lttng create [-U <remote_addr>] | [-C <remote_addr> -D <remote_addr>] >> [--no-consumer] [--disable-consumer] >> >> * Are options --no-consumer or --disable-consumer only applicable for >> streaming? >> * I'm not sure what is the purpose of the options --no-consumer or >> --disable-consumer. Could you please explain the use cases for using >> --no-consumer or --disable-consumer? >> >> >> Thanks >> Bernd >> >> This Communication is Confidential. We only send and receive email on >> the basis of the terms set out at _www.ericsson.com/email_disclaimer_ >> >> >> >> >> This body part will be downloaded on demand. > _______________________________________________ > lttng-dev mailing list > lttng-dev at lists.lttng.org > http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev ^ permalink raw reply [flat|nested] 7+ messages in thread
* [lttng-dev] LTTng Tools 2.1 streaming commands 2012-10-09 19:08 ` David Goulet 2012-10-09 21:18 ` Matthew Khouzam @ 2012-10-10 13:20 ` Bernd Hufmann 1 sibling, 0 replies; 7+ messages in thread From: Bernd Hufmann @ 2012-10-10 13:20 UTC (permalink / raw) Hi David Thanks for looking into this. Bernd This Communication is Confidential. We only send and receive email on the basis of the terms set out at www.ericsson.com/email_disclaimer -----Original Message----- From: David Goulet [mailto:dgoulet@efficios.com] Sent: October-09-12 3:08 PM To: Bernd Hufmann Cc: lttng-dev at lists.lttng.org Subject: Re: [lttng-dev] LTTng Tools 2.1 streaming commands After talking a bit about this issue with other LTTng devs, it turns out that it makes more sense to have a "set-consumer" command and remove enable/disable-consumer from the cmd UI. I'll send a proposal on lttng-dev in the next days and please, everyone, feel free to give feedbacks on this. Thanks! David Bernd Hufmann: > Hello > > For the support of LTTng Tools 2.1 in Eclipse, I'm currently trying to > understand how to use the configuration for network streaming with the > updated "lttng create"-command and new "enable-consumer"-command. > > a) lttng enable-consumer > I find this command confusing because this command does not always > enables the consumer, even if the command name implies so. The > enabling actually depends on how the command is executed. > Examples: > > * "lttng enable-consumer -k -U net://<remote_addr>" or "lttng > enable-consumer -k -C tcp://<remote_addr> -D tcp://<remote_addr>" > don't enable the consumer. You need to either add option --enable or > execute subsequently "lttng enable-consumer --enable" > * lttng enable-consumer -k net://<remote_addr> does enable the > consumer. I took me a while to figure out the difference to the > example above: The option -U is omitted. > > > What the command actually provides, is 2 features: A way to configure > streaming (e.g. remote_addr) and a way to enable the consumer. Would > it be better to name it to "lttng configure-consumer"? Also, remove > the support of the possibility to not specify -U, -C or -D. The > following variants of this command should be enough: > lttng configure-consumer -k -U <remote_addr> [--enable] lttng > configure-consumer -k -C <remote_addr> -D <remote_addr> [--enable] > lttng configure-consumer -k --enable lttng configure-consumer -u -U > <remote_addr> [--enable] lttng configure-consumer -u -C <remote_addr> > -D <remote_addr> [--enable] lttng configure-consumer -u --enable > > Please let me know what you think. > > b) lttng create [-U <remote_addr>] | [-C <remote_addr> -D > <remote_addr>] [--no-consumer] [--disable-consumer] > > * Are options --no-consumer or --disable-consumer only applicable for > streaming? > * I'm not sure what is the purpose of the options --no-consumer or > --disable-consumer. Could you please explain the use cases for using > --no-consumer or --disable-consumer? > > > Thanks > Bernd > > This Communication is Confidential. We only send and receive email on > the basis of the terms set out at _www.ericsson.com/email_disclaimer_ > > > > > This body part will be downloaded on demand. ^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2012-10-10 13:20 UTC | newest] Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2012-10-03 18:17 [lttng-dev] LTTng Tools 2.1 streaming commands Bernd Hufmann 2012-10-03 18:27 ` David Goulet 2012-10-05 11:44 ` eamcs/eedbhu 2012-10-05 13:13 ` David Goulet 2012-10-09 19:08 ` David Goulet 2012-10-09 21:18 ` Matthew Khouzam 2012-10-10 13:20 ` Bernd Hufmann
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox