Skip to content

Instantly share code, notes, and snippets.

Forked from cliffano/
Last active December 8, 2021 13:51
Show Gist options
  • Save dmsimard/cd706de198c85a8255f6 to your computer and use it in GitHub Desktop.
Save dmsimard/cd706de198c85a8255f6 to your computer and use it in GitHub Desktop.
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <>.
# Inspired from:
# Improved and made compatible with Ansible v2
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
from ansible.plugins.callback import CallbackBase
import simplejson as json
except ImportError:
import json
# Fields to reformat output for
FIELDS = ['cmd', 'command', 'start', 'end', 'delta', 'msg', 'stdout',
'stderr', 'results']
class CallbackModule(CallbackBase):
def human_log(self, data):
if type(data) == dict:
for field in FIELDS:
if field in data.keys() and data[field]:
output = self._format_output(data[field])
print("\n{0}: {1}".format(field, output.replace("\\n","\n")))
def _format_output(self, output):
# Strip unicode
if type(output) == unicode:
output = output.encode('ascii', 'replace')
# If output is a dict
if type(output) == dict:
return json.dumps(output, indent=2)
# If output is a list of dicts
if type(output) == list and type(output[0]) == dict:
# This gets a little complicated because it potentially means
# nested results, usually because of with_items.
real_output = list()
for index, item in enumerate(output):
copy = item
if type(item) == dict:
for field in FIELDS:
if field in item.keys():
copy[field] = self._format_output(item[field])
return json.dumps(output, indent=2)
# If output is a list of strings
if type(output) == list and type(output[0]) != dict:
# Strip newline characters
real_output = list()
for item in output:
if "\n" in item:
for string in item.split("\n"):
# Reformat lists with line breaks only if the total length is
# >75 chars
if len("".join(real_output)) > 75:
return "\n" + "\n".join(real_output)
return " ".join(real_output)
# Otherwise it's a string, just return it
return output
def on_any(self, *args, **kwargs):
def runner_on_failed(self, host, res, ignore_errors=False):
def runner_on_ok(self, host, res):
def runner_on_error(self, host, msg):
def runner_on_skipped(self, host, item=None):
def runner_on_unreachable(self, host, res):
def runner_on_no_hosts(self):
def runner_on_async_poll(self, host, res, jid, clock):
def runner_on_async_ok(self, host, res, jid):
def runner_on_async_failed(self, host, res, jid):
def playbook_on_start(self):
def playbook_on_notify(self, host, handler):
def playbook_on_no_hosts_matched(self):
def playbook_on_no_hosts_remaining(self):
def playbook_on_task_start(self, name, is_conditional):
def playbook_on_vars_prompt(self, varname, private=True, prompt=None,
encrypt=None, confirm=False, salt_size=None,
salt=None, default=None):
def playbook_on_setup(self):
def playbook_on_import_for_host(self, host, imported_file):
def playbook_on_not_import_for_host(self, host, missing_file):
def playbook_on_play_start(self, pattern):
def playbook_on_stats(self, stats):
Copy link

Hi I am new to Ansible.
I am also tired with row format of debug log. This plugin will be very useful.
can you please let me know how to configure it ? Where to put this py file and how to use in ansible playbook.

My aim is to log output of task into one file. located on controlled machine.

Thanks in advance.

Copy link

Harosgr commented Mar 11, 2016

Thanks for the plugin. There are two problems though...

  • The human readable output doesn't apply to the text written in the ansible logfile (if enabled).
  • If you run a command in ansible with "ignore_errors: yes", in case of error the non-formated ouput is printed, and then the formated ouput follows...

I am copy pasting part of my output in order for you to better understand the second problem.

/tdpvmware/fcm/fmcima -l /home/tdpvmware/tdpvmware/config -N DEVICE_CLASS:FCBACKUP_SLM.0 -f backup' returned with code 0.", "#CHILD lunid:6005076801828070F800000000000211", "#PARENT lunname:V-slmesx01_lun0002", "#WARNING FMM1554W The agent 'acsgen V.' terminated with exit code 1.", "#INFO FMM0020I End of program at: Fri Mar 11 16:23:03 2016.", "#INFO FMM0021I Elapsed time: 01 min 38 sec.", "#INFO FMM0024I Return code is: 1.", "#PARAM STATUS=warning", "#END RUN 636 20160311162303884", "#END TASK 114", "#INFO FMM16014I The return code is 1.", "#END"], "warnings": []}
[after that part the ouput is displayed again but now formated as it should]
cmd: /opt/tivoli/tsm/tdpvmware/common/scripts/vmcli -f backup -T 114 --runnow

start: 2016-03-11 16:21:24.221963

end: 2016-03-11 16:23:05.543694

delta: 0:01:41.321731

stdout: #TASK 114 backup 20131008162736229

Copy link

snevs commented Oct 4, 2016

I'm seeing double output. Formatted and unformatted.

Copy link

welchwilmerck commented Oct 28, 2016

Re: double output. Plugins can only get in line to get their shot at processing whatever object is being passed around, not override other plugins. The vendor provided plugins/callback/ always runs, then this plugin gets its time with 'result', so you get what both produce.

The real fix is actually already sitting in vendor's plugins/callback/, def _dump_results. Set indent to 4 instead of None or figure out how to set verbose_always. N. B. I'm looking at v2.1.2.0 while there seems to be work in this area on the devel branch. Maybe a way to activate indent=4 is already implemented.

Copy link

@kamalgarg, from Configuring Callback Plugins in Ansible documentation:

You can activate a custom callback by either dropping it into a callback_plugins directory adjacent to your play or inside a role or by putting it in one of the callback directory sources configured in ansible.cfg.

Plugins are loaded in alphanumeric order; for example, a plugin implemented in a file named would run before a plugin file named

Most callbacks shipped with Ansible are disabled by default and need to be whitelisted in your ansible.cfg file in order to function. For example:

#callback_whitelist = timer, mail, mycallbackplugin

So create a callback_plugins/ directory next to your playbooks, copy there, and add this to your ansible.cfg:

callback_whitelist = human_log

Copy link

FYI I added support for hiding output on tasks that have no_log: True in this fork.

Copy link

Krishna1408 commented Jul 24, 2017


Thanks a lot for youre efforts. I am getting below warning and logs are not being shown in human readable format:

[WARNING]: Failure using method (v2_runner_on_ok) in callback plugin (</home/i050396/new_upgrade/multidc/callback/human_log.CallbackModule object at 0x7fdb7280c828>): name 'unicode' is not


Can you please help with it ?

Copy link

MaesterZ commented Oct 6, 2017

Works fine for me with ansible 2.3.2, thanks for this.

Copy link

Have always output in double ... :-(
ansible v2.3.1
Python v2.7.5 on Red Hat v7.1

Copy link

This works great, but does anyone know how to get this output to log to the file specified by log_path in ansible.cfg?

Copy link

spielhoelle commented Dec 26, 2017

Nice works 4 me, but my install pm2-syslog task returns something quite ugly

? App name ? id ? mode ? pid ? status ? restart ? uptime ? cpu ? mem ? user ? watching ?
 Module activated
? Module     ? version ? target PID ? status ? restart ? cpu ? memory      ? user ?
? pm2-syslog ? N/A     ? N/A        ? online ? 0       ? 0%  ? 11.625 MB   ? node ?
 Use `pm2 show <id|name>` to get more details about an app

Anybody some ideas to fix those ascii characters?


That solution works. Human readable and with UTF8 special ascii characters.

Copy link

g-lux commented Jan 18, 2018

stdout gets properly formatted but (yum) results does not. Any ideas?

Copy link

worth noting that this callback plugin may no longer be needed as the debug plugin can be used by default now, I have just switched to using that instead:

ansible/ansible#27078 (comment)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment