Crate prima_datadog

This is an opinionated library to share code and approach to Datadog logging in prima.it

Getting started

You need to call Datadog::init in your main binary, and to do so you’ll need as argument a type that implements the Configuration trait.

Inside the configuration you’ll find an implementation of this trait tailored for prima.it needs.

use prima_datadog::{Datadog, configuration::PrimaConfiguration};

let configuration = PrimaConfiguration::new(
    "0.0.0.0:1234", // to address
    "0.0.0.0:0", // from address
    "service_name", // namespace for all metrics
    "staging" // environment
);
Datadog::init(configuration);

Then you can use the macros exposed at the base level of the module

prima_datadog::incr!("test");
prima_datadog::decr!("test"; "some" => "data");

The first argument is the metric name. It accepts string literal (like the previous example) or a type path that implements AsRef for T: str

enum Metric {
    John,
    Paul,
    George,
    Ringo,
}

impl AsRef<str> for Metric {
    fn as_ref(&self) -> &str {
        match self {
            Metric::John => "john",
            Metric::Paul => "paul",
            Metric::George => "george",
            Metric::Ringo => "ringo",
        }
    }
}

and then

prima_datadog::incr!(Metric::John; "play" => "guitar");
prima_datadog::incr!(Metric::Paul; "play" => "bass");
prima_datadog::incr!(Metric::George; "play" => "sitar");
prima_datadog::incr!(Metric::Ringo; "play" => "drums");

References

• Datadog docs
• Getting started with Datadog tags

Modules

configuration

Configuration module

error

prima_datadog errors

Macros

decr

Decrement a StatsD counter

incr

Increment a StatsD counter

Structs

Datadog

The Datadog struct is the main entry point for the library

Traits

DogstatsdClient