Source context
Source context is meant to denote the sources of logging events, such as classes calling the log methods. This context also encodes the hierarchy of log's ownership. It is produced with
ForContext method and bound to returned log instance. The dominant use case for source context is to obtain class-based logs:1
class MyClass
2
{
3
private readonly ILog log;
4
​
5
public MyClass(ILog log)
6
{
7
this.log = log.ForContext<MyClass>();
8
}
9
}
Copied!
​
Structure
Source context exhibits hierarchical structure: chained
ForContext calls produce logs with multiple contexts ordered with respect to calls sequence.1
log = log
2
.ForContext("foo")
3
.ForContext("bar")
4
.ForContext("baz");
5
​
6
// log's source context is now ["foo", "bar", "baz"]
Copied!
​
Implementation details
Handling of source context is implementation-specific.
However, all built-in logs implement it by enriching incoming log events with a special well-known
SourceContext property. Its value is represented by public SourceContextValue type that implements IReadOnlyList<string> and has a pretty ToString. This behavior can be replicated in custom log implementations by returning a SourceContextWrapper from ForContext method.​
Rendering in text-based logs
Here's an example of how text-based logs render source context:
1
var log = new SynchronousConsoleLog() as ILog;
2
​
3
log = log.ForContext("foo");
4
​
5
log.Info("Message 1");
6
​
7
log = log.ForContext("bar");
8
​
9
log.Info("Message 2");
10
​
11
log = log.ForContext("baz");
12
​
13
log.Info("Message 3");
Copied!
Sample output from this code:
1
2019-03-10 01:21:25,517 INFO [foo] Message 1
2
2019-03-10 01:21:25,554 INFO [foo => bar] Message 2
3
2019-03-10 01:21:25,555 INFO [foo => bar => baz] Message 3
Copied!
Last modified 3yr ago
Copy link