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 роли и соответствующие версии агентов, которые она поддерживает.

• Релизы Ops Agent здесь
• Релизы Logging Agent здесь
• Релизы Monitoring Agent здесь

Сообщение об ошибках и запросы на функциональность

Пожалуйста, напишите в службу поддержки по адресу https://cloud.google.com/support-hub, чтобы получить официальную поддержку.

Лицензия

Copyright 2020 Google Inc. Все права защищены.

Лицензия выдана на условиях Apache License, Version 2.0 (лицензия); вы не можете использовать
этот файл, за исключением случаев его использования в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу

    http://www.apache.org/licenses/LICENSE-2.0

Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, предоставляется на условиях "КАК ЕСТЬ", БЕЗ ГАРАНТИЙ И УСЛОВИЙ ЛЮБОГО РОДА, явно выраженных или подразумеваемых. Смотрите Лицензию для конкретного языка, регулирующего права и ограничения по условиям Лицензии.