ansible.posix.cgroup_perf_recap – Профилирует системную активность задач и полное выполнение с использованием cgroups

Примечание

Этот плагин входит в коллекцию ansible.posix (версия 1.1.1).

Для его установки используйте: ansible-galaxy collection install ansible.posix.

Для использования в плейбуке укажите: ansible.posix.cgroup_perf_recap.

Обзор
Требования
Параметры
Примечания

Обзор

Это плагин-обработчик ansible, использующий cgroups для профилирования системной активности ansible и отдельных задач, и отображающий сводку в конце выполнения плейбука

Требования

Ниже перечислены требования к локальному контроллеру, на котором выполняется этот обратный вызов.

Разрешение в конфигурации
cgroups

Параметры

Параметр	Варианты/Значения по умолчанию	Настройка	Комментарии
control_group строка / обязательно		Записи ini: [callback_cgroup_perf_recap] control_group = None Переменная окружения:CGROUP_CONTROL_GROUP	Имя группы cgroups управления
cpu_poll_interval вещественное число	По умолчанию: 0.25	Записи ini: [callback_cgroup_perf_recap] cpu_poll_interval = 0.25 Переменная окружения:CGROUP_CPU_POLL_INTERVAL	Интервал между опросами CPU для определения использования CPU. Более низкое значение может привести к неточным результатам, а более высокое значение может оказаться недостаточно коротким для сбора результатов коротких задач.
display_recap булево	Варианты: no да ←	Записи ini: [callback_cgroup_perf_recap] display_recap = yes Переменная окружения:CGROUP_DISPLAY_RECAP	Управляет тем, будет ли вывод recap напечатан в конце, полезно, если вы будете автоматически обрабатывать выходные файлы
file_name_format строка	По умолчанию: "%(feature)s.%(ext)s"	Записи ini: [callback_cgroup_perf_recap] file_name_format = %(feature)s.%(ext)s Переменная окружения:CGROUP_FILE_NAME_FORMAT	Формат имени файла. Поддерживает `%(counter`s), `%(task_uuid`s), `%(feature`s), `%(ext`s). По умолчанию `%(feature`s.%(ext)s), если `file_per_task` является `False`, и `%(counter`s-%(task_uuid)s-%(feature)s.%(ext)s), если `True`
file_per_task булево	Варианты: нет ← да	Записи ini: [callback_cgroup_perf_recap] file_per_task = no Переменная окружения:CGROUP_FILE_PER_TASK	При установке в `True` вместе с `write_files`, этот callback будет записывать по 1 файлу на задачу вместо 1 файла на весь запуск playbook.
memory_poll_interval вещественное число	По умолчанию: 0.25	Записи ini: [callback_cgroup_perf_recap] memory_poll_interval = 0.25 Переменная окружения:CGROUP_MEMORY_POLL_INTERVAL	Интервал между опросами памяти для определения использования памяти. Более низкое значение может привести к неточным результатам, а более высокое значение может оказаться недостаточно коротким для сбора результатов коротких задач.
output_dir путь	По умолчанию: "/tmp/ansible-perf-%s"	Записи ini: [callback_cgroup_perf_recap] output_dir = /tmp/ansible-perf-%s Переменная окружения:CGROUP_OUTPUT_DIR	Директория вывода для файлов, содержащих записанные показатели производительности. Если значение содержит один %s, в этом месте будет вставлено время начала выполнения playbook. Будет создана только директория самого глубокого уровня, если она не существует; родительские директории не будут созданы.
output_format строка	Варианты: csv ← json	Записи ini: [callback_cgroup_perf_recap] output_format = csv Переменная окружения:CGROUP_OUTPUT_FORMAT	Формат вывода, либо CSV, либо JSON-seq
pid_poll_interval вещественное число	По умолчанию: 0.25	Записи ini: [callback_cgroup_perf_recap] pid_poll_interval = 0.25 Переменная окружения:CGROUP_PID_POLL_INTERVAL	Интервал между опросами PID для определения количества PID. Более низкое значение может привести к неточным результатам, а более высокое значение может оказаться недостаточно коротким для сбора результатов коротких задач.
write_files булево	Варианты: нет ← да	Записи ini: [callback_cgroup_perf_recap] write_files = no Переменная окружения:CGROUP_WRITE_FILES	Указывает, будут ли созданы файлы, содержащие данные о производительности

Примечания

Примечание

Требуется, чтобы ansible выполнялся внутри cgroup, например, с помощью cgexec -g cpuacct,memory,pids:ansible_profile ansible-playbook ...
Эта группа cgroup должна использоваться только ansible для получения точных результатов
Для создания cgroup сначала используйте команду, такую как sudo cgcreate -a ec2-user:ec2-user -t ec2-user:ec2-user -g cpuacct,memory,pids:ansible_profile

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/posix/cgroup_perf_recap_callback.html