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

Unexplained recording rule syntax example provided in docs #3040

Closed
cmcginty opened this Issue Aug 9, 2017 · 2 comments

Comments

Projects
None yet
2 participants
@cmcginty
Copy link

cmcginty commented Aug 9, 2017

I'm raising this issue because the current Recording Rule documentation is woefully lacking with respect to non-expert user such as myself.

I'm trying to implement a recording rule but the first example is using syntax that is not defined nor explained to the reader.

On the https://prometheus.io/docs/querying/rules/#configuring-rules page, the example is:

# Saving the per-job HTTP in-progress request count as a new set of time series:
job:http_inprogress_requests:sum = sum(http_inprogress_requests) by (job)

First, the left-hand value does not match the syntax defined immediately above it. Assuming the example is valid, could you please document the <X>:<Y>:<Z>values with respect to the right-hand query in the example?

Does the colon in this example have some special meaning?

@brian-brazil

This comment has been minimized.

Copy link
Member

brian-brazil commented Aug 9, 2017

That's a convention defined in https://prometheus.io/docs/practices/rules/, and it does match the docs prior to it.

@lock

This comment has been minimized.

Copy link

lock bot commented Mar 23, 2019

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.

@lock lock bot locked and limited conversation to collaborators Mar 23, 2019

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
You can’t perform that action at this time.