rax_mon_entity - Создание или удаление сущности Rackspace Cloud Monitoring

Новая версия 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Обзор

Создать или удалить сущность Rackspace Cloud Monitoring, представляющую устройство для мониторинга. Сущности связывают проверки и тревоги с целевой системой и обеспечивают удобное централизованное хранение IP-адресов. Поток модуля мониторинга Rackspace | rax_mon_entity -> rax_mon_check -> rax_mon_notification -> rax_mon_notification_plan -> rax_mon_alarm

Требования

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

python >= 2.6
pyrax

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
agent_id		Агент мониторинга Rackspace на целевом устройстве, к которому привязана эта сущность. Необходимо для сбора `agent.` rax_mon_checks по этой сущности.
api_key		Ключ API Rackspace, переопределяет credentials. Псевдонимы: пароль
auth_endpoint (добавлен в 1.5)	По умолчанию: https://identity.api.rackspacecloud.com/v2.0/	URI службы аутентификации.
credentials	По умолчанию: None	Файл для поиска учетных данных Rackspace. Игнорируется, если заданы api_key и username. Псевдонимы: creds_file
env (добавлен в 1.5)		Окружение, настроенное в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type (добавлен в 1.5)	По умолчанию: rackspace	Механизм аутентификации, такой как rackspace или keystone.
label обязательно		Определяет имя для этой сущности. Должна быть непустой строкой длиной от 1 до 255 символов.
metadata		Хэш произвольных `name`, `value` пар, которые передаются связанным rax_mon_alarms. Имена и значения должны иметь длину от 1 до 255 символов.
named_ip_addresses		Хэш IP-адресов, которые могут быть указаны по имени rax_mon_checks, добавленными к этой сущности. Должен быть словарем, ключи которого являются именами длиной от 1 до 64 символов, а значениями — допустимые IPv4 или IPv6 адреса.
region	По умолчанию: DFW	Регион для создания экземпляра.
state	Варианты: present absent	Обеспечение существования или отсутствия сущности с этим `name`.
tenant_id (добавлен в 1.5)		Идентификатор арендатора, используемый для аутентификации.
tenant_name (добавлен в 1.5)		Имя арендатора, используемое для аутентификации.
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)		Требование валидации SSL для API-точек конечного пункта.

Примечания

Примечание

Можно использовать следующие переменные среды RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл учетных данных, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY исключают использование файла учетных данных
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, ...)

Примеры

- name: Entity example
  gather_facts: False
  hosts: local
  connection: local
  tasks:
  - name: Ensure an entity exists
    rax_mon_entity:
      credentials: ~/.rax_pub
      state: present
      label: my_entity
      named_ip_addresses:
        web_box: 192.0.2.4
        db_box: 192.0.2.5
      meta:
        hurf: durf
    register: the_entity

Статус

Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантирует обратную совместимость.

Автор

Эш Вильсон

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/rax_mon_entity_module.html