README.md in service_skeleton-0.0.0.3.g1269800 vs README.md in service_skeleton-0.0.0.3.g1269800.1.gaaa2fa1
- old
+ new
@@ -302,11 +302,15 @@
The `ServiceSkeleton` also provides built-in dynamic log level adjustment;
using Unix signals or the admin HTTP interface (if enabled), you can tell the
logger to increase or decrease logging verbosity *without interrupting
service*. We are truly living in the future.
+Finally, if you're a devotee of the ELK stack, we can automagically send log
+entries straight into logstash, rather than you having to do it in some
+more roundabout fashion.
+
### Logging Configuration
The logger automatically sets its configuration from, you guessed it, the
environment. The following environment variables are recognised by the logger.
All are all-uppercase, and the `<SERVICENAME>_` portion is the all-uppercase
@@ -339,9 +343,18 @@
INFO,buggy=DEBUG,/noisy/i=ERROR
Logging levels can be changed at runtime, via [signals](#default-signals) or
[the HTTP admin interface](#http-admin-interface).
+
+* **`<SERVICENAME>_LOGSTASH_SERVER`** (string; default `""`) -- if set to a
+ non-empty string, we will engage the services of the [loggerstash
+ gem](https://github.com/discourse/loggerstash) on your behalf to send all log
+ entries to the logstash server you specify (as [an `address:port`,
+ `hostname:port`, or SRV
+ record](https://github.com/discourse/logstash_writer#usage). Just be sure
+ and [configure logstash
+ appropriately](https://github.com/discourse/loggerstash#logstash-configuration).
* **`<SERVICENAME>_LOG_ENABLE_TIMESTAMPS`** (boolean; default: `"no"`) -- if
set to a true-ish value (`yes`/`y`/`on`/`true`/`1`), then the log entries
emitted by the logger will have the current time (to the nearest nanosecond)
prefixed to them, in RFC3339 format