> For the complete documentation index, see [llms.txt](https://vostok.gitbook.io/logging/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vostok.gitbook.io/logging/configuration.md).

# Configuration

This page describes approaches to configuration employed in Vostok.Logging.

### Composing loggers hierarchy

There's no such thing as a log factory or log provider: there are just [ILog](https://github.com/vostok/logging.abstractions/blob/master/Vostok.Logging.Abstractions/ILog.cs) instances, and the only way to get one initially is to instantiate one of the available [implementations](/logging/implementations.md) in code. Everything else is achieved with decorator-based extensions and interface methods:

* [Combining](/logging/how-to-guides/combining-multiple-logs.md) multiple logs into one.
* [Filtering](/logging/how-to-guides/filtering-events-by-level.md) incoming events.
* [Enriching](/logging/how-to-guides/enriching-events-with-custom-properties.md) incoming events with properties.
* Obtaining log instances tied to specific [source context](/logging/concepts/source-context.md).

This approach may look unfamiliar to prior [log4net](https://logging.apache.org/log4net/) users experienced with [XML configuration files](https://logging.apache.org/log4net/release/manual/configuration.html). Indeed, it lacks additional flexibility offered by file-based configs but enables much easier setup for new applications.

### Injecting loggers into code

It's preferable to inject log instances explicitly through constructors, either using a DI container or simply passing them manually. [Static log provider](/logging/how-to-guides/using-static-log-provider.md) may be sufficient for simple applications, though.

### Configuring individual loggers

Individual log instances (such as [console log](/logging/implementations/console-log.md) or [file log](/logging/implementations/file-log.md)) are typically configured in code by passing a settings object. However, some implementations (namely [file log](/logging/implementations/file-log.md)) also accept an arbitrary settings provider delegate that can be used to configure from external sources using [Vostok.Configuration](https://vostok.gitbook.io/configuration/) library.

Also, simple filtering and enrichment rules can be supplied from [external configuration](/logging/how-to-guides/external-configuration-rules.md).