cgroup_perf_recap – Профилирование системной активности задач и полного выполнения с использованием cgroups
Новое в версии 2.8.
Обзор
- Этот плагин Ansible callback использует cgroups для профилирования системной активности Ansible и отдельных задач, а также отображает сводку в конце выполнения playbook.
Требования
Ниже приведены требования, необходимые на локальном узле-мастере, на котором выполняется этот callback.
- безопасный список в конфигурации
- cgroups
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| control_group - / обязательно | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_CONTROL_GROUP | Имя группы управления cgroups | |
| cpu_poll_interval float | По умолчанию: 0.25 | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_CPU_POLL_INTERVAL | Интервал опроса процессора для определения использования процессора. Более низкое значение может привести к неточным результатам, более высокое значение может оказаться недостаточно коротким для сбора результатов для коротких задач. |
| display_recap boolean |
| Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_DISPLAY_RECAP | Управляет тем, будет ли выводиться сводка в конце, что полезно, если вы будете автоматически обрабатывать выходные файлы. |
| file_name_format строка | По умолчанию: "%(feature)s.%(ext)s" | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_FILE_NAME_FORMAT | Формат имени файла. Поддерживает %(feature)s, %(ext)s, %(task_uuid)s. По умолчанию %(feature)s.%(ext)s, если %(task_uuid)s отсутствует. |
| file_per_task boolean |
| Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_FILE_PER_TASK | Если установлено в значение «да», а также при write_files, этот callback запишет по 1 файлу на задачу вместо 1 файла на весь запуск playbook. |
| memory_poll_interval float | По умолчанию: 0.25 | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_MEMORY_POLL_INTERVAL | Интервал опроса памяти для определения использования памяти. Более низкое значение может привести к неточным результатам, более высокое значение может оказаться недостаточно коротким для сбора результатов для коротких задач. |
| output_dir путь | По умолчанию: "/tmp/ansible-perf-%s" | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_OUTPUT_DIR | Директория вывода файлов, содержащих записанные данные производительности. Если значение содержит один %s, в это место будет вставлено время начала выполнения playbook. Будет создана только директория самого глубокого уровня, если она не существует, родительские директории не будут созданы. |
| output_format строка |
| Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_OUTPUT_FORMAT | Формат вывода, либо CSV, либо JSON-seq |
| pid_poll_interval float | По умолчанию: 0.25 | Элементы ini: [callback_cgroup_perf_recap] переменная среды:CGROUP_PID_POLL_INTERVAL | Интервал опроса PID для определения количества PID. Более низкое значение может привести к неточным результатам, более высокое значение может оказаться недостаточно коротким для сбора результатов для коротких задач. |
| write_files boolean |
| Элементы ini: [callback_cgroup_perf_recap] переменная среды: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
Статус
- Интерфейс этого callback не гарантирует обратную совместимость. [превью]
- Этот callback поддерживается сообществом Ansible. [сообщество]
Авторы
- НЕИЗВЕСТНО
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
Подсказка
Записи конфигурации для каждого типа записи имеют порядок приоритета от низкого к высокому. Например, переменная, которая находится ниже в списке, переопределит переменную, которая находится выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/plugins/callback/cgroup_perf_recap.html
