Struct datadog_logs::logger::DataDogLogger

pub struct DataDogLogger { /* fields omitted */ }

Logger that logs directly to DataDog via HTTP(S)

Implementations

impl DataDogLogger

pub fn selflog(&self) -> &Option<Receiver<String>>

Exposes self log of the logger.

Contains diagnostic messages with details of errors occuring inside logger. It will be None, unless enable_self_log in DataDogConfig is set to true.

pub fn blocking<T>(client: T, config: DataDogConfig) -> Self where
    T: DataDogClient + Send + 'static, 

Creates new blocking DataDogLogger instance

What it means is that no executor is used to host DataDog network client. A new thread is started instead. It receives messages to log and sends them in batches in blocking fashion. As this is a separate thread, calling log does not imply any IO operation, thus is quite fast.

Examples

use datadog_logs::{config::DataDogConfig, logger::DataDogLogger, client::HttpDataDogClient};

let config = DataDogConfig::default();
let client = HttpDataDogClient::new(&config).unwrap();
let logger = DataDogLogger::blocking(client, config);

pub fn log<T: Display>(&self, message: T, level: DataDogLogLevel)

Sends log to DataDog thread or task.

This function does not invoke any IO operation by itself. Instead it sends messages to logger thread or task using channels. Therefore it is quite lightweight.

Examples

use datadog_logs::{config::DataDogConfig, logger::{DataDogLogger, DataDogLogLevel}, client::HttpDataDogClient};

let config = DataDogConfig::default();
let client = HttpDataDogClient::new(&config).unwrap();
let logger = DataDogLogger::blocking(client, config);

logger.log("message", DataDogLogLevel::Error);

pub fn set_blocking_logger<T>(
    client: T,
    config: DataDogConfig,
    level: LevelFilter
) -> Result<(), DataDogLoggerError> where
    T: DataDogClient + Send + 'static, 

Initializes blocking DataDogLogger with log crate.

Examples

use datadog_logs::{config::DataDogConfig, logger::{DataDogLogger, DataDogLogLevel}, client::HttpDataDogClient};
use log::*;

let config = DataDogConfig::default();
let client = HttpDataDogClient::new(&config).unwrap();

DataDogLogger::set_blocking_logger(client, config, LevelFilter::Error);

error!("An error occured");
warn!("A warning")

Trait Implementations

impl Debug for DataDogLogger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for DataDogLogger

fn drop(&mut self)

Executes the destructor for this type.

impl Log for DataDogLogger

fn enabled(&self, _metadata: &Metadata<'_>) -> bool

Determines if a log message with the specified metadata would be logged.

fn log(&self, record: &Record<'_>)

Logs the Record.

fn flush(&self)

Flushes any buffered records.