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

Prometheus counters should have _total suffix #137

Closed
raymondlam opened this issue Sep 13, 2017 · 2 comments
Closed

Prometheus counters should have _total suffix #137

raymondlam opened this issue Sep 13, 2017 · 2 comments
Milestone

Comments

@raymondlam
Copy link
Contributor

raymondlam commented Sep 13, 2017

When running the Prometheus' format checker, we found the following warnings:

  1. Counters metrics should have "_total" suffix

    Prometheus prefers _total over _count for the suffix.

  2. non-histogram and non-summary metrics should not have "_count" suffix

    For Histogram/Timer, the _count should be within the Prometheus summary metric

  3. no help text

    To reduce the amount of help texts, we didn't require # Help to be included in every metric line. It might be better to ignore this warning.

raymondlam added a commit to raymondlam/microprofile-metrics that referenced this issue Sep 13, 2017
@pilhuhn
Copy link
Contributor

pilhuhn commented Sep 14, 2017

Raymond Lam @raymondlam 20:39
@pilhuhn any opinion, on #137, I think the moving the count under the "summary" type for Timer/Histogram is easy enough

Heiko W. Rupp @pilhuhn Sept. 13 20:41
Yes.
(That is 2)
Not sure about 1) and I agree that 3) is overkill

Raymond Lam @raymondlam 20:42
For 1), whether we want to always append _total to Counter is debatable.

Heiko W. Rupp @pilhuhn Sept. 13 20:43
Yes. I think it is overkill

Raymond Lam @raymondlam 20:45
I would prefer that developer facing docs should mention that Prometheus prefers _total at the end for counters but not force it on them by the server

Heiko W. Rupp @pilhuhn Sept. 13 20:46
makes sense

@pilhuhn pilhuhn added this to the 1.0 milestone Sep 14, 2017
@pilhuhn
Copy link
Contributor

pilhuhn commented Sep 14, 2017

Number 2 was addressed in #142

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

No branches or pull requests

2 participants