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

#![warn(missing_docs)]

//! Exports any metrics to DataDog

use metrics::SetRecorderError;
use std::time::Duration;
use thiserror::Error;
use tokio::task::JoinHandle;

mod builder;
pub use crate::builder::DataDogBuilder;
mod data;
pub use crate::data::DataDogMetric;
pub use crate::data::DataDogMetricType;
pub use crate::data::DataDogMetricValue;
mod exporter;
pub use crate::exporter::DataDogExporter;
mod recorder;
pub use crate::recorder::DataDogRecorder;

/// Error handling metrics
#[derive(Error, Debug)]
pub enum Error {
    /// Error when serializing metric to JSON
    #[error("Serialization failed: `{0}`")]
    SerializationError(#[from] serde_json::Error),
    /// Error when interacting with DataDog API
    #[error("API Request Failed: `{0}`")]
    ApiError(#[from] reqwest::Error),
}

/// [`Ok`] or [`enum@Error`]
pub type Result<T, E = Error> = core::result::Result<T, E>;

/// Handle to metrics
pub struct DataDogHandle {
    /// Metric recorder
    pub recorder: DataDogRecorder,
    /// Metric exporter
    pub handle: DataDogExporter,
}

impl DataDogHandle {
    /// Install [`DataDogRecorder`] and return [`DataDogExporter`]
    pub fn install(self) -> Result<DataDogExporter, SetRecorderError> {
        metrics::set_boxed_recorder(Box::new(self.recorder))?;
        Ok(self.handle)
    }

    /// Flush metrics
    pub async fn flush(&self) -> Result<()> {
        self.handle.flush().await
    }

    /// Write metrics every [`Duration`]
    pub fn schedule(&'static self, interval: Duration) -> JoinHandle<()> {
        self.handle.schedule(interval)
    }
}