Lugg -- Query Rails log files from the command line
A tiny command line utility to search through Rails server log files and display requests that meet certain criteria.
Installation
Lugg is distributed as a Ruby gem, which should be installed on most Macs and Linux systems. Once you have ensured you have a working installation of Ruby and Ruby gems, install the gem as follows from the command line:
$ gem install lugg
You can verify the gem has installed correctly by checking its version number:
$ lugg -v
If this generates an error, something has gone wrong. You should see something
along the lines of lugg 1.0.0
.
Usage
Lugg takes one or more files as arguments or input on STDIN and redirects that content to STDOUT -- but not before applying some filters. Content will be parsed as Rails server log files and only the entire log entries matching your criteria are displayed.
You supply criteria by passing in command line options. You can see a full list
of accepted options by running lugg -h
:
--and Combine previous and next clause with AND instead of OR
--get Limit to GET requests
--post Limit to POST requests
--put Limit to PUT requests
--delete Limit to DELETE requests
--head Limit to HEAD requests
--patch Limit to PATCH requests
-c, --controller CONTROLLER Limit to requests handled by CONTROLLER
-a, --action CONTROLLER_ACTION Limit to requests handled by CONTROLLER_ACTION
--json Limit to json requests
--html Limit to html requests
--xml Limit to xml requests
--csv Limit to csv requests
--pdf Limit to pdf requests
--js Limit to js requests
-f, --format FORMAT Limit to FORMAT requests
-s, --status CODE Limit requests with status code CODE
--since TIME Limit to requests made after TIME
--until TIME Limit to requests made before TIME
-d, --duration N Limit to requests longer than N ms
-u, --uri URI Limit to requests matching URI
-p, --param KEY=VAL Limit to requests with param KEY => VAL
-v, --version Display version number
-h, --help Display this message
Note that all conditions are combined with OR, but you can combine two
conditions with the --and
flag.
Documentation
See the inline API docs for more information.
Contributing
- Fork it ( http://github.com//lugg/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Issues
Please report any issues, defects or suggestions in the Github issue tracker.
What has changed?
See the HISTORY file for a detailed changelog.
Credits
Created by: Arjan van der Gaag
URL: http://arjanvandergaag.nl
Project homepage: http://avdgaag.github.com/lugg
Date: march 2014
License: MIT-license (same as Ruby)