Persistence

Local database

The recommended way to cache log events between emitting and transmission to the Logstash server is using a local SQLite database. This way log events are cached even across process restarts (and crashes). Especially on network problems or a longer unavailbility of the Logstash server this might come in handy.

Note

Using multiple instances of AsynchronousLogstashHandler with different database_path settings won’t work because there is only one LogProcessingWorker instance and it is configured with the database_path setting from the first handler which emits a log event.

In-memory cache

To use an in-memory cache to persist log events between transmissions, simple do not provide a database_path to AsynchronousLogstashHandler.

There are a couple of things you should keep in mind if you choose to go down this path. Cached events will not be kept across process restarts when using the in-memory cache. This means it is possible to lose messages. If you cannot lose messages, then you should set the database_path option.

In addition, you can also set a TTL to live on all of the messages that should be published. Simply pass event_ttl to the initializer and your events will be aged off from the cache. The TTL is in seconds.