|
I'm referring to:
https://docs.mongodb.com/master/reference/operator/aggregation/collStats/#pipe._S_collStats
1)
Replace:
"Returns statistics regarding a collection or view."
With:
"Returns statistics regarding a collection or view either since server start or since creation of collection or view whatever happened later."
Why I think this is important:
Because it was unclear to me which time span the statistics cover.
2)
Replace:
"An array of embedded documents, each representing a latency range. Each document covers twice the previous document’s range. For upper values between 2048 microseconds and roughly 1 second, the histogram includes half-steps."
With:
"An array of embedded documents, each representing a latency range. Ranges are powers of two, so each document covers twice the previous document’s range as long as the range was not empty and thus not omitted. For values greater than 2048 microseconds the histogram includes half-steps."
Why I think this is important:
Speaking of powers of 2 is much clearer to every computer scientist than to say "covers twice the previous document's range". The latter is furthermore wrong when empty ranges are omitted.
Speaking of "...between 2048 microseconds and roughly 1 second..." is simply wrong. It let me wrongly think that either half-steps are only included from 2048 micros to 1 second and after 1 second there no half-steps anymore or there are no ranges at all after 1 second. I had to figure out by myself that half-steps are included always after 2048 micros, even after 1 second or more.
|