Роль Ansible для агента инфраструктуры New Relic

Эта роль устанавливает и настраивает агент инфраструктуры New Relic.

Обратите внимание, что это простая роль, предназначенная для использования в качестве отправной точки для вашего собственно настроенного рабочего процесса.

Установка и использование роли Ansible

Что делает newrelic-infra

• Добавляет источник пакетов New Relic.
• Устанавливает и настраивает агент инфраструктуры New Relic.

Начало работы с ролью

Начните с того, что добавьте роль в ваш плейбук и настройте необходимые переменные.

Все типичные взаимодействия с newrelic-infra выполняются через конфигурацию роли.

Установка агента инфраструктуры с помощью роли

Используйте следующий фрагмент для установки агента.

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: ВАШ_КЛЮЧ_ЛИЦЕНЗИИ
          log_file: /var/log/nr-infra.log
          log_to_stdout: false

Справка

Конфигурация роли

Переменные

nrinfragent_config (Обязательная)

Используется для заполнения конфигурации агента. По крайней мере, вы должны предоставить license_key. Для текущих параметров конфигурации смотрите документацию New Relic.

nrinfragent_state (Необязательная)

Определяет, что вы хотите сделать с агентом:

• 'latest' - [по умолчанию] установить последнюю версию агента. Также present.
• 'absent' - Удалить агента.

nrinfragent_os_name (Необязательная)

Указывает целевую ОС, на которой будет установлен агент инфраструктуры. По умолчанию используется ansible_os_family. Для получения списка поддерживаемых операционных систем смотрите файл meta/main.yml.

nrinfragent_os_version (Необязательная)

Указывает версию ОС для установочного пакета, необходимую для этой машины. По умолчанию используется ansible_lsb.major_release. В основном используется для ОС семейства RedHat. Для получения списка поддерживаемых операционных систем смотрите файл meta/main.yml.

nrinfragent_os_codename (Необязательная)

Указывает кодовое имя ОС для установочного пакета, необходимое для этой машины. По умолчанию используется ansible_lsb.codename. В основном используется для ОС семейства Debian. Для получения списка поддерживаемых операционных систем смотрите файл meta/main.yml.

nrinfragent_choco_version (Необязательная)

Указывает версию пакета Chocolatey для установки newrelic-infra на Windows. Может использоваться для закрепления версии или обновления агента.

nrinfragent_service_state (Необязательная)

Указывает состояние службы newrelic-infra после установки. По умолчанию установлено значение started, что обеспечивает запуск службы. Вы можете изменить на stopped, чтобы просто установить ее, без немедленного запуска.

nrinfragent_service_enabled (Необязательная)

Указывает, будет ли служба запускаться при загрузке. По умолчанию yes; измените на no, чтобы предотвратить автоматический запуск службы при загрузке.

nrinfragent_integrations (Необязательная)

Указывает интеграции инфраструктуры, которые должны быть установлены. Список доступных интеграций можно найти здесь.

Каждый пакет должен предоставлять свое name и state. Имя пакета интеграции находится в разделе Установить и активировать документации отдельных интеграций. Как правило, их имя — это имя службы с префиксом nri- (nri-apache, nri-redis и т.д.).

По умолчанию состояние установлено на absent, что не устанавливает пакет; вы можете изменить его на latest или present. Например:

nrinfragent_integrations:
  - { name: nri-nginx, state: "latest" }
  - { name: nri-mysql, state: "absent" }

Исходный код для каждой интеграции доступен в GitHub организации newrelic.

Удаление пакета newrelic-infra-integrations и его встроенных интеграций

Это применимо только в том случае, если у вас установлен пакет newrelic-infra-integrations

Если вы хотите удалить пакет newrelic-infra-integrations или любую из встроенных интеграций (nri-redis, nri-cassandra, nri-apache, nri-nginx, nri-mysql), добавьте newrelic-infra-integrations в качестве первого элемента nrinfragent_integrations со значением состояния absent.

nrinfragent_integrations:
  - { name: newrelic-infra-integrations, state: "absent" }

Устарело

Вы можете указать ключ лицензии для обратной совместимости. Рекомендуем использовать license_key в nrinfragent_config вместо этого. Если указаны оба, приоритет будет отдан параметру nrinfragent_config.

Совместимость

Платформы

• RHEL/CentOS
  • RHEL/CentOS 8
  • RHEL/CentOS 7
  • RHEL/CentOS 6
  • RHEL/CentOS 5
• Ubuntu
  • 18 Bionic
  • 16 Xenial
  • 14 Trusty
  • 12 Precise
• Debian
  • 10 Buster
  • 9 Stretch
  • 8 Jessie
  • 7 Wheezy
• SUSE Linux Enterprise
  • 12
• Windows
  • Все
  • Отказ от ответственности: Поддержка Windows зависит от стороннего пакета newrelic-infra Chocolatey, который поддерживается @ripclawffb и @xandrellas. Он распространяется без каких-либо гарантий или поддержки со стороны New Relic.

Выпуск в Ansible Galaxy

Чтобы выпустить новую версию в Ansible Galaxy, выполните следующие шаги:

• Обновите CHANGELOG.md
• Создайте новый релиз на GitHub.
• Убедитесь, что версия импортирована в Ansible Galaxy; если есть проблемы, обратитесь к одному из владельцев проекта.

Поддержка

Если вам нужна помощь с продуктами New Relic, вы находитесь в надежных руках с несколькими инструментами для диагностики и каналами поддержки.

Если проблема была подтверждена как ошибка или это запрос на функцию, создайте проблему на GitHub.

Каналы поддержки

• Документация New Relic: Полное руководство по использованию нашей платформы
• Сообщество New Relic: Лучшее место для обсуждения вопросов по устранению неисправностей
• Разработчик New Relic: Ресурсы для создания пользовательских приложений для наблюдения
• Университет New Relic: Разнообразие онлайн-обучения для пользователей New Relic любого уровня
• Техническая поддержка New Relic поддержка по запросам 24/7/365. Узнайте больше о наших предложениях технической поддержки.

Конфиденциальность

В New Relic мы серьезно относимся к вашей конфиденциальности и безопасности вашей информации и стремимся защитить ваши данные. Мы подчеркиваем важность непрерывной работы с личными данными в общественных форумах и просим всех пользователей удалять чувствительную информацию из журналов и диагностической информации.

Мы определяем «Личные данные» как любую информацию, относящуюся к идентифицированному или идентифицируемому лицу, включая, например, ваше имя, номер телефона, почтовый индекс, ИД устройства, IP-адрес и адрес электронной почты.

Для получения дополнительной информации ознакомьтесь с Общими сведениями о конфиденциальности данных New Relic.

Вклад

Мы поощряем ваши вклад, чтобы улучшить этот проект! Имейте в виду, что при подаче вашего запроса на изменение вам нужно будет подписать CLA через подтверждение с помощью CLA-Assistant. Вам нужно подписать CLA только один раз для каждого проекта.

Если у вас есть какие-либо вопросы или для выполнения нашего корпоративного CLA (который требуется, если ваш вклад представляет компанию), отправьте нам электронное письмо по адресу opensource@newrelic.com.

Примечание о уязвимостях

Как отмечено в нашей политике безопасности, New Relic привержена защите конфиденциальности и безопасности наших клиентов и их данных. Мы считаем, что предоставление координированного раскрытия информации по поводу уязвимостей исследователями безопасности и взаимодействие с сообществом безопасности являются важными средствами для достижения наших целей в области безопасности.

Если вы считаете, что нашли уязвимость безопасности в этом проекте или в любом из продуктов или веб-сайтов New Relic, мы приветствуем и очень благодарны вам за сообщение об этом в New Relic через HackerOne.

Если вы хотите внести вклад в этот проект, ознакомьтесь с этими рекомендациями.

Спасибо всем участникам! Без вашего вклада этот проект не был бы тем, чем он является сегодня.

Лицензия

infrastructure-agent-ansible лицензируется по лицензии Apache 2.0.