cedarling 2.3.0

The Cedarling: a high-performance local authorization service powered by the Rust Cedar 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

// This software is available under the Apache-2.0 license.
// See https://www.apache.org/licenses/LICENSE-2.0.txt for full text.
//
// Copyright (c) 2024, Gluu, Inc.

use std::sync::Arc;
use std::time::Duration;

use tokio::time::{MissedTickBehavior, interval};
use tokio_util::sync::CancellationToken;

use crate::authz::metrics::MetricsCollector;
use crate::http::{JoinHandle, spawn_task};
use crate::log::interface::LogWriter;
use crate::log::{BaseLogEntry, LoggerWeak, MetricsLogEntry};

pub(crate) struct TelemetryTicker {
    metrics: Arc<MetricsCollector>,
    logger: Option<LoggerWeak>,
    interval: Duration,
}

impl TelemetryTicker {
    pub(crate) fn spawn(
        metrics: Arc<MetricsCollector>,
        logger: Option<LoggerWeak>,
        interval: Duration,
    ) -> (CancellationToken, JoinHandle<()>) {
        let cancel_tkn = CancellationToken::new();
        let ticker = Self {
            metrics,
            logger,
            interval,
        };
        let handle = spawn_task(ticker.run(cancel_tkn.clone()));
        (cancel_tkn, handle)
    }

    pub(crate) async fn run(self, cancel_tkn: CancellationToken) {
        let mut ticker = interval(self.interval);
        ticker.set_missed_tick_behavior(MissedTickBehavior::Delay);
        ticker.tick().await;
        loop {
            tokio::select! {
                _ = ticker.tick() => {
                    self.emit_snapshot();
                }
                () = cancel_tkn.cancelled() => {
                    self.emit_snapshot();
                    return;
                }
            }
        }
    }

    fn emit_snapshot(&self) {
        // Attempt upgrade before resetting, so we don't discard data
        // if the logger is gone.
        let Some(logger) = self.logger.as_ref().and_then(std::sync::Weak::upgrade) else {
            return;
        };

        let snapshot = self.metrics.snapshot_and_reset();
        let entry = MetricsLogEntry {
            base: BaseLogEntry::new_metric_opt_request_id(None),
            policy_stats: snapshot.policy_stats,
            error_counters: snapshot.error_counters,
            operational_stats: snapshot.operational_stats,
            interval_secs: snapshot.interval_secs,
        };

        logger.log_any(entry);
    }
}