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

Примечание

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

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

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

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

Описание

Этот плагин-обработчик Ansible использует cgroups для профилирования активности системы Ansible и отдельных задач и отображает сводку в конце выполнения playbook.

Требования

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

разрешение в конфигурации
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	Интервал опроса ЦП для определения использования ЦП. Более низкое значение может привести к неточным результатам, более высокое значение может быть недостаточно коротким для сбора результатов для коротких задач.
display_recap логическое значение	Варианты: нет да ←	записи ini: [callback_cgroup_perf_recap] display_recap = да переменные среды: CGROUP_DISPLAY_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 = нет переменные среды: CGROUP_FILE_PER_TASK	При установке в `True` вместе с `write_files`, этот обработчик запишет 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 = нет переменные среды: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/posix/cgroup_perf_recap_callback.html