mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2024-12-30 07:40:06 +01:00
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
## VM Alert
|
||
|
||
#### Abstract
|
||
The application which accepts the alert rules, executes them on given source, sends(fires) an alert to(in) alert management system
|
||
|
||
### Components
|
||
|
||
#### Alert Config Reader
|
||
It accepts yaml config as input parameter in Prometheus format, parses it into Go struct.
|
||
|
||
#### Source Caller
|
||
Create own watchdog for every alert group (goroutines), which executes alert query on given source and issues an alert if source returns non-empty result.
|
||
Source can be any service which supports PromQL (MetricsQL).
|
||
|
||
#### Alert Management System Provider
|
||
Send positive alert to alert management system, provides interface for every concrete implementation.
|
||
Should be ingratiated with Prometheus alertmanager.
|
||
|
||
open questions:
|
||
- do we really need alert group or can just run every alert in own goroutine?
|
||
|
||
#### Web Server
|
||
Expose metrics
|
||
|
||
open questions:
|
||
- should the tool provide API or UI for managing alerting rules? Where to store config updated via the API or UI?
|
||
- should the tool provide “alerting rules validation mode” for validating and debugging alerting rules? This mode is useful when creating and debugging alerting rules.
|
||
|
||
#### Requirements:
|
||
- Stateless
|
||
- Avoid external dependencies if possible
|
||
- Reuse existing code from VictoriaMetrics repo
|
||
- Makefile rules for common tasks – see Makefiles for other apps in the app/ dir
|
||
- Every package should be covered by tests
|
||
- Dockerfile
|
||
- Graceful shutdown
|
||
- Helm template
|
||
- Application uses command line flags for configuration
|
||
|
||
|
||
<img alt="VM Alert" src="vmalert.png">
|