<PackageReference Include="Relativity.Logging" Version="3000.9.0" />

---

API Differences between 3000.9.0 and 9.4.319

217 Additions 19 Removals

Relativity.Logging

• public class ConfigFileReader : IReadFile, IReadConfigurationParts, IDisposable
• public class Constants
  • public const string OPERATION_CONTEXT = "OperationContext"
  • public const string OPERATION_ID = "OperationID"
  • public const string R1_TEAM_ID = "r1.team.id"
  • public const string SERVICE_NAME = "service.name"
• public interface IGetAdditionalData
  • IEnumerable<KeyValuePair<string, object>> GetAdditionalData()
• public class LoggerOptions
  • public string ServiceName
  • public void SetAdditionalDataGetter(IGetAdditionalData additionalDataGetter)
• public class LoggerOptionsComparer : IEqualityComparer<LoggerOptions>
  • public LoggerOptionsComparer()
  • public bool Equals(LoggerOptions x, LoggerOptions y)
  • public int GetHashCode(LoggerOptions x)
• public class NullAdditionalDataGetter : IGetAdditionalData
  • public NullAdditionalDataGetter()
  • public IEnumerable<KeyValuePair<string, object>> GetAdditionalData()

Relativity.Logging.Configuration

• public class CacheLogConfigurationUpdater : MarshalByRefObject, ILogConfigurationUpdater, ICacheEventSubscriber
  • public CacheLogConfigurationUpdater(ICacheFilter cacheFilter, LogConfiguration logConfiguration, IConfigurationCache configurationCache)
  • public void OnCacheUpdated(object sender, CacheUpdatedEventArgs eventArgs)
  • public void Start()
• public class Configuration
  • public int PollingInterval { get; set; }
  • public bool CompareConfigurationToOptions(LoggerOptions options)
• public class ConsoleSinkConfig : Sink
  • public bool UseStdErrorForErrors { get; }
  • public ConsoleSinkConfig(string name, bool useStdErrorForErrors)
• public class EventLogSinkConfig : Sink
  • public string Source { get; }
  • public EventLogSinkConfig(string name, string source)
• public interface ICreateConfigurationReader
• public interface IReadConfiguration
• public interface IReadConfigurationParts
• public interface IReadFile : IReadConfigurationParts
• public interface IConfigurationReader
  • IEnumerable<Configuration> GetConfigurations()
  • DateTime? GetLastUpdated()
  • IEnumerable<Rule> GetRules()
  • IEnumerable<Sink> GetSinks()
• public interface ILogConfigurationUpdater
  • void Start()
• public interface ITimer : IDisposable
  • event ElapsedEventHandler Elapsed
  • void Start()
  • void Stop()
• public class OpenTelemetrySinkConfig : Sink
  • public const int DefaultBatchSizeLimit = 1000
  • public const bool DefaultEagerlyEmitFirstEvent = true
  • public const double DefaultPeriodInSeconds = 2
  • public const int DefaultQueueLimit = 100000
  • public string ApiKey { get; }
  • public int BatchSizeLimit { get; }
  • public bool EagerlyEmitFirstEvent { get; }
  • public string EndpointUrl { get; }
  • public TimeSpan Period { get; }
  • public int? QueueLimit { get; }
  • public OpenTelemetrySinkConfig(string name, string endpointUrl, string apiKey, int batchSizeLimit, bool eagerlyEmitFirstEvent, TimeSpan period, int? queueLimit)
• public class PollTimer : ITimer, IDisposable
  • public event ElapsedEventHandler Elapsed
  • public PollTimer(Timer timer)
  • public void Dispose()
  • protected virtual void Dispose(bool disposing)
  • public void Start()
  • public void Stop()
• public class Rule
  • public bool CompareRuleToOptions(LoggerOptions options)

Relativity.Logging.Configuration.Cache

• public abstract class BaseConfigurationCacheUpdater : IConfigurationCacheUpdater, IDisposable
  • protected readonly IConfigurationCache Cache
  • protected BaseConfigurationCacheUpdater(IConfigurationCache cache)
  • public abstract void Dispose()
  • protected IEnumerable<Configuration> GetConfigurations(IConfigurationReader reader)
  • protected IEnumerable<Rule> GetRules(IConfigurationReader reader)
  • protected IEnumerable<Sink> GetSinks(IConfigurationReader reader)
  • protected void SetCacheValues(IConfigurationReader reader, bool loggingEnabled = true)
  • protected void SetCacheValuesFromFile(IFileConfigurationReader reader)
  • public abstract void Start()
• public class CacheFilter : ICacheFilter
  • public IWildcardString Application { get; }
  • public IWildcardString MachineName { get; }
  • public IWildcardString SubSystem { get; }
  • public IWildcardString System { get; }
  • public CacheFilter(IWildcardString machineName, IWildcardString system, IWildcardString subSystem, IWildcardString application)
  • public bool Matches(ICacheFilter other)
• public class CacheUpdatedEventArgs : EventArgs
  • public HashSet<ICacheFilter> FiltersWithUpdatedConfigurations { get; }
  • public HashSet<ICacheFilter> FiltersWithUpdatedRules { get; }
  • public bool SinksUpdated { get; }
  • public CacheUpdatedEventArgs(HashSet<ICacheFilter> filtersWithUpdatedRules, HashSet<ICacheFilter> filtersWithUpdatedConfigurations, bool sinksUpdated)
• public class CacheUpdaterFactory
  • public CacheUpdaterFactory()
  • public bool TryCreate(IConfigurationCache cache, LoggerOptions options, out IConfigurationCacheUpdater cacheUpdater)
• public class ConfigurationCache : MarshalByRefObject, IConfigurationCache
  • public event EventHandler<CacheUpdatedEventArgs> CacheUpdated
  • public ConfigurationCache()
  • public DateTime GetLastUpdated()
  • public IEnumerable<Rule> GetRules(ICacheFilter filter)
  • public IEnumerable<Sink> GetSinks()
  • public bool IsLoggingEnabled(ICacheFilter filter)
  • public void Set(HashSet<Sink> incomingSinks, HashSet<Rule> incomingRules, HashSet<Configuration> incomingConfigurations, bool loggingEnabled = true)
• public class FileWatchingConfigurationCacheUpdater : BaseConfigurationCacheUpdater
  • public FileWatchingConfigurationCacheUpdater(IConfigurationCache cache, IFileConfigurationReader reader, IConfigurationFileWatcher watcher)
  • protected virtual void Dispose(bool disposing)
• public interface ICacheEventSubscriber
  • void OnCacheUpdated(object sender, CacheUpdatedEventArgs eventArgs)
• public interface ICacheFilter
  • IWildcardString Application { get; }
  • IWildcardString MachineName { get; }
  • IWildcardString SubSystem { get; }
  • IWildcardString System { get; }
  • bool Matches(ICacheFilter other)
• public interface IConfigurationCache
  • event EventHandler<CacheUpdatedEventArgs> CacheUpdated
  • DateTime GetLastUpdated()
  • IEnumerable<Rule> GetRules(ICacheFilter filter)
  • IEnumerable<Sink> GetSinks()
  • bool IsLoggingEnabled(ICacheFilter filter)
  • void Set(HashSet<Sink> sinks, HashSet<Rule> rules, HashSet<Configuration> configurations, bool loggingEnabled)
• public interface IConfigurationCacheUpdater : IDisposable
  • void Start()
• public class PollingConfigurationCacheUpdater : BaseConfigurationCacheUpdater
  • public PollingConfigurationCacheUpdater(IConfigurationCache cache, IConfigurationReader reader, ITimer timer)
  • protected virtual void Dispose(bool disposing)
• public class PollingFileFallbackConfigurationCacheUpdater : BaseConfigurationCacheUpdater
  • public PollingFileFallbackConfigurationCacheUpdater(IConfigurationCache cache, IFileConfigurationReader fallbackReader, IConfigurationReader pollReader, IConfigurationFileWatcher watcher, ITimer timer)
  • protected virtual void Dispose(bool disposing)

Relativity.Logging.Configuration.ConfigReaders

• public class EDDSReader : IReadConfiguration
• public class FailOverReader : IReadConfiguration
• public class LocalFile : IReadConfiguration
• public class NullReader : IReadConfiguration

Relativity.Logging.Configuration.EDDS

• public class DatabaseReader : MarshalByRefObject, IReadDatabase, IReadConfigurationParts
• public class DatabaseWriter : IWriteDatabase, IWriteConfigurationsParts
• public class DatabaseConfigurationReader : IConfigurationReader
  • public DatabaseConfigurationReader(IDatabaseContext context)
  • public IEnumerable<Configuration> GetConfigurations()
  • public DateTime? GetLastUpdated()
  • public IEnumerable<Rule> GetRules()
  • public IEnumerable<Sink> GetSinks()
• public interface IReadDatabase : IReadConfigurationParts
• public interface IWriteDatabase : IWriteConfigurationsParts
• public interface IDatabaseContext
  • IEnumerable<Configuration> GetConfigurations()
  • DateTime? GetLastUpdated()
  • IEnumerable<Rule> GetRules()
  • IEnumerable<RuleSink> GetRuleSinks(IEnumerable<int> ruleIds)
  • IEnumerable<Sink> GetSinks()
• public class KCuraDatabaseContext : IDatabaseContext
  • public KCuraDatabaseContext(BaseContext context, ICreateSinks sinkFactory)
  • public IEnumerable<Configuration> GetConfigurations()
  • public DateTime? GetLastUpdated()
  • public IEnumerable<Rule> GetRules()
  • public IEnumerable<RuleSink> GetRuleSinks(IEnumerable<int> ruleIds)
  • public IEnumerable<Sink> GetSinks()
• public class NoOpDatabaseContext : IDatabaseContext
  • public NoOpDatabaseContext()
  • public IEnumerable<Configuration> GetConfigurations()
  • public DateTime? GetLastUpdated()
  • public IEnumerable<Rule> GetRules()
  • public IEnumerable<RuleSink> GetRuleSinks(IEnumerable<int> ruleIds)
  • public IEnumerable<Sink> GetSinks()
• public class RuleSink
  • public int Id
  • public string Name
  • public RuleSink()
• public enum SinkType
  • Console = 8
  • EventLog = 7
  • OpenTelemetry = 9

Relativity.Logging.Configuration.Interface

• public interface IWriteConfigurationsParts

Relativity.Logging.Configuration.Local

• public class ConfigurationFileWatcher : IConfigurationFileWatcher, IDisposable
  • public int FailureCount { get; }
  • public ConfigurationFileWatcher(FileSystemWatcher systemWatcher)
  • public void Dispose()
  • protected virtual void Dispose(bool disposing)
  • public void Start(Func<bool> tryOnChange)
• public class FileConfigurationReader : IFileConfigurationReader, IConfigurationReader
  • public FileConfigurationReader(string filePath)
  • public IEnumerable<Configuration> GetConfigurations()
  • public DateTime? GetLastUpdated()
  • public MasterLoggingConfiguration GetLoggingSetting()
  • public IEnumerable<Rule> GetRules()
  • public IEnumerable<Sink> GetSinks()
  • public bool IsLoggingEnabled()
• public interface IConfigurationFileWatcher : IDisposable
  • event FileSystemEventHandler Changed
  • void Start(Func<bool> tryOnChange)
• public interface IFileConfigurationReader : IConfigurationReader
  • MasterLoggingConfiguration GetLoggingSetting()
  • bool IsLoggingEnabled()

Relativity.Logging.Configuration.Serilog

• public class ConfigurationReaderFactory : ICreateConfigurationReader
• public class SerilogLogConfiguration
  • public string ServiceName { get; }

Relativity.Logging.Factory

• public static class LogFactory
  • public static void SetDefaultConfigurationCache(ConfigurationCache cache)
  • public static bool TryCreateCacheUpdater(LoggerOptions options, IConfigurationCache cache)

Relativity.Logging.Loggers

• public interface ISafelyInitializedLoggerProxyFactory
  • ILog Create(Func<ILog> getLogger)

Relativity.Logging.Sinks

• public class ConsoleSink : ILogEventSink, IDisposable
  • public ConsoleSink(ITextFormatter formatter, bool useStdErrorForErrors)
  • public void Dispose()
  • public void Emit(LogEvent logEvent)
• public class MemorySink : ILogEventSink, IDisposable
  • public static List<LogEvent> MemoryLogList
  • public MemorySink()
  • public static void ClearList()
  • public void Dispose()
  • public void Emit(LogEvent logEvent)
• public class TcpSink : PeriodicBatchingSink
  • protected static readonly UTF8Encoding Utf8
  • public TcpSink(TcpSinkConnectionInfo connectionInfo, ITextFormatter textFormatter, int batchPostingLimit, TimeSpan period, IInternalLogger internalLogger)
• public class TcpSinkConnection
  • public TcpSinkConnection(TcpSinkConnectionInfo connectionInfo)
  • public void Close()
  • public Task ConnectAsync()
  • public Task FlushAsync()
  • public Task WriteAsync(byte[] buffer, int offset, int count)
• public class TcpSinkConnectionInfo
  • public const int DefaultMaxQueueSize = 10000
  • public IPAddress Host { get; }
  • public int MaxQueueSize { get; set; }
  • public int Port { get; }
  • public TcpSinkConnectionInfo(string host, int port)
  • public TcpSinkConnectionInfo(IPAddress host, int port)

Relativity.Logging.Sinks.Factory

• public class ConsoleSinkFactory
  • public ConsoleSinkFactory()
  • public ILogEventSink GetConsoleSink(Sink sink)
• public class EventLogSinkFactory
  • public EventLogSinkFactory(LoggerOptions options)
  • public ILogEventSink GetEventLogSinkConfig(Sink sink)
• public class OpenTelemetrySinkFactory
  • public OpenTelemetrySinkFactory()
  • public ILogEventSink GetOpenTelemetrySinkConfig(Sink sink)

Relativity.Logging.Tools

• public class AsteriskWildcardString : IWildcardString
  • public static AsteriskWildcardString Wild
  • public bool IsWild { get; }
  • public string Value { get; }
  • public AsteriskWildcardString(string value)
• public static class Guard
  • public static void AgainstNull(object argument, string argumentName)
• public interface IWildcardString
  • bool IsWild { get; }
  • string Value { get; }

Relativity.Logging.Tools.Watcher

• public interface IWatcherConfigFile : IDisposable