Hercules log
1
var herculesLog = new HerculesLog(new HerculesLogSettings(herculesSink, logStreamName));
2
var dynamicallyConfiguredLog = new HerculesLog(() => ObtainSettings());
Copied!
HerculesLog converts incoming log events to Hercules events according to Hercules log event schema and then sends resulting events with an instance of IHerculesSink. Additional details on events mapping can be found in module's description on GitHub.Configuration
HerculesLog is configured with HerculesLogSettings, having 2 mandatory parameters:Option
Description
HerculesSinkAn instance of sink to send events with.
StreamName of the Hercules stream to send events to.
Ensure that provided sink instance is configured with an API key with sufficient permissions to write into selected stream.
Usage tips
- Prefer to use a singleton instance of
IHerculesSinkeverywhere in the application, includingHerculesLog. Sink instances involve background tasks and are therefore quite expensive. - Reporting of lost of log events generally depends on the nature of
IHerculesSinkimplementation. Default implementation in vostok.hercules.client repository provides a set of counters for these purposes.
Last modified 2yr ago
Copy link