External configuration rules

Prerequisites:

• Install configuration module​

• Read about log events​

• Read about source context​

• Read about filtering​

• Read about enrichment​

​ConfigurableLog is essentially a CompositeLog with named components and rules for filtering and enrichment. Rules can be supplied from any external source and support reconfiguration without application restart.

Log configuration rules

Every rule contains some of the following:

There are also some important points to remember when defining rules:

• You should never create two rules with identical scopes (Log + Source + Operation). Consider merging them instead.

• Rules without Log scope are evaluated before any log-specific rules are considered.

• When evaluating whether to log an event, the most specific of the matching rules gets to decide.

  • A rule with Source scope is more specific than a rule without any scope.

  • A rule with Operation scope is more specific than a rule without any scope.

  • A rule with Operation scope is more specific than a rule with Source scope.

  • A rule with Source + Operation scope is the most specific one possible.

• Additional properties are added from all matching rules.

Create a ConfigurableLog

var rules = new[]
{
    new LogConfigurationRule { Log = "c1", Source = "noisy", MinimumLevel = LogLevel.Warn},
    new LogConfigurationRule { Log = "c2", Enabled = false },
    new LogConfigurationRule { Log = "c3", Properties = new Dictionary<string, string> { ["key"] = "value" } }
};
​
var log = new ConfigurableLogBuilder()
    .AddLog("c1", new SynchronousConsoleLog())
    .AddLog("c2", new SynchronousConsoleLog())
    .AddLog("c3", new SynchronousConsoleLog())
    .SetRules(rules)
    .Build();

Rules can also be supplied with an IObservable<LogConfigurationRule[]>. Here's an equivalent of the configuration above using Vostok.Configuration library and storing rules in JSON file:

var source = new JsonFileSource("log-rules.json");
var rulesObservable = ConfigurationProvider.Default.Observe<LogConfigurationRule[]>(source);
​
var log = new ConfigurableLogBuilder()
    .AddLog("c1", new SynchronousConsoleLog())
    .AddLog("c2", new SynchronousConsoleLog())
    .AddLog("c3", new SynchronousConsoleLog())
    .SetRules(rulesObservable)
    .Build();

[
    { "Log": "c1", "Source": "noisy", "MinimumLevel": "Warn" },
    { "Log": "c2", "Enabled": "false" },
    { "Log": "c3", "Properties": { "key": "value" } }
]