Skip to content

Commit 845abbc

Browse files
author
Charlie Livingston
committed
Add README.md
1 parent 4a10f7b commit 845abbc

File tree

1 file changed

+39
-0
lines changed

1 file changed

+39
-0
lines changed

README.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
pm2-gelf
2+
=================
3+
4+
An quick and dirty library to redirect your [PM2](http://pm2.io) logs to a [GELF](http://docs.graylog.org/en/latest/pages/gelf.html) input stream
5+
6+
* Heavily based on [https://github.com/dfrankland/pm2-loggly](https://github.com/dfrankland/pm2-loggly)
7+
* Uses [https://github.com/robertkowalski/gelf-node](https://github.com/robertkowalski/gelf-node) to output to GELF
8+
9+
## Installation
10+
11+
Tested on node-4.5.x, requires pm2.
12+
13+
```sh
14+
pm2 install pm2-gelf
15+
```
16+
17+
## Configuration
18+
19+
This module has multiple configuration variables, all fed into gelf-node
20+
21+
- "graylogPort": The UDP port to send gelf messages to (Default: 12201)
22+
- "graylogHostname": The hostname of the GELF input (Default: '127.0.0.1')
23+
- "connection": Lan or Wan - The connection type (Default: 'wan')
24+
- "maxChunkSizeWan": The largest chunk to send via WAN (Default: 1420)
25+
- "maxChunkSizeLan": The largest chunk to sent via LAN (Default: 8154)
26+
27+
28+
After having installed the module:
29+
30+
```sh
31+
pm2 set pm2-gelf:<param> <value>
32+
```
33+
34+
Examples:
35+
36+
```sh
37+
pm2 set pm2-gelf:graylogHostname my.cool.host
38+
pm2 set pm2-gelf:graylogPort 12345
39+
```

0 commit comments

Comments
 (0)