Thanks to visit codestin.com
Credit goes to github.com

Skip to content

State that Summary does not support quantiles #36

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

Merged
merged 4 commits into from
Aug 13, 2015

Conversation

arturhoo
Copy link
Contributor

No description provided.

@@ -142,6 +142,8 @@ with s.time():
pass
```

**Summary support is incomplete**. The python client doesn't store or expose quantile information at this time.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a bit strong, this is a complete client library per the spec. I'd remove the first sentence.

@arturhoo
Copy link
Contributor Author

I've probably missed something then. From the docs I was expecting Summary to expose:

  • streaming φ-quantiles (0 ≤ φ ≤ 1) of observed events, exposed as <basename>{quantile="<φ>"}
  • the total sum of all observed values, exposed as <basename>_sum
  • the count of events that have been observed, exposed as <basename>_count

But indeed, the Guidelines document does mention the client libraries are only encouraged to expose quantiles. From my humble understanding either the docs should be more flexible, or the libraries very strict. @brian-brazil what do you think?

@brian-brazil
Copy link
Contributor

The docs need to be relaxed, using summaries without quantiles should be much more common than using them with (quantiles are quite expensive).

@arturhoo arturhoo changed the title State that Summary support is incomplete State that Summary does not support quantiles Aug 12, 2015
@arturhoo
Copy link
Contributor Author

Nice, do you recommend opening a PR on the docs then? I've removed the incomplete part and renamed this PR.

@@ -142,6 +142,8 @@ with s.time():
pass
```

The python client doesn't store or expose quantile information at this time.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're capitalising Python elsewhere, can you do the same for consistency?

@arturhoo arturhoo force-pushed the summary-clarification branch from dc612ed to 1ffb41d Compare August 12, 2015 16:43
@@ -142,6 +142,8 @@ with s.time():
pass
```

The Python Client doesn't store or expose quantile information at this time.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't capitalise client :(

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

k

brian-brazil added a commit that referenced this pull request Aug 13, 2015
State that Summary does not support quantiles
@brian-brazil brian-brazil merged commit ec12b72 into prometheus:master Aug 13, 2015
@arturhoo arturhoo deleted the summary-clarification branch August 13, 2015 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants