Struct gelf_logger::ConfigBuilder

pub struct ConfigBuilder { /* fields omitted */ }

Builder for Config.

The ConfigBuilder can set the different parameters of Config object, and returns the created object when build is called.

Example

use gelf_logger::ConfigBuilder;

let cfg = ConfigBuilder::new()
    .set_hostname("localhost".into())
    .build();

Methods

impl ConfigBuilder

pub fn try_from_yaml(path: &str) -> Result<ConfigBuilder, Error>

Load configuration using the given path file.

Example

use gelf_logger::ConfigBuilder;

let config = ConfigBuilder::try_from_yaml("/tmp/myconf.yml")
    .expect("Invalid config file!")
    .build();

pub fn new() -> ConfigBuilder

Construct new ConfigBuilder.

Defaults values are:

• level: GelfLevel::Alert
• hostname: "127.0.0.1"
• port: 12202
• null_character: true
• use_tls: true
• buffer_size: None
• buffer_duration: None
• additional_fields: empty BTreeMap

pub fn set_level(self, level: GelfLevel) -> ConfigBuilder

Sets threshold for this logger to level. Logging messages which are less severe than level will be ignored.

pub fn set_hostname(self, hostname: String) -> ConfigBuilder

Sets the hostname of the remote server.

pub fn set_port(self, port: u64) -> ConfigBuilder

Sets the port of the remote server.

pub fn set_null_character(self, null_character: bool) -> ConfigBuilder

Adds a NUL byte (\0) after each entry.

pub fn set_use_tls(self, use_tls: bool) -> ConfigBuilder

Activate transport security.

pub fn set_buffer_size(self, buffer_size: usize) -> ConfigBuilder

Sets the upperbound limit on the number of records that can be placed in the buffer, once this size has been reached, the buffer will be sent to the remote server.

pub fn set_buffer_duration(self, buffer_duration: u64) -> ConfigBuilder

Sets the maximum lifetime (in milli seconds) of the buffer before send it to the remote server.

pub fn put_additional_field(self, key: String, value: Value) -> ConfigBuilder

Adds an additional data which will be append to each log entry.

pub fn extend_additional_fields(
    self,
    additional_fields: BTreeMap<Value, Value>
) -> ConfigBuilder

Adds multiple additional data which will be append to each log entry.

pub fn build(self) -> Config

Invoke the builder and return a Config

Trait Implementations

impl Clone for ConfigBuilder

fn clone(&self) -> ConfigBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConfigBuilder

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConfigBuilder

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.