robinmonjo / parklog Goto Github PK

Simple tool written in Go to redirect your app stdout/stderr to different local or remote endpoints.

bundle exec rails s | parklog [-c <path_to_config>] [-v]

• -c <path_to_config> path to the config file (default ./parklog.json)
• -v verbose

Config example

[
  {
    "url":"file:///dev/stdout",
    "prefix":"Rails app on stdout - "
  },
  {
    "url":"tcp://localhost:9999"
  },
  {
    "url":"tcp://localhost:9998",
    "prefix":"Rails app log on 9998 - "
  },
  {
    "url":"tls://localhost:9997",
    "allow_self_signed_cert": true
  }
]

You can redirect to several endpoints including local files, tcp servers, tls/ssl servers etc ... For a full list of supported endpoints refer to golang net package

You can also inject environment variable inside the parklog.json:

export PORT_A=9999
export URI="file:///dev/stdout"
export PREFIX="Rails app log on 9998 - "

[
  {
    "url":"file://$PWD/log.out"
  },
  {
    "url":"$URI",
    "prefix":"Rails app on stdout - "
  },
  {
    "url":"tcp://localhost:$PORT_A"
  },
  {
    "url":"tcp://localhost:9998",
    "prefix":"$PREFIX"
  },
  {
    "url":"tls://localhost:9997",
    "allow_self_signed_cert": true
  }
]

You can change parklog's config without restarting it. For that you can edit your config file then:

1. Find parklog's PID (using ps -ef | grep parklog)
2. Send SIGUSR2 signal to parklog: kill -s USR2 <PID>

If your config file is not valid (i.e contains JSON syntax error), the config changed won't be performed.

OSX

curl -sL https://github.com/robinmonjo/parklog/releases/download/v0.2.0/parklog_darwin_x86_64.tgz | tar -C /usr/local/bin -zxf -

Linux arm (Raspbery Pi)

curl -sL https://github.com/robinmonjo/parklog/releases/download/v0.2.0/parklog_linux_pi.tgz | tar -C /usr/local/bin -zxf -

Linux

curl -sL https://github.com/robinmonjo/parklog/releases/download/v0.2.0/parklog_linux_x86_64.tgz | tar -C /usr/local/bin -zxf -

MIT