ansible.builtin.tree – Save host events to files


This module is part of ansible-base and included in all Ansible installations. In most cases, you can use the short module name tree even without specifying the collections: keyword. Despite that, we recommend you use the FQCN for easy linking to the module documentation and to avoid conflicting with other collections that may have the same module name.

New in version 2.0: of ansible.builtin


  • This callback is used by the Ansible (adhoc) command line option -t|–tree

  • This produces a JSON dump of events in a directory, a file for each host, the directory used MUST be passed as a command line option.


The below requirements are needed on the local controller node that executes this callback.

  • invoked in the command line


Parameter Choices/Defaults Configuration Comments
added in 2.11 of ansible.builtin
ini entries:

directory = ~/.ansible/tree

directory that will contain the per host JSON files. Also set by the ``--tree`` option when using adhoc.