community.general.counter_enabled callback – adds counters to the output items (tasks and hosts/task)

Note

This callback plugin is part of the community.general collection (version 5.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general. You need further requirements to be able to use this callback plugin, see Requirements for details.

To use it in a playbook, specify: community.general.counter_enabled.

Callback plugin

This plugin is a stdout callback. You can use only use one stdout callback at a time. Additional aggregate or notification callbacks can be enabled though. See Callback plugins for more information on callback plugins.

Synopsis

  • Use this callback when you need a kind of progress bar on a large environments.

  • You will know how many tasks has the playbook to run, and which one is actually running.

  • You will know how many hosts may run a task, and which of them is actually running.

Requirements

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

  • set as stdout callback in ansible.cfg (stdout_callback = counter_enabled)

Parameters

Parameter

Comments

check_mode_markers

boolean

added in Ansible 2.9

Toggle to control displaying markers when running in check mode.

The markers are DRY RUN at the beginning and ending of playbook execution (when calling ansible-playbook --check) and CHECK MODE as a suffix at every play and task that is run in check mode.

Choices:

  • false ← (default)

  • true

Configuration:

display_failed_stderr

boolean

added in Ansible 2.7

Toggle to control whether failed and unreachable tasks are displayed to STDERR (vs. STDOUT)

Choices:

  • false ← (default)

  • true

Configuration:

display_ok_hosts

boolean

added in Ansible 2.7

Toggle to control displaying ‘ok’ task/host results in a task

Choices:

  • false

  • true ← (default)

Configuration:

display_skipped_hosts

boolean

Toggle to control displaying skipped task/host results in a task

Choices:

  • false

  • true ← (default)

Configuration:

  • INI entry:

    [defaults]
display_skipped_hosts = true

  • Environment variable: DISPLAY_SKIPPED_HOSTS

    Removed in: version 2.12 of ansible.builtin

    Why: environment variables without ANSIBLE_ prefix are deprecated

    Alternative: the ANSIBLE_DISPLAY_SKIPPED_HOSTS environment variable

  • Environment variable: ANSIBLE_DISPLAY_SKIPPED_HOSTS

show_custom_stats

boolean

This adds the custom stats set via the set_stats plugin to the play recap

Choices:

  • false ← (default)

  • true

Configuration:

show_per_host_start

boolean

added in Ansible 2.9

This adds output that shows when a task is started to execute for each host

Choices:

  • false ← (default)

  • true

Configuration:

show_task_path_on_failure

boolean

added in ansible-core 2.11

When a task fails, display the path to the file containing the failed task and the line number. This information is displayed automatically for every task when running with -vv or greater verbosity.

Choices:

  • false ← (default)

  • true

Configuration:

Authors

  • Unknown

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.