Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: e2e_processing_latency_percentiles settings #899

Closed
JakeXu opened this issue May 23, 2017 · 5 comments
Closed

docs: e2e_processing_latency_percentiles settings #899

JakeXu opened this issue May 23, 2017 · 5 comments

Comments

@JakeXu
Copy link

JakeXu commented May 23, 2017

From the github, I found the "ndsq.cfg.example", it wrote like this:

message processing time percentiles to keep track of (float)

e2e_processing_latency_percentiles = [
100.0,
99.0,
95.0
]

But, on the official document, Command Line Options describe:
-e2e-processing-latency-percentile value
message processing time percentiles (as float (0, 1.0]) to track (can be specified multiple times or comma separated '1.0,0.99,0.95', default none)

Which is right? Tks

@ploxiln
Copy link
Member

ploxiln commented May 23, 2017

Both are correct. If you set this in the config file, you use an array. If you set this with a command-line flag, you use commas.

https://github.com/nsqio/nsq/blob/master/nsqd/options.go#L64
https://github.com/mreiferson/go-options/blob/master/options.go#L192

@jehiah
Copy link
Member

jehiah commented May 23, 2017

@ploxiln I think the question here is are the values in the range 0, 1.0 or 0, 100

@ploxiln
Copy link
Member

ploxiln commented May 23, 2017

Ah, that is a good question. I had to hunt all the way into https://github.com/bmizerany/perks/ to be sure. Each value needs to be in the range (0,1.0) (note that this is not inclusive of 1.0, there's a / (1 - q) in bmizerany/perks).

I'm also not sure if the command-line flag actually works, it doesn't look like it copies the percentiles option to opts:

	// End to end percentile flags
	e2eProcessingLatencyPercentiles := app.FloatArray{}
	flagSet.Var(&e2eProcessingLatencyPercentiles, "e2e-processing-latency-percentile", "message processing time percentiles (as float (0, 1.0]) to track (can be specified multiple times or comma separated '1.0,0.99,0.95', default none)")
	flagSet.Duration("e2e-processing-latency-window-time", opts.E2EProcessingLatencyWindowTime, "calculate end to end latency quantiles for this duration of time (ie: 60s would only show quantile calculations from the past 60 seconds)")

@ploxiln
Copy link
Member

ploxiln commented May 25, 2017

I take back that bit about not being sure the command-line flag works, go-options gets the reference from the flagSet Var.

Anyway, a documentation/examples update should be sufficient to resolve this issue.

@mreiferson mreiferson changed the title About e2e_processing_latency_percentiles settings docs: e2e_processing_latency_percentiles settings May 26, 2017
@mreiferson
Copy link
Member

fixed in #988

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants