The OpenShift Monitoring Team has published a set guidelines for
writing alerting rules in OpenShift, including a basic style guide.
You can find these here:
A subset of these are now being enforced in OpenShift End-to-End
tests , with temporary exceptions for existing non-compliant rules.
This component was found to have the following issues:
* Alerts without summary and/or description annotations:
Alerts MUST include summary and description annotations.
Think of summary as the first line of a commit message, or an email
subject line. It should be brief but informative. The description is
the longer, more detailed explanation of the alert.
The enhancement document linked above has examples of alerts with
* Alerts found to not include a namespace label:
Alerts SHOULD include a namespace label indicating the alert's source.
This requirement originally comes from our SRE team, as they use the
namespace label as the first means of routing alerts. Many alerts
already include a namespace label as a result of the PromQL
expressions used, others may require a static label.
Example of a change to PromQL to include a namespace label:
Example of adding a static namespace label:
If you have questions about how to best to modify your alerting rules
to include a namespace label, please reach out to the OpenShift
Monitoring Team in the #forum-monitoring channel on Slack, or on our
mailing list: team-monitoring
We are making sure any new alerts we add comply with these guidelines, and we plan to address these existing ones as part of our upcoming "Enhance metrics and alerting" epic . I have linked that epic to this bug so we don't lose it.