Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Heroku command-line plugin to tail and search logs
JavaScript
Branch: master
Failed to load latest commit information.
commands Rename topic pt -> papertrail
README.md Remove deprecation warning
index.js Rename topic pt -> papertrail
package.json Bump version to 1.0.2

README.md

Papertrail Heroku plugin

Extends heroku command-line app to display, tail, and search Heroku app and platform logs on Papertrail.

Installation

$ heroku plugins:install heroku-papertrail

The plugin includes all required dependencies.

Usage

$ heroku pt [-t] [query]

  -t      # continually stream logs (tail)
  query   # Boolean search filter

$ heroku addons:open papertrail

Examples

Add Papertrail's Heroku log management add-on to your app(s), then run heroku pt. Examples:

$ heroku pt

Tail:

$ heroku pt -t

Specify a Heroku app name, tail, and show only logs containing router:

$ heroku pt --app wopr -t router

Create shortcuts to invoke CLI or open Web interface:

$ alias logs="heroku pt --app wopr -t"
$ logs JoshuaController

$ alias pt="heroku addons:open --app wopr papertrail"
$ pt

Advanced Examples

To search for quoted phrases, enclose entire query in double quotes (consistent with other shell tools):

$ heroku pt "'Sent mail to' cron"
$ heroku pt -t "'status=50' OR 'Completed in'"

Use parenthesis and exclusion (-):

$ heroku pt --app wopr -t "'State changed' OR (router ('status=50' OR 'Error H'))"
$ heroku pt "router -'queue=0'"

More: Search syntax

Something went wrong with that request. Please try again.