google_cloud_ops_agents
Ansible Роль для Cloud Ops
Эта Ansible роль устанавливает агентов Cloud Ops.
Установка Роли
[Рекомендуется] Для использования Ansible Galaxy для управления зависимостями, используйте следующую команду для установки:
ansible-galaxy install googlecloudplatform.google_cloud_ops_agents
Для использования подсистем GitHub для управления зависимостями, установите эту директорию в вашем каталоге ролей (обычно в каталоге ролей рядом с вашим плейбуком) под именем
googlecloudplatform.google_cloud_ops_agents
:git clone <this-git-repo> roles/googlecloudplatform.google_cloud_ops_agents
Также доступен подробный учебник.
Требования
Необходимы разрешения для Google Cloud API. Если вы используете старый экземпляр Compute Engine или экземпляры Compute Engine, созданные без стандартных учетных данных, вам необходимо выполнить следующие шаги: https://cloud.google.com/monitoring/agent/authorization#before_you_begin.
Переменные Роли
Переменная agent_type
является обязательной и используется для указания, какой агент настраивается. Доступные варианты: monitoring
, logging
и ops-agent
.
Переменная package_state
может использоваться для указания желаемого состояния агента. Допустимые значения: present
(по умолчанию) и absent
.
Переменная version
может использоваться для указания, какую версию агента устанавливать. Допустимые значения: latest
(по умолчанию), MAJOR_VERSION.*.*
и MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
, которые подробно описаны ниже.
version=latest
Эта настройка облегчает поддержку актуальности версии агента, однако она может быть рискованной. Когда выпускается новая основная версия, политика может установить последнюю версию агента из нового основного релиза, что может привести к поломкам. Для производственных сред рассмотрите возможность использования настройки version=MAJOR_VERSION.*.*
ниже для более безопасного развертывания агента.
version=MAJOR_VERSION.*.*
Когда выходит новая основная версия, эта настройка гарантирует, что устанавливается только последняя версия из указанной основной версии, что позволяет избежать случайного внедрения поломок. Это рекомендуется для производственных сред для обеспечения более безопасного развертывания агента.
version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
Эта настройка не рекомендуется, так как она предотвращает обновления до новых версий агента, которые содержат исправления ошибок и другие улучшения.
Переменная main_config_file
может использоваться для указания абсолютного или относительного пути к пользовательскому конфигурационному файлу. Этот файл перезапишет конфигурационный файл на целевой виртуальной машине.
Для получения дополнительной информации смотрите Настройка агента мониторинга, Настройка агента логирования или Настройка Ops агента.
По умолчанию агент только мониторит и регистрирует системные ресурсы, такие как процессор, память, диск и т.д. Мониторинг и логирование сторонних приложений можно настроить, указав путь к директории, содержащей файлы конфигурации плагинов, используя переменную additional_config_dir
. Все файлы .conf
в этой директории будут развернуты в директорию плагинов агента на целевой виртуальной машине. Основной конфигурационный файл должен содержать строку, включающую эту директорию. Обратите внимание, что эту переменную можно указывать только при настройке агентов мониторинга или логирования.
Для получения дополнительной информации смотрите Мониторинг сторонних приложений.
Примеры Плейбуков
# Установка агентов мониторинга и логирования
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: monitoring
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: logging
# Установка агентов мониторинга и логирования с пользовательскими конфигурациями
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: monitoring
version: latest
main_config_file: monitoring_agent.conf
additional_config_dir: monitoring_agent_dir/
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: logging
version: 1.*.*
main_config_file: logging_agent.conf
additional_config_dir: logging_agent_dir/
# Установка Ops-Agent
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: ops-agent
# Установка Ops-Agent с пользовательской конфигурацией
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: ops-agent
version: 1.0.1
main_config_file: ops_agent.yaml
Совместимость
Ниже представлена матрица, в которой указаны версии этой Ansible роли и соответствующие версии агентов, которые она поддерживает.
Версия Ansible Роли | Совместимые версии Ops Agent | Совместимые версии Logging Agent | Совместимые версии Monitoring Agent |
---|---|---|---|
1.x.x | 2.x.x | 1.x.x | 6.x.x |
Сообщение об ошибках и запросы на функциональность
Пожалуйста, напишите в службу поддержки по адресу https://cloud.google.com/support-hub, чтобы получить официальную поддержку.
Лицензия
Copyright 2020 Google Inc. Все права защищены.
Лицензия выдана на условиях Apache License, Version 2.0 (лицензия); вы не можете использовать
этот файл, за исключением случаев его использования в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу
http://www.apache.org/licenses/LICENSE-2.0
Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, предоставляется на условиях "КАК ЕСТЬ", БЕЗ ГАРАНТИЙ И УСЛОВИЙ ЛЮБОГО РОДА, явно выраженных или подразумеваемых. Смотрите Лицензию для конкретного языка, регулирующего права и ограничения по условиям Лицензии.
ansible-galaxy install GoogleCloudPlatform/stackdriver-ansible-role