/// <summary>
/// Adds a Serilog sink that writes <see cref="Serilog.Events.LogEvent" /> to Apache Kafka using
/// a custom <see cref="ITextFormatter" />.
/// </summary>
/// <param name="sinkConfiguration">Logger sink configuration.</param>
/// <param name="formatter">A formatter to convert the log events into text for the kafka.</param>
/// <param name="kafka">Options to configure communication with kafka.</param>
/// <param name="batch">Options to configure sink write log events in batches.</param>
/// <returns>Configuration object allowing method chaining.</returns>
public static LoggerConfiguration Kafka(this LoggerSinkConfiguration sinkConfiguration,
ITextFormatter formatter, KafkaOptions kafka, BatchOptions batch)
{
if (sinkConfiguration == null)
{
throw new ArgumentNullException(nameof(sinkConfiguration));
}
if (formatter == null)
{
throw new ArgumentNullException(nameof(formatter));
}
if (kafka == null)
{
throw new ArgumentNullException(nameof(kafka));
}
if (batch == null)
{
throw new ArgumentNullException(nameof(batch));
}
var kafkaSink = KafkaSink.Create(formatter, kafka, batch);
return(sinkConfiguration.Sink(kafkaSink));
}
/// <summary>
/// Adds a Serilog sink that writes <see cref="Serilog.Events.LogEvent" /> to Apache Kafka using
/// a custom <see cref="ITextFormatter" />. In case of kafka unavailability,
/// <see cref="Serilog.Events.LogEvent" /> will be written to <paramref name="fallback" /> sink.
/// </summary>
/// <param name="sinkConfiguration">Logger sink configuration.</param>
/// <param name="formatter">A formatter to convert the log events into text for the kafka.</param>
/// <param name="kafka">Options to configure communication with kafka.</param>
/// <param name="batch">Options to configure sink write log events in batches.</param>
/// <param name="fallbackTime">Time to wait between checking of kafka availability.</param>
/// <param name="fallback">Fallback sink to write the log events when kafka is unavailable.</param>
/// <returns>Configuration object allowing method chaining.</returns>
public static LoggerConfiguration Kafka(this LoggerSinkConfiguration sinkConfiguration,
ITextFormatter formatter, KafkaOptions kafka, BatchOptions batch, ILogEventSink fallback,
TimeSpan fallbackTime)
{
if (sinkConfiguration == null)
{
throw new ArgumentNullException(nameof(sinkConfiguration));
}
if (formatter == null)
{
throw new ArgumentNullException(nameof(formatter));
}
if (kafka == null)
{
throw new ArgumentNullException(nameof(kafka));
}
if (batch == null)
{
throw new ArgumentNullException(nameof(batch));
}
if (fallback == null)
{
throw new ArgumentNullException(nameof(fallback));
}
if (fallbackTime <= TimeSpan.Zero)
{
throw new ArgumentOutOfRangeException(nameof(fallbackTime), "The fallback time must be positive");
}
var kafkaSink = KafkaSink.Create(formatter, kafka, batch);
return(sinkConfiguration.Sink(KafkaFailoverSink.Create(kafkaSink, fallback, batch, fallbackTime)));
}