human_readable.html

<h1>Validation rules</h1>

  <h2><a href="#check-severity-label">check-severity-label</a></h2>
	  <ul>
		<li>Alert has labels: <code>severity</code></li>
		<li>Alert label <code>severity</code> has one of the allowed values: <code>info</code>,<code>warning</code>,<code>critical</code></li>
		<li>Alert if rule has label <code>severity</code> with value <code>info</code> , it cannot have label <code>page</code></li>
		<li>Alert expression can be successfully evaluated on the live Prometheus instance</li>
		<li>Alert expression uses only labels that are actually present in Prometheus</li>
		<li>Alert expression does not use irate</li>
		<li>Alert expression selectors actually matches any series in Prometheus</li>
		<li>Alert expression does not use data older than <code>6h0m0s</code></li>
	  </ul>

  <h2><a href="#check-team-label">check-team-label</a></h2>
	  <ul>
		<li>Alert has labels: <code>xxx</code></li>
		<li>Alert label <code>team</code> has one of the allowed values: <code>sre@company.com</code> (templated values are ignored)</li>
	  </ul>

  <h2><a href="#check-playbook-annotation">check-playbook-annotation</a></h2>
	  <ul>
		<li>Alert has any of these annotations: <code>playbook</code>,<code>link</code></li>
		<li>Alert Annotation <code>link</code> is a valid URL and does not return HTTP status 404</li>
	  </ul>

  <h2><a href="#check-alert-title">check-alert-title</a></h2>
	  <ul>
		<li>Alert has all of these annotations: <code>title</code></li>
	  </ul>

  <h2><a href="#check-prometheus-limitations">check-prometheus-limitations</a></h2>
	  <ul>
		<li>All rules expression does not use data older than <code>6h0m0s</code></li>
		<li>All rules does not use any of the <code>cluster</code>,<code>locality</code>,<code>prometheus-type</code>,<code>replica</code> labels is in its expression</li>
	  </ul>

  <h2><a href="#check-source-tenants">check-source-tenants</a></h2>
	  <ul>
		<li>All rules rule group, the rule belongs to, has the required <code>source_tenants</code> configured, according to the mapping of metric names to tenants: 
<br/>        <code>k8s</code>:   <code>^container_.*$</code> (Metrics from cAdvisor)
<br/>        <code>k8s</code>:   <code>^kube_.*$</code> (Metrics from KSM)
<br/>        <code>mysql</code>:   <code>^mysql_.*$</code> (MySQL metrics from the MySQL team)</li>
	  </ul>

  <h2><a href="#check-metric-name">check-metric-name</a></h2>
	  <ul>
		<li>Alert expression uses metric name in selectors</li>
		<li>Alert labels are valid templates</li>
		<li>Alert <code>keep_firing_for</code> is not longer than <code>1h</code></li>
	  </ul>

  <h2><a href="#check-groups">check-groups</a></h2>
	  <ul>
		<li>Group does not have other <code>source_tenants</code> than: <code>tenant1</code>, <code>tenant2</code>, <code>k8s</code></li>
		<li>Group evaluation interval is between <code>20s</code> and <code>106751d23h47m16s854ms</code> if set</li>
		<li>Group has valid partial_response_strategy (one of <code>warn</code> or <code>abort</code>) if set</li>
		<li>Group has at most 10 rules</li>
		<li>Group does not have higher <code>limit</code> configured then 100</li>
	  </ul>

  <h2><a href="#check-formatting">check-formatting</a></h2>
	  <ul>
		<li>All rules expression is well formatted as would <code>promtool promql format</code> do or similar online tool such as https://o11y.tools/promqlparser/</li>
	  </ul>

  <h2><a href="#another-checks">another-checks</a></h2>
	  <ul>
		<li>All rules labels does not have empty values</li>
	  </ul>