Make heroku logs help clearer for --ps and --source

[edmorley]

Currently:

[~/src]$ heroku logs --help
Usage: heroku logs

 display recent log output

 -n, --num NUM        # the number of lines to display
 -p, --ps PS          # only display logs from the given process
 -s, --source SOURCE  # only display logs from the given source
 -t, --tail           # continually stream logs
 --force-colors       # Force use of ANSI color characters (even on non-tty outputs)

Example:

 $ heroku logs
 2012-01-01T12:00:00+00:00 heroku[api]: Config add EXAMPLE by email@example.com
 2012-01-01T12:00:01+00:00 heroku[api]: Release v1 created by email@example.com

I can never remember the difference between ps and source, or what the strings are for heroku vs app vs api etc.

I know this is explained on https://devcenter.heroku.com/articles/logging , but it's a pain to have to open it each time, when the CLI help leaves me none the wiser :-)

[jdx]

@craigkerstiens @friism I've always felt this was confusing as well. Any ideas on how we could improve it?

[craigkerstiens]

Perhaps include an example of each within the help?

[edmorley]

What I also find confusing is that the logs contain things like:
app[web.1]

So in my mind "app" and "web" (or "web.1") must map to one of "source" and "process" respectively.

Except they don't - "app" is "source" but "process" isn't the dyno name - and in fact apart from grepping (which doesn't help when only N lines are returned by default) I can't find a way to filter by dyno type at all.