metriki-tower 0.2.5

Metriki integration with tower
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

use std::sync::Arc;
use std::task::{Context, Poll};

use derive_builder::Builder;
use futures::{FutureExt, TryFutureExt};
use hyper::{Body, Request, Response};
use metriki_core::metrics::TimerContextArc;
use metriki_core::MetricsRegistry;
use tower_layer::Layer;
use tower_service::Service;

use crate::common::ResultFuture;

/// The Tower service designed for metering hyper stack
///
/// Current provided metrics:
///
/// * Timer all requests: `metric_name.all`
/// * Timers by request method: eg, `metric_name.GET`
/// * Meters by response status code family: eg, `metric_name.2xx`
/// * Inflight request counter: `metric_name.inflight`
/// * Meter for unhandled error: `metric_name.error`
///
#[cfg_attr(docsrs, doc(cfg(feature = "macros")))]
#[derive(Debug, Clone)]
pub struct HyperMetricsService<S> {
    registry: Arc<MetricsRegistry>,
    base_metric_name: String,
    inner: S,
}

// A sample data structure of hyper request
//
// Request {
//     method: GET,
//     uri: /,
//     version: HTTP/1.1,
//     headers: {
//         "host": "localhost:3000",
//         "user-agent": "curl/7.78.0",
//         "accept": "*/*",
//     },
//     body: Body(
//         Empty,
//     ),
// }

impl<S, RespBody> Service<Request<Body>> for HyperMetricsService<S>
where
    S: Service<Request<Body>, Response = Response<RespBody>> + Send,
    S::Future: Send + 'static,
{
    type Response = Response<RespBody>;
    type Error = S::Error;
    type Future = ResultFuture<Self::Response, Self::Error>;

    fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll<Result<(), Self::Error>> {
        self.inner.poll_ready(cx)
    }

    fn call(&mut self, req: Request<Body>) -> Self::Future {
        let registry = self.registry.clone();
        let name = Arc::new(self.base_metric_name.clone());

        let request_timer = registry.timer(&format!("{}.all", name));
        let method_timer = registry.timer(&format!("{}.{}", name, req.method().as_str()));
        let request_timer_ctx = TimerContextArc::start(request_timer);
        let method_timer_ctx = TimerContextArc::start(method_timer);

        registry.counter(&format!("{}.inflight", name)).inc(1);

        // this is bad :(
        let inner_registry_err = registry.clone();
        let inner_name_err = name.clone();

        let f = self
            .inner
            .call(req)
            .map(move |resp| {
                // timers
                request_timer_ctx.stop();
                method_timer_ctx.stop();

                // inflight request counter
                registry.counter(&format!("{}.inflight", name)).dec(1);

                if let Ok(ref resp) = resp {
                    // meters by status code family, 2xx, 3xx, 4xx and 5xx
                    let status_family = resp.status().as_u16() / 100;
                    registry
                        .meter(&format!("{}.{}xx", name, status_family))
                        .mark();
                }

                resp
            })
            .map_err(move |e| {
                // error meter
                inner_registry_err
                    .meter(&format!("{}.error", inner_name_err))
                    .mark();

                // inflight request counter
                inner_registry_err
                    .counter(&format!("{}.inflight", inner_name_err))
                    .dec(1);

                e
            });

        Box::pin(f)
    }
}

/// Tower layer to create [`HyperMetricsService`]
///
/// Use [`HyperMetricsLayerBuilder`] to create.
#[cfg_attr(docsrs, doc(cfg(feature = "macros")))]
#[derive(Builder, Debug, Clone)]
pub struct HyperMetricsLayer {
    registry: Arc<MetricsRegistry>,
    #[builder(setter(into), default = "\"requests\".to_owned()")]
    base_metric_name: String,
}

impl<S> Layer<S> for HyperMetricsLayer {
    type Service = HyperMetricsService<S>;

    fn layer(&self, service: S) -> Self::Service {
        HyperMetricsService {
            registry: self.registry.clone(),
            inner: service,
            base_metric_name: self.base_metric_name.clone(),
        }
    }
}