community.general.rax_mon_check – Создание или удаление проверки Rackspace Cloud Monitoring для существующего объекта.

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в плейбуке укажите: community.general.rax_mon_check.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

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

Требования

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

python >= 2.6
pyrax

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Rackspace, переопределяет credentials. алиасы: пароль
auth_endpoint строка		URI службы аутентификации. Если не указано, будет установлено значение https://identity.api.rackspacecloud.com/v2.0/
check_type строка / обязательно		Тип создаваемой проверки. `remote.` проверки могут быть созданы на любом rax_mon_entity. `agent.` проверки могут быть созданы только на rax_mon_entities, у которых не пустое значение `agent_id`. Варианты для этого параметра: - `remote.dns` - `remote.ftp-banner` - `remote.http` - `remote.imap-banner` - `remote.mssql-banner` - `remote.mysql-banner` - `remote.ping` - `remote.pop3-banner` - `remote.postgresql-banner` - `remote.smtp-banner` - `remote.smtp` - `remote.ssh` - `remote.tcp` - `remote.telnet-banner` - `agent.filesystem` - `agent.memory` - `agent.load_average` - `agent.cpu` - `agent.disk` - `agent.network` - `agent.plugin`
credentials путь		Файл с учетными данными Rackspace. Игнорируется, если заданы api_key и username. алиасы: creds_file
details словарь		Дополнительные сведения, специфичные для типа проверки. Должен быть словарем строк длиной от 1 до 255 символов, или массивом или объектом, содержащим от 0 до 256 элементов.
disabled логическое значение	Варианты: нет ← да	Если "да", проверка создается, но фактически не используется.
entity_id строка / обязательно		ID объекта rax_mon_entity, к которому должна быть применена эта проверка.
env строка		Среда, как настроена в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type строка	По умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
label строка / обязательно		Определяет метку для этой проверки, длиной от 1 до 64 символов.
metadata словарь		Словарь произвольных пар ключ-значение для сопровождения этой проверки, если она срабатывает. Ключи и значения должны быть строками длиной от 1 до 255 символов.
monitoring_zones_poll строка		Список зон мониторинга через запятую, из которых должна выполняться проверка. Доступные зоны мониторинга включают mzdfw, mzhkg, mziad, mzlon, mzord и mzsyd. Требуется для проверок remote.; запрещено для проверок agent..
period целое число		Количество секунд между каждым выполнением проверки. Должно быть больше минимального периода, установленного в вашей учетной записи.
region строка		Регион для создания экземпляра.
state строка	Варианты: present ← absent	Обеспечение того, что проверка с этим `label` существует или не существует.
target_alias строка		Один из `target_alias` и `target_hostname` требуется для проверок remote., но запрещен для проверок agent.. Используйте соответствующий ключ в хеше `ip_addresses` объекта для разрешения IP-адреса для проверки.
target_hostname строка		Один из `target_hostname` и `target_alias` требуется для проверок remote., но запрещен для проверок agent.. Хост, на который должна быть нацелена эта проверка. Должен быть допустимым IPv4, IPv6 или FQDN.
tenant_id строка		Идентификатор арендатора, используемый для аутентификации.
tenant_name строка		Имя арендатора, используемое для аутентификации.
timeout целое число		Количество секунд, которое эта проверка будет ожидать при попытке сбора результатов. Должно быть меньше, чем период.
username строка		Имя пользователя Rackspace, переопределяет credentials.
validate_certs логическое значение	Варианты: нет да	Требовать или нет валидации SSL API-точек доступа. алиасы: verify_ssl

Примечания

Примечание

Можно использовать следующие переменные среды: 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: Create a monitoring check
  gather_facts: False
  hosts: local
  connection: local
  tasks:
  - name: Associate a check with an existing entity.
    community.general.rax_mon_check:
      credentials: ~/.rax_pub
      state: present
      entity_id: "{{ the_entity['entity']['id'] }}"
      label: the_check
      check_type: remote.ping
      monitoring_zones_poll: mziad,mzord,mzdfw
      details:
        count: 10
      meta:
        hurf: durf
    register: the_check

Авторы

Эш Уилсон (@smashwilson)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/rax_mon_check_module.html