It should be pointed out that there are two Java client library versions, both living in the same repository:
The first one actually supports summaries with quantiles. You might want to try that. I've heard different opinions about each library, but the simpleclient is probably what most people will want to use in the future, unless they need summary quantiles. It would be great if it the new library could add support for quantiles in summaries as well. At SoundCloud, we are still using the old client library for quantiles, as we haven't fully introduced usage of the new "histogram" metric type yet.
The fundamental tradeoff between quantiles based on histograms and summary quantiles is:
- histograms require more computation and number of stored time series on the server side to generate useful quantiles, but they allow aggregation and server-side quantile calculation
- summaries pre-calculate quantiles on the client side, making the server's job easier, but it means that you cannot get a statistically valid aggregation over them (as in, the 90th percentile over *all* instances, not just one). That's what histograms enable.
For details, see:
The last link explains in great detail the tradeoffs of both metric types.