Skip to content

A rack + redis based service status page for Heroku apps.

License

Notifications You must be signed in to change notification settings

nsweeting/heroku-logplex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Heroku-Logplex

Code Climate

Heroku-Logplex lets you monitor your heroku dynos and databases using its log drain service. It takes these results and reports them in a very simple status page.

It does this through a thin setup of rack + redis.

You can read more about Heroku's log drain service and how to set it up here:

https://devcenter.heroku.com/articles/log-drains

How to Use

  • Set up a new dyno for Heroku-Logplex.
  • Set up a new redis server for Heroku-Logplex. Heroku provides a free tier that is more than suitable.
  • You will be using HTTPS drains, so you will need to set up username and password. The username and password for Heroku-Logplex should be set in the config.ru file (though it should be set with environment variables).
  • Set up the log drain service using your new dyno address, as well as the username and password. The address should look like https://user:pass@mylogdrainaddress.herokuapp.com/logger (make sure to add /logger).
  • You will recieve a logplex drain token. Set the drain token as an environment variable (LOGPLEX_DRAIN_TOKEN) on your new dyno.
  • Configure which services you want to monitor via conifg/application.yml

How it works

Heroku's log drain will send its data via POST requests to Heroku-Logplex. Heroku-Logplex will then parse this data and feed it to redis with an expiry. If Heroku-Logplex doesn't recieve a logplex message for a certain service, the assumption is made that something is wrong.

About

A rack + redis based service status page for Heroku apps.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages