Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/truqu/lager_logstash
Send logs from lager to logstash
https://github.com/truqu/lager_logstash
erlang lager logstash
Last synced: about 15 hours ago
JSON representation
Send logs from lager to logstash
- Host: GitHub
- URL: https://github.com/truqu/lager_logstash
- Owner: truqu
- License: mit
- Created: 2019-01-13T14:50:01.000Z (almost 6 years ago)
- Default Branch: develop
- Last Pushed: 2019-09-12T07:28:25.000Z (about 5 years ago)
- Last Synced: 2024-10-13T18:42:57.317Z (about 1 month ago)
- Topics: erlang, lager, logstash
- Language: Erlang
- Homepage: https://hex.pm/packages/lager_logstash
- Size: 17.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `lager_logstash` [![Build Status](https://travis-ci.org/truqu/lager_logstash.svg?branch=develop)](https://travis-ci.org/truqu/lager_logstash)
> Logstash backend for lager## Configuration
Add `lager` and `lager_logstash` to `rebar.config`:
```erlang
{deps, [lager, lager_logstash]}.
```Add configuration to `sys.config`:
```erlang
{lager, [{ handlers
, [{ lager_logstash_backend
, [ {host, "logstash_host"}
, {port, 9125}
]
}]
}]
}
```> **Note**: Logstash requires timestamps to be in UTC. However, there is no need
> to do anything special to get this working - `lager_logstash` does the
> conversion for you.Configure a logstash pipeline:
```
input {
udp {
codec => "json"
port => 9125
}
}output {
...
}```
## Supported options
| Option | Default | Acceptable values |
|-------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| `host` (required) | / | `inet:socket_address()` or `inet:hostname()` |
| `port` (required) | / | `inet:port_number()` |
| `level` | `info` | `lager:log_level()` - including [syslog style comparison flags](https://github.com/erlang-lager/lager#syslog-style-loglevel-comparison-flags) |
| `fields` | `[]` | `[{atom(), jsx:json_term()}]` - allows specifying a bunch of extra fields to be included |## Output format
All metadata is included as fields. Code like this:
```erlang
-module foo-export([bar/0]).
bar () ->
lager:info([{foo, bar}], "Hello ~s", ["world"]).
```Would result in JSON like this:
```javascript
{
"message": "Hello world",
"@timestamp": "2019-01-13T21:33:56.925Z",
"fields": {
"severity": "info",
"foo": "bar",
"application": "otp_application",
"node": "some_node@localhost",
"pid": "<0.13919.0>",
"module": "foo",
"function": "bar",
"line": "6"
}
}
```## License
Released under the MIT license - please see the `LICENSE` file.
© 2019 - TruQu