fraiseql-server 2.2.0

HTTP server for FraiseQL v2 GraphQL engine
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Metrics configuration with SLO tracking.

use serde::Deserialize;

/// Prometheus metrics endpoint and SLO tracking configuration.
#[derive(Debug, Clone, Deserialize)]
pub struct MetricsConfig {
    /// Whether to expose the metrics endpoint.  Default: `true`.
    #[serde(default = "default_enabled")]
    pub enabled: bool,

    /// URL path for the metrics endpoint.  Default: `"/metrics"`.
    #[serde(default = "default_path")]
    pub path: String,

    /// Output format (`"prometheus"` is the only currently supported value).  Default:
    /// `"prometheus"`.
    #[serde(default = "default_format")]
    pub format: String,

    /// SLO configuration
    #[serde(default)]
    pub slos: SloConfig,
}

impl Default for MetricsConfig {
    fn default() -> Self {
        Self {
            enabled: default_enabled(),
            path:    default_path(),
            format:  default_format(),
            slos:    SloConfig::default(),
        }
    }
}

const fn default_enabled() -> bool {
    true
}
fn default_path() -> String {
    "/metrics".to_string()
}
fn default_format() -> String {
    "prometheus".to_string()
}

/// Service Level Objective (SLO) targets for latency, availability, and error rate.
#[derive(Debug, Clone, Deserialize, Default)]
pub struct SloConfig {
    /// Target latency percentiles to track
    #[serde(default = "default_latency_percentiles")]
    pub latency_percentiles: Vec<f64>,

    /// Latency SLO targets (p99 < Xms)
    #[serde(default)]
    pub latency_targets: LatencyTargets,

    /// Availability SLO target (e.g., 0.999 for 99.9%)
    #[serde(default = "default_availability_target")]
    pub availability_target: f64,

    /// Error rate SLO target (e.g., 0.01 for 1%)
    #[serde(default = "default_error_rate_target")]
    pub error_rate_target: f64,
}

fn default_latency_percentiles() -> Vec<f64> {
    vec![0.5, 0.9, 0.95, 0.99]
}
const fn default_availability_target() -> f64 {
    0.999
}
const fn default_error_rate_target() -> f64 {
    0.01
}

/// SLO latency targets in milliseconds (p99) per operation type.
#[derive(Debug, Clone, Deserialize, Default)]
pub struct LatencyTargets {
    /// GraphQL query p99 latency target in milliseconds.  Default: `100`.
    #[serde(default = "default_graphql_latency")]
    pub graphql_p99_ms: u64,

    /// Webhook handler p99 latency target in milliseconds.  Default: `500`.
    #[serde(default = "default_webhook_latency")]
    pub webhook_p99_ms: u64,

    /// Authentication endpoint p99 latency target in milliseconds.  Default: `10`.
    #[serde(default = "default_auth_latency")]
    pub auth_p99_ms: u64,

    /// File upload p99 latency target in milliseconds.  Default: `2000`.
    #[serde(default = "default_file_upload_latency")]
    pub file_upload_p99_ms: u64,
}

const fn default_graphql_latency() -> u64 {
    100
}
const fn default_webhook_latency() -> u64 {
    500
}
const fn default_auth_latency() -> u64 {
    10
}
const fn default_file_upload_latency() -> u64 {
    2000
}