Improve run_remote_puppet logging output

For one, replace puppet agent --test with a slightly less verbose
version that does not return strange error codes. Then update the
script to log things a little more readably.

Change-Id: Ib95edc59020d443ee83a04bdf19430f5c56196ec
Merge "Improve run_remote_puppet logging output"