Struct slog_loggly::LogglyDrainBuilder

pub struct LogglyDrainBuilder<F = AcceptAll> { /* private fields */ }

Loggly drain builder.

Implementations

impl<F> LogglyDrainBuilder<F>

pub fn kv_filter<K, T>(
    self,
    fallback_field: K,
    filter: T
) -> LogglyDrainBuilder<T>where
    K: Into<Key>,

Use a given key-value pair filter.

All key-value pairs rejected by the given filter will be serialized under a given fallback field.

This feature can be used if you want Loggly to index only a given subset of fields.

pub fn debug_mode(self, enable: bool) -> Self

Enable or disable debug mode (it’s disabled by default). In the debug mode you’ll be able to see some runtime info on stderr that will help you with setting up the drain (e.g. failed requests). With debug mode disabled, all errors will be silently ignored.

pub fn queue_max_size(self, size: usize) -> Self

Set a given maximum size of the message queue (the default is unlimited).

pub fn batch_size(self, size: usize) -> Self

Maximum number of messages sent in one batch (the default is 20). Please note that all log messages are sent as soon as possible. Increasing batch size won’t cause any delays in sending messages. If there is not enough messages in the internal queue to make a maximum size batch, a smaller batch is sent.

pub fn sender_count(self, count: usize) -> Self

Set the number of concurrent senders (the default is 16).

pub fn request_timeout(self, timeout: Duration) -> Self

Set Loggly request timeout (the default is 5 seconds).

pub fn connector(self, connector: HttpsConnector<HttpConnector>) -> Self

Use a given HttpsConnector. The connector is used only if the log message sender is spawned as a task.

pub fn build(
    self
) -> Result<(LogglyDrain<F>, LogglyMessageSender, FlushHandle), Error>

Build a Loggly drain.

pub fn spawn_task(self) -> Result<(LogglyDrain<F>, FlushHandle), Error>

Spawn a tokio task within the current executor context. The task will be responsible for sending all log messages.

pub fn spawn_thread(self) -> Result<(LogglyDrain<F>, FlushHandle), Error>

Spawn a thread responsible for sending all log messages.