raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 10

clarify async appender (#28241)

Browse source 
* increase queue size in prod example
* remove async from dev example
* links to ELK-stack
This commit is contained in:
Patrik Nordwall 2019-11-25 17:06:13 +01:00 • committed by Johan Andrén
parent bc2d3aa4db
commit 2ef50cb054
3 changed files with 16 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

8
akka-actor-typed-tests/src/test/resources/logback-doc-dev.xml
View file

@ -17,14 +17,8 @@
</encoder>
</appender>
<appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
<queueSize>1024</queueSize>
<neverBlock>true</neverBlock>
<appender-ref ref="FILE" />
</appender>
<root level="DEBUG">
<appender-ref ref="STDOUT"/>
<appender-ref ref="ASYNC"/>
<appender-ref ref="FILE"/>
</root>
</configuration>

2
akka-actor-typed-tests/src/test/resources/logback-doc-prod.xml
View file

@ -13,7 +13,7 @@
</appender>
<appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
<queueSize>1024</queueSize>
<queueSize>8192</queueSize>
<neverBlock>true</neverBlock>
<appender-ref ref="FILE" />
</appender>

14
akka-docs/src/main/paradox/typed/logging.md
View file

@ -196,6 +196,20 @@ A starting point for configuration of `logback.xml` for production:
@@snip [logback.xml](/akka-actor-typed-tests/src/test/resources/logback-doc-prod.xml)
Note that the `AsyncAppender` may drop log events if the queue becomes full, which may happen if the
logging backend can't keep up with the throughput of produced log events. Dropping log events is necessary
if you want to gracefully degrade your application if only your logging backend or filesystem is experiencing
issues.
An alternative of the Logback `AsyncAppender` with better performance is the [Logstash async appender](https://github.com/logstash/logstash-logback-encoder#async-appenders).
The ELK-stack is commonly used as logging infrastructure for production:
* [Logstash Logback encoder](https://github.com/logstash/logstash-logback-encoder)
* [Logstash](https://www.elastic.co/guide/en/logstash/current/index.html)
* [Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html)
* [Kibana](https://www.elastic.co/guide/en/kibana/current/index.html)
For development you might want to log to standard out, but also have all debug level logging to file, like
in this example: