annotate alert_rules.py @ 23:ffa013944200

mv
author drewp@bigasterisk.com
date Sat, 24 Jun 2023 23:02:17 -0700
parents
children b15cfe483964
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
23
drewp@bigasterisk.com
parents:
diff changeset
1 """
drewp@bigasterisk.com
parents:
diff changeset
2 pdm run invoke push-config
drewp@bigasterisk.com
parents:
diff changeset
3
drewp@bigasterisk.com
parents:
diff changeset
4 docs: https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/
drewp@bigasterisk.com
parents:
diff changeset
5 "Whenever the alert expression results in one or more vector
drewp@bigasterisk.com
parents:
diff changeset
6 elements at a given point in time, the alert counts as active for
drewp@bigasterisk.com
parents:
diff changeset
7 these elements' label sets."
drewp@bigasterisk.com
parents:
diff changeset
8 also https://www.metricfire.com/blog/top-5-prometheus-alertmanager-gotchas/#Missing-metrics
drewp@bigasterisk.com
parents:
diff changeset
9
drewp@bigasterisk.com
parents:
diff changeset
10 """
drewp@bigasterisk.com
parents:
diff changeset
11
drewp@bigasterisk.com
parents:
diff changeset
12 import json
drewp@bigasterisk.com
parents:
diff changeset
13
drewp@bigasterisk.com
parents:
diff changeset
14 import yaml
drewp@bigasterisk.com
parents:
diff changeset
15
drewp@bigasterisk.com
parents:
diff changeset
16
drewp@bigasterisk.com
parents:
diff changeset
17 def k8sRules():
drewp@bigasterisk.com
parents:
diff changeset
18 # from https://awesome-prometheus-alerts.grep.to/rules.html
drewp@bigasterisk.com
parents:
diff changeset
19 return [
drewp@bigasterisk.com
parents:
diff changeset
20 {
drewp@bigasterisk.com
parents:
diff changeset
21 "alert": "PrometheusTargetMissing",
drewp@bigasterisk.com
parents:
diff changeset
22 "expr": "up == 0",
drewp@bigasterisk.com
parents:
diff changeset
23 "for": "0m",
drewp@bigasterisk.com
parents:
diff changeset
24 "labels": {"severity": "critical"},
drewp@bigasterisk.com
parents:
diff changeset
25 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
26 "summary": "Prometheus target missing (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
27 "description": "A Prometheus target has disappeared. An exporter might be crashed.\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
28 },
drewp@bigasterisk.com
parents:
diff changeset
29 },
drewp@bigasterisk.com
parents:
diff changeset
30 {
drewp@bigasterisk.com
parents:
diff changeset
31 "alert": "KubernetesMemoryPressure",
drewp@bigasterisk.com
parents:
diff changeset
32 "expr": 'kube_node_status_condition{condition="MemoryPressure",status="true"} == 1',
drewp@bigasterisk.com
parents:
diff changeset
33 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
34 "labels": {"severity": "critical"},
drewp@bigasterisk.com
parents:
diff changeset
35 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
36 "summary": "Kubernetes memory pressure (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
37 "description": "{{ $labels.node }} has MemoryPressure condition\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
38 },
drewp@bigasterisk.com
parents:
diff changeset
39 },
drewp@bigasterisk.com
parents:
diff changeset
40 {
drewp@bigasterisk.com
parents:
diff changeset
41 "alert": "KubernetesDiskPressure",
drewp@bigasterisk.com
parents:
diff changeset
42 "expr": 'kube_node_status_condition{condition="DiskPressure",status="true"} == 1',
drewp@bigasterisk.com
parents:
diff changeset
43 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
44 "labels": {"severity": "critical"},
drewp@bigasterisk.com
parents:
diff changeset
45 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
46 "summary": "Kubernetes disk pressure (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
47 "description": "{{ $labels.node }} has DiskPressure condition\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
48 },
drewp@bigasterisk.com
parents:
diff changeset
49 },
drewp@bigasterisk.com
parents:
diff changeset
50 {
drewp@bigasterisk.com
parents:
diff changeset
51 "alert": "KubernetesOutOfDisk",
drewp@bigasterisk.com
parents:
diff changeset
52 "expr": 'kube_node_status_condition{condition="OutOfDisk",status="true"} == 1',
drewp@bigasterisk.com
parents:
diff changeset
53 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
54 "labels": {"severity": "critical"},
drewp@bigasterisk.com
parents:
diff changeset
55 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
56 "summary": "Kubernetes out of disk (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
57 "description": "{{ $labels.node }} has OutOfDisk condition\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
58 },
drewp@bigasterisk.com
parents:
diff changeset
59 },
drewp@bigasterisk.com
parents:
diff changeset
60 {
drewp@bigasterisk.com
parents:
diff changeset
61 "alert": "KubernetesJobFailed",
drewp@bigasterisk.com
parents:
diff changeset
62 "expr": "kube_job_status_failed > 0",
drewp@bigasterisk.com
parents:
diff changeset
63 "for": "0m",
drewp@bigasterisk.com
parents:
diff changeset
64 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
65 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
66 "summary": "Kubernetes Job failed (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
67 "description": "Job {{$labels.namespace}}/{{$labels.exported_job}} failed to complete\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
68 },
drewp@bigasterisk.com
parents:
diff changeset
69 },
drewp@bigasterisk.com
parents:
diff changeset
70 {
drewp@bigasterisk.com
parents:
diff changeset
71 "alert": "KubernetesPodCrashLooping",
drewp@bigasterisk.com
parents:
diff changeset
72 "expr": "increase(kube_pod_container_status_restarts_total[1m]) > 3",
drewp@bigasterisk.com
parents:
diff changeset
73 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
74 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
75 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
76 "summary": "Kubernetes pod crash looping (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
77 "description": "Pod {{ $labels.pod }} is crash looping\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
78 },
drewp@bigasterisk.com
parents:
diff changeset
79 },
drewp@bigasterisk.com
parents:
diff changeset
80 {
drewp@bigasterisk.com
parents:
diff changeset
81 "alert": "KubernetesClientCertificateExpiresNextWeek",
drewp@bigasterisk.com
parents:
diff changeset
82 "expr": 'apiserver_client_certificate_expiration_seconds_count{job="apiserver"} > 0 and histogram_quantile(0.01, sum by (job, le) (rate(apiserver_client_certificate_expiration_seconds_bucket{job="apiserver"}[5m]))) < 7*24*60*60',
drewp@bigasterisk.com
parents:
diff changeset
83 "for": "0m",
drewp@bigasterisk.com
parents:
diff changeset
84 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
85 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
86 "summary": "Kubernetes client certificate expires next week (instance {{ $labels.instance }})",
drewp@bigasterisk.com
parents:
diff changeset
87 "description": "A client certificate used to authenticate to the apiserver is expiring next week.\n VALUE = {{ $value }}",
drewp@bigasterisk.com
parents:
diff changeset
88 },
drewp@bigasterisk.com
parents:
diff changeset
89 },
drewp@bigasterisk.com
parents:
diff changeset
90 {
drewp@bigasterisk.com
parents:
diff changeset
91 "alert": "container_waiting",
drewp@bigasterisk.com
parents:
diff changeset
92 "expr": "sum by (container)(kube_pod_container_status_waiting!=0)",
drewp@bigasterisk.com
parents:
diff changeset
93 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
94 },
drewp@bigasterisk.com
parents:
diff changeset
95 ]
drewp@bigasterisk.com
parents:
diff changeset
96
drewp@bigasterisk.com
parents:
diff changeset
97
drewp@bigasterisk.com
parents:
diff changeset
98 def allRules():
drewp@bigasterisk.com
parents:
diff changeset
99 return {
drewp@bigasterisk.com
parents:
diff changeset
100 "groups": [
drewp@bigasterisk.com
parents:
diff changeset
101 {
drewp@bigasterisk.com
parents:
diff changeset
102 "name": "k8s",
drewp@bigasterisk.com
parents:
diff changeset
103 "rules": k8sRules(),
drewp@bigasterisk.com
parents:
diff changeset
104 },
drewp@bigasterisk.com
parents:
diff changeset
105 #
drewp@bigasterisk.com
parents:
diff changeset
106 # any presence of starlette_request_duration_seconds_created{app_name="starlette",method="GET",path="/",status_code="200"} 1.6460176156784086e+09 means someone forgot to set app name
drewp@bigasterisk.com
parents:
diff changeset
107 {
drewp@bigasterisk.com
parents:
diff changeset
108 "name": "Outages",
drewp@bigasterisk.com
parents:
diff changeset
109 "rules": [
drewp@bigasterisk.com
parents:
diff changeset
110 {
drewp@bigasterisk.com
parents:
diff changeset
111 "alert": "powereagleStalled",
drewp@bigasterisk.com
parents:
diff changeset
112 "expr": "rate(house_power_w[100m]) == 0",
drewp@bigasterisk.com
parents:
diff changeset
113 "for": "0m",
drewp@bigasterisk.com
parents:
diff changeset
114 "labels": {"severity": "losingData"},
drewp@bigasterisk.com
parents:
diff changeset
115 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
116 "summary": "power eagle data stalled",
drewp@bigasterisk.com
parents:
diff changeset
117 "description": "logs at https://bigasterisk.com/k/clusters/local/namespaces/default/deployments/power-eagle/logs",
drewp@bigasterisk.com
parents:
diff changeset
118 },
drewp@bigasterisk.com
parents:
diff changeset
119 },
drewp@bigasterisk.com
parents:
diff changeset
120 {
drewp@bigasterisk.com
parents:
diff changeset
121 "alert": "powereagleAbsent",
drewp@bigasterisk.com
parents:
diff changeset
122 "expr": "absent_over_time(house_power_w[5m])",
drewp@bigasterisk.com
parents:
diff changeset
123 "for": "2m",
drewp@bigasterisk.com
parents:
diff changeset
124 "labels": {"severity": "losingData"},
drewp@bigasterisk.com
parents:
diff changeset
125 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
126 "summary": "power eagle data missing",
drewp@bigasterisk.com
parents:
diff changeset
127 "description": "logs at https://bigasterisk.com/k/clusters/local/namespaces/default/deployments/power-eagle/logs",
drewp@bigasterisk.com
parents:
diff changeset
128 },
drewp@bigasterisk.com
parents:
diff changeset
129 },
drewp@bigasterisk.com
parents:
diff changeset
130 {
drewp@bigasterisk.com
parents:
diff changeset
131 "alert": "absent_zigbee",
drewp@bigasterisk.com
parents:
diff changeset
132 "expr": 'absent(container_last_seen{container="zigbee2mqtt"})',
drewp@bigasterisk.com
parents:
diff changeset
133 },
drewp@bigasterisk.com
parents:
diff changeset
134 {
drewp@bigasterisk.com
parents:
diff changeset
135 "alert": "net_routes_sync",
drewp@bigasterisk.com
parents:
diff changeset
136 "expr": 'rate(starlette_request_duration_seconds_count{app_name="net_routes",path="/routes"}[5m]) < 1/70',
drewp@bigasterisk.com
parents:
diff changeset
137 "for": "10m",
drewp@bigasterisk.com
parents:
diff changeset
138 "labels": {"severity": "houseUsersAffected"},
drewp@bigasterisk.com
parents:
diff changeset
139 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
140 "summary": "net_routes is not getting regular updates"
drewp@bigasterisk.com
parents:
diff changeset
141 },
drewp@bigasterisk.com
parents:
diff changeset
142 },
drewp@bigasterisk.com
parents:
diff changeset
143 ],
drewp@bigasterisk.com
parents:
diff changeset
144 },
drewp@bigasterisk.com
parents:
diff changeset
145 {
drewp@bigasterisk.com
parents:
diff changeset
146 "name": "alerts",
drewp@bigasterisk.com
parents:
diff changeset
147 "rules": [
drewp@bigasterisk.com
parents:
diff changeset
148 {
drewp@bigasterisk.com
parents:
diff changeset
149 "alert": "kube_node_status_bad_condition",
drewp@bigasterisk.com
parents:
diff changeset
150 "for": "2h",
drewp@bigasterisk.com
parents:
diff changeset
151 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
152 "expr": 'kube_node_status_condition{condition=~".*Pressure",status="true"} > 0',
drewp@bigasterisk.com
parents:
diff changeset
153 },
drewp@bigasterisk.com
parents:
diff changeset
154 {
drewp@bigasterisk.com
parents:
diff changeset
155 "alert": "housePower",
drewp@bigasterisk.com
parents:
diff changeset
156 "for": "24h",
drewp@bigasterisk.com
parents:
diff changeset
157 "labels": {"severity": "waste"},
drewp@bigasterisk.com
parents:
diff changeset
158 "expr": "house_power_w > 4000",
drewp@bigasterisk.com
parents:
diff changeset
159 "annotations": {"summary": "house power usage over 4KW"},
drewp@bigasterisk.com
parents:
diff changeset
160 },
drewp@bigasterisk.com
parents:
diff changeset
161 {
drewp@bigasterisk.com
parents:
diff changeset
162 "alert": "host_root_fs_space_low",
drewp@bigasterisk.com
parents:
diff changeset
163 "for": "20m",
drewp@bigasterisk.com
parents:
diff changeset
164 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
165 "expr": 'disk_free{path="/"} < 20G',
drewp@bigasterisk.com
parents:
diff changeset
166 "annotations": {"summary": "low disk_free"},
drewp@bigasterisk.com
parents:
diff changeset
167 },
drewp@bigasterisk.com
parents:
diff changeset
168 {
drewp@bigasterisk.com
parents:
diff changeset
169 "alert": "zpool_space_low",
drewp@bigasterisk.com
parents:
diff changeset
170 "for": "20m",
drewp@bigasterisk.com
parents:
diff changeset
171 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
172 "expr": 'last_over_time(zfs_pool_free_bytes{pool="stor7"}[1h]) < 100G',
drewp@bigasterisk.com
parents:
diff changeset
173 "annotations": {"summary": "low disk_free"},
drewp@bigasterisk.com
parents:
diff changeset
174 },
drewp@bigasterisk.com
parents:
diff changeset
175 {
drewp@bigasterisk.com
parents:
diff changeset
176 "alert": "zpool_device_error_count",
drewp@bigasterisk.com
parents:
diff changeset
177 "for": "20m",
drewp@bigasterisk.com
parents:
diff changeset
178 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
179 "expr": 'increase(zpool_device_error_count[1d]) > 0',
drewp@bigasterisk.com
parents:
diff changeset
180 "annotations": {"summary": "low disk_free"},
drewp@bigasterisk.com
parents:
diff changeset
181 },
drewp@bigasterisk.com
parents:
diff changeset
182 {
drewp@bigasterisk.com
parents:
diff changeset
183 "alert": "disk_week_incr",
drewp@bigasterisk.com
parents:
diff changeset
184 "for": "20m",
drewp@bigasterisk.com
parents:
diff changeset
185 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
186 "expr": 'round(increase(disk_used{path=~"/my/.*"}[1d])/1M) > 5000',
drewp@bigasterisk.com
parents:
diff changeset
187 "annotations": {"summary": "high mb/week on zfs dir"},
drewp@bigasterisk.com
parents:
diff changeset
188 },
drewp@bigasterisk.com
parents:
diff changeset
189 {
drewp@bigasterisk.com
parents:
diff changeset
190 "alert": "high_logging",
drewp@bigasterisk.com
parents:
diff changeset
191 "for": "20m",
drewp@bigasterisk.com
parents:
diff changeset
192 "labels": {"severity": "waste"},
drewp@bigasterisk.com
parents:
diff changeset
193 "expr": "sum by (container) (rate(kubelet_container_log_filesystem_used_bytes[3h])) > 4k",
drewp@bigasterisk.com
parents:
diff changeset
194 "annotations": {"summary": "high log output rate"},
drewp@bigasterisk.com
parents:
diff changeset
195 },
drewp@bigasterisk.com
parents:
diff changeset
196 {
drewp@bigasterisk.com
parents:
diff changeset
197 "alert": "stale_process",
drewp@bigasterisk.com
parents:
diff changeset
198 "for": "1d",
drewp@bigasterisk.com
parents:
diff changeset
199 "labels": {"severity": "dataRisk"},
drewp@bigasterisk.com
parents:
diff changeset
200 "expr": "round((time() - filestat_modification_time/1e9) / 86400) > 14",
drewp@bigasterisk.com
parents:
diff changeset
201 "annotations": {"summary": "process time is old"},
drewp@bigasterisk.com
parents:
diff changeset
202 },
drewp@bigasterisk.com
parents:
diff changeset
203 {
drewp@bigasterisk.com
parents:
diff changeset
204 "alert": "starlette",
drewp@bigasterisk.com
parents:
diff changeset
205 "for": "1m",
drewp@bigasterisk.com
parents:
diff changeset
206 "labels": {"severity": "fix"},
drewp@bigasterisk.com
parents:
diff changeset
207 "expr": 'starlette_request_duration_seconds_created{app_name="starlette"}',
drewp@bigasterisk.com
parents:
diff changeset
208 "annotations": {"summary": "set starlette app name"},
drewp@bigasterisk.com
parents:
diff changeset
209 },
drewp@bigasterisk.com
parents:
diff changeset
210 {
drewp@bigasterisk.com
parents:
diff changeset
211 "alert": "ssl_certs_expiring_soon",
drewp@bigasterisk.com
parents:
diff changeset
212 "expr": "min((min_over_time(probe_ssl_earliest_cert_expiry[1d])-time())/86400) < 10",
drewp@bigasterisk.com
parents:
diff changeset
213 "labels": {"severity": "warning"},
drewp@bigasterisk.com
parents:
diff changeset
214 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
215 "summary": "cert expiring soon. See https://bigasterisk.com/grafana/d/z1YtDa3Gz/certs?orgId=1\nVALUE = {{ $value }}"
drewp@bigasterisk.com
parents:
diff changeset
216 },
drewp@bigasterisk.com
parents:
diff changeset
217 },
drewp@bigasterisk.com
parents:
diff changeset
218 ],
drewp@bigasterisk.com
parents:
diff changeset
219 },
drewp@bigasterisk.com
parents:
diff changeset
220 ]
drewp@bigasterisk.com
parents:
diff changeset
221 }
drewp@bigasterisk.com
parents:
diff changeset
222
drewp@bigasterisk.com
parents:
diff changeset
223
drewp@bigasterisk.com
parents:
diff changeset
224 def _runJson(ctx, cmd):
drewp@bigasterisk.com
parents:
diff changeset
225 return json.loads(ctx.run(cmd, hide="stdout").stdout)
drewp@bigasterisk.com
parents:
diff changeset
226
drewp@bigasterisk.com
parents:
diff changeset
227
drewp@bigasterisk.com
parents:
diff changeset
228 def hostsExpectedOnline(ctx):
drewp@bigasterisk.com
parents:
diff changeset
229 return _runJson(ctx, "cd /my/serv/lanscape; pdm run python hosts_expected_online.py")
drewp@bigasterisk.com
parents:
diff changeset
230
drewp@bigasterisk.com
parents:
diff changeset
231
drewp@bigasterisk.com
parents:
diff changeset
232 def expectedK8sNodes(ctx):
drewp@bigasterisk.com
parents:
diff changeset
233 getNode = _runJson(ctx, "kubectl get node -o json")
drewp@bigasterisk.com
parents:
diff changeset
234 hosts = [item["metadata"]["name"] for item in getNode["items"]]
drewp@bigasterisk.com
parents:
diff changeset
235 optionalHosts = {'slash'}
drewp@bigasterisk.com
parents:
diff changeset
236 return {
drewp@bigasterisk.com
parents:
diff changeset
237 "groups": [
drewp@bigasterisk.com
parents:
diff changeset
238 {
drewp@bigasterisk.com
parents:
diff changeset
239 "name": "k8s_expected_nodes",
drewp@bigasterisk.com
parents:
diff changeset
240 "rules": [
drewp@bigasterisk.com
parents:
diff changeset
241 {
drewp@bigasterisk.com
parents:
diff changeset
242 "alert": "kube_node_log_size_report_" + h,
drewp@bigasterisk.com
parents:
diff changeset
243 "expr": 'absent(kubelet_container_log_filesystem_used_bytes{instance="%s"})'
drewp@bigasterisk.com
parents:
diff changeset
244 % h,
drewp@bigasterisk.com
parents:
diff changeset
245 "for": "1h",
drewp@bigasterisk.com
parents:
diff changeset
246 "annotations": {
drewp@bigasterisk.com
parents:
diff changeset
247 "summary": f"no recent k8s log size report from host {h}"
drewp@bigasterisk.com
parents:
diff changeset
248 },
drewp@bigasterisk.com
parents:
diff changeset
249 }
drewp@bigasterisk.com
parents:
diff changeset
250 for h in hosts if not h in optionalHosts
drewp@bigasterisk.com
parents:
diff changeset
251 ],
drewp@bigasterisk.com
parents:
diff changeset
252 }
drewp@bigasterisk.com
parents:
diff changeset
253 ]
drewp@bigasterisk.com
parents:
diff changeset
254 }