bestool-alertd 1.1.0

(Internal) BES tooling: Alert daemon
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use axum::{http::StatusCode, response::IntoResponse};

pub async fn handle_index() -> impl IntoResponse {
	let endpoints = serde_json::json!([
		{
			"method": "GET",
			"path": "/",
			"description": "List of available endpoints"
		},
		{
			"method": "POST",
			"path": "/reload",
			"description": "Trigger a configuration reload (equivalent to SIGHUP)"
		},
		{
			"method": "POST",
			"path": "/alert",
			"description": "Trigger a custom HTTP alert with JSON payload"
		},
		{
			"method": "GET",
			"path": "/alerts",
			"description": "List currently loaded alert files"
		},
		{
			"method": "DELETE",
			"path": "/alerts",
			"description": "Temporarily pause an alert until the specified timestamp (JSON body: {\"alert\": \"PATH\", \"until\": \"TIMESTAMP\"})"
		},
		{
			"method": "GET",
			"path": "/targets",
			"description": "List all currently loaded external targets"
		},
		{
			"method": "POST",
			"path": "/validate",
			"description": "Validate an alert definition (send YAML as request body, returns validation result as JSON)"
		},
		{
			"method": "GET",
			"path": "/metrics",
			"description": "Prometheus-formatted metrics for monitoring"
		},
		{
			"method": "GET",
			"path": "/status",
			"description": "Daemon status information in JSON format"
		},
		{
			"method": "GET",
			"path": "/health",
			"description": "Health check endpoint (returns 200 if healthy, 530 if stalled)"
		}
	]);

	(
		StatusCode::OK,
		[(axum::http::header::CONTENT_TYPE, "application/json")],
		serde_json::to_string_pretty(&endpoints).unwrap(),
	)
}