Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Real-time grep for your logs right in your favorite modern browser made with Twitter Bootstrap.
JavaScript
Tree: c759a9a1de

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
node_modules
public
.gitignore
README.md
index.js
package.json

README.md

Pupergrep - have fun with log files, you nerds!

Screenshots & Features

Everybody loves screenshots!

screenshot

  • Grep only lines you like (skip non-fatal errors, stack traces, INFO lines).
  • Highlight only lines you dislike (FATAL errors, long responses).
  • Group highlight and grep conditions with AND/OR;
  • Limit output buffer to keep the whole log area on the screen or make it large to see everthing.
  • Pause log to take a look for fun facts in your error log.
  • Fast switching between many logs with handsome list with search box.
  • Font-size switching for eagles.
  • Send your colleagues links to your favorite logs with your settings and bookmark them.
  • Link activation in logs - just click on it to open.
  • Open-source. Can you imagine that?

Demo

Yes, we have it, right here: http://home.bobrik.name/. Feel free to touch it before using!

Select log you like and try to push some buttons.

Installation

This is pretty simple, believe me!

mkdir ~/mypupergrep
cd ~/mypupergrep
mkdir node_modules
npm install pupergrep

Now you have pupergrep module installed.

PuperGrep needs to know what to monitor. Simple server to make you understand what I mean:

(function() {
    var PuperGrep = require("pupergrep"),
        puper     = new PuperGrep(),
        manager   = puper.getLogReaderManager();

    manager.addLog("my_cool_log", "/var/log/my_cool_log", function(error) {
        if (error) {
            console.log("Error adding test log", error);
            return;
        }

        puper.listen(8080, "127.0.0.1");
    });
})();

Save it to ~/mypupergrep/server.js. Run it right after that:

node server.js

Let's configure nginx (I don't want to make node.js serve static files). Example configuration:

server {
    listen 80;
    server_name localhost;

    location / {
        index index.html;
        root /home/user/mypupergrep/node_modules/pupergrep/public;
    }

    location /socket.io/ {
        proxy_http_version 1.1;
        proxy_pass http://127.0.0.1:8080/socket.io/;
    }
}

Now cross your fingers and open http://127.0.0.1/ in your favorite browser. This is it!

Troubles

Let me guess, you tried to monitor access log of nginx server that proxy your PuperGrep? You bastard! Stop it right now!

Another trouble? Hm. Post an issue!

Want to contribute?

You're welcome! Make a pull request and we'll see.

Authors

Contributors

Inspired by supergrep from Etsy.

Something went wrong with that request. Please try again.