docs icon indicating copy to clipboard operation
docs copied to clipboard

Best Practice Docs Don't Call Out the Importance of Job Label

Open conallob opened this issue 6 months ago • 1 comments

https://prometheus.io/docs/practices/naming/ and https://prometheus.io/docs/practices/rules/ should call out the importance of the job label, particularly in a multi-tenant prometheus installation.

https://prometheus.io/docs/practices/naming/ does not mention the job label at all.

https://prometheus.io/docs/practices/rules does mention

Always specify a without clause with the labels you are aggregating away. This is to preserve all the other labels such as job, which will avoid conflicts and give you more useful metrics and alerts.

and all it's examples include an explicit job label

But that's about as explicit as it gets.

conallob avatar Jul 15 '25 10:07 conallob

As somebody who has been writing PromQL for much longer than it was called PromQL (IYKYK), I'm happy to take this on

conallob avatar Jul 15 '25 10:07 conallob