Skip to content

Elixir.Logger backend for Syslog via UDP/TCP/UNIX socket

License

Notifications You must be signed in to change notification settings

traitify/dumpster

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dumpster

An Elixir.Logger backend for sending your logs to a syslog server via TCP, UDP, or UNIX socket. Uses :syslog_socket under the hood.

Why?

ExSyslogger is the only other maintained syslog backend I could find, but unfortunately the Erlang library it wraps (:erlang-syslog) does not support TCP or UDP transport. This is a problem if you're running Elixir in containers and trying to use a host syslog server.

Why did you name it 'Dumpster'?

I refer to most code (most especially my own) as a dumpster fire. Also, the previous "log sink" (hack) I used was redirecting :console to a file, then having a process reading that file and pushing the contents to rsyslog (throw in logrotate and out of disk errors for a great time). If you can imagine dumping 10,000 gallons of water in a kitchen sink vs a giant dumpster, where the sink is the previous solution and the--oh whatever naming things is hard.

Installation

If available in Hex, the package can be installed by adding dumpster to your list of dependencies in mix.exs:

def deps do
  [
    {:dumpster, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/dumpster.

About

Elixir.Logger backend for Syslog via UDP/TCP/UNIX socket

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Elixir 100.0%