<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Serilog.Sinks.PeriodicBatching</name>
    </assembly>
    <members>
        <member name="T:Serilog.Sinks.PeriodicBatching.BatchedConnectionStatus">
            <summary>
            Manages reconnection period and transient fault response for <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>.
            During normal operation an object of this type will simply echo the configured batch transmission
            period. When availability fluctuates, the class tracks the number of failed attempts, each time
            increasing the interval before reconnection is attempted (up to a set maximum) and at predefined
            points indicating that either the current batch, or entire waiting queue, should be dropped. This
            Serves two purposes - first, a loaded receiver may need a temporary reduction in traffic while coming
            back online. Second, the sender needs to account for both bad batches (the first fault response) and
            also overproduction (the second, queue-dropping response). In combination these should provide a
            reasonable delivery effort but ultimately protect the sender from memory exhaustion.
            </summary>
            <remarks>
            Currently used only by <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>, but may
            provide the basis for a "smart" exponential backoff timer. There are other factors to consider
            including the desire to send batches "when full" rather than continuing to buffer, and so-on.
            </remarks>
        </member>
        <member name="T:Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink">
            <summary>
            Interface for targets that accept events in batches.
            </summary>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink.EmitBatchAsync(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})">
            <summary>
            Emit a batch of log events, running asynchronously.
            </summary>
            <param name="batch">The batch of events to emit.</param>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink.OnEmptyBatchAsync">
            <summary>
            Allows sinks to perform periodic work without requiring additional threads
            or timers (thus avoiding additional flush/shut-down complexity).
            </summary>
        </member>
        <member name="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink">
            <summary>
            Buffers log events into batches for background flushing.
            </summary>
            <remarks>
            To avoid unbounded memory growth, events are discarded after attempting
            to send a batch, regardless of whether the batch succeeded or not. Implementers
            that want to change this behavior need to either implement from scratch, or
            embed retry logic in the batch emitting functions.
            </remarks>
        </member>
        <member name="F:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.NoQueueLimit">
            <summary>
            Constant used with legacy constructor to indicate that the internal queue shouldn't be limited.
            </summary>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.#ctor(Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink,Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions)">
            <summary>
            Construct a <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>.
            </summary>
            <param name="batchedSink">A <see cref="T:Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink"/> to send log event batches to. Batches and empty
            batch notifications will not be sent concurrently. When the <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/> is disposed,
            it will dispose this object if possible.</param>
            <param name="options">Options controlling behavior of the sink.</param>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.#ctor(System.Int32,System.TimeSpan)">
            <summary>
            Construct a <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>. New code should avoid subclassing
            <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/> and use
            <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.#ctor(Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink,Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions)"/>
            instead.
            </summary>
            <param name="batchSizeLimit">The maximum number of events to include in a single batch.</param>
            <param name="period">The time to wait between checking for event batches.</param>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.#ctor(System.Int32,System.TimeSpan,System.Int32)">
            <summary>
            Construct a <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>. New code should avoid subclassing
            <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/> and use
            <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.#ctor(Serilog.Sinks.PeriodicBatching.IBatchedLogEventSink,Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions)"/>
            instead.
            </summary>
            <param name="batchSizeLimit">The maximum number of events to include in a single batch.</param>
            <param name="period">The time to wait between checking for event batches.</param>
            <param name="queueLimit">Maximum number of events in the queue - use <see cref="F:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.NoQueueLimit"/> for an unbounded queue.</param>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.Dispose">
            <summary>
            Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
            </summary>
            <filterpriority>2</filterpriority>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.Dispose(System.Boolean)">
            <summary>
            Free resources held by the sink.
            </summary>
            <param name="disposing">If true, called because the object is being disposed; if false,
            the object is being disposed from the finalizer.</param>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatch(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})">
            <summary>
            Emit a batch of log events, running to completion synchronously.
            </summary>
            <param name="events">The events to emit.</param>
            <remarks>Override either <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatch(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})"/> or <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatchAsync(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})"/>,
            not both.</remarks>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatchAsync(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})">
            <summary>
            Emit a batch of log events, running asynchronously.
            </summary>
            <param name="events">The events to emit.</param>
            <remarks>Override either <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatchAsync(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})"/> or <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.EmitBatch(System.Collections.Generic.IEnumerable{Serilog.Events.LogEvent})"/>,
            not both. </remarks>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.Emit(Serilog.Events.LogEvent)">
            <summary>
            Emit the provided log event to the sink. If the sink is being disposed or
            the app domain unloaded, then the event is ignored.
            </summary>
            <param name="logEvent">Log event to emit.</param>
            <exception cref="T:System.ArgumentNullException">The event is null.</exception>
            <remarks>
            The sink implements the contract that any events whose Emit() method has
            completed at the time of sink disposal will be flushed (or attempted to,
            depending on app domain state).
            </remarks>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.CanInclude(Serilog.Events.LogEvent)">
            <summary>
            Determine whether a queued log event should be included in the batch. If
            an override returns false, the event will be dropped.
            </summary>
            <param name="logEvent">An event to test for inclusion.</param>
            <returns>True if the event should be included in the batch; otherwise, false.</returns>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatch">
            <summary>
            Allows derived sinks to perform periodic work without requiring additional threads
            or timers (thus avoiding additional flush/shut-down complexity).
            </summary>
            <remarks>Override either <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatch"/> or <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatchAsync"/>,
            not both. </remarks>
        </member>
        <member name="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatchAsync">
            <summary>
            Allows derived sinks to perform periodic work without requiring additional threads
            or timers (thus avoiding additional flush/shut-down complexity).
            </summary>
            <remarks>Override either <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatchAsync"/> or <see cref="M:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink.OnEmptyBatch"/>,
            not both. </remarks>
        </member>
        <member name="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions">
            <summary>
            Initialization options for <see cref="T:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSink"/>.
            </summary>
        </member>
        <member name="P:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions.EagerlyEmitFirstEvent">
            <summary>
            Eagerly emit a batch containing the first received event, regardless of
            the target batch size or batching time. This helps with perceived "liveness"
            when running/debugging applications interactively. The default is <c>true</c>.
            </summary>
        </member>
        <member name="P:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions.BatchSizeLimit">
            <summary>
            The maximum number of events to include in a single batch. The default is <c>1000</c>.
            </summary>
        </member>
        <member name="P:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions.Period">
            <summary>
            The time to wait between checking for event batches. The default is two seconds.
            </summary>
        </member>
        <member name="P:Serilog.Sinks.PeriodicBatching.PeriodicBatchingSinkOptions.QueueLimit">
            <summary>
            Maximum number of events to hold in the sink's internal queue, or <c>null</c>
            for an unbounded queue. The default is <c>100000</c>.
            </summary>
        </member>
    </members>
</doc>
