https://github.com/vimeo/tailgate

Tailgate is a nodejs app to pipe `tail -F` into websockets. It's a very simple way to have real-time access to your logs.
https://github.com/vimeo/tailgate

Last synced: 9 months ago
JSON representation

Tailgate is a nodejs app to pipe `tail -F` into websockets. It's a very simple way to have real-time access to your logs.

• Host: GitHub
• URL: https://github.com/vimeo/tailgate
• Owner: vimeo
• License: other
• Created: 2012-06-21T16:30:41.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2023-03-13T07:10:40.000Z (almost 3 years ago)
• Last Synced: 2025-04-03T22:41:36.655Z (9 months ago)
• Language: JavaScript
• Size: 801 KB
• Stars: 164
• Watchers: 38
• Forks: 11
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Tailgate

Tailgate is a [nodejs](http://nodejs.org) app to pipe `tail -F` into websockets.  

It's a very simple way to have real-time access to your logs.  It uses [socket.io](http://socket.io) and [coffeescript](http://coffeescript.org), and is great for keeping track of [scribe logs](https://github.com/facebook/scribe).

![Tailgate](http://cl.ly/image/313P243p0L0N/Screen%20Shot%202012-09-10%20at%204.35.08%20PM.png)

## API

Tailgate exposes its feeds as a simple pub/sub api through [socket.io](http://socket.io) connections making it easy to build visualizations or monitoring tools as simple web pages.

## Installation

	

	cd 

	git clone git@github.com:vimeo/tailgate.git

	cd tailgate

	npm install

	cp conf/conf-dist.sh conf/conf.sh

Edit `conf/conf.sh` to have the correct values for your installation.

#### Optional

If you want to use the `init.d.sh` script.

	cp startup/init.d-dist.sh startup/init.d.sh

	sudo ln -s  /etc/init.d/tailgate

Edit the `startup/init.d.sh` script to use the installation directory and tailgate user to run as.  Ensure the tailgate user has write permissions to `startup/` so that it can write the pidfile.

	sudo /etc/init.d/tailgate start

	sudo /etc/init.d/tailgate stop

	sudo /etc/init.d/tailgate restart

## Troubleshooting

	

* Make sure the HTTP port specified in `conf/conf.sh` is not already in use

* Enable logging in `conf.sh` by setting `LOGGING="1"`