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

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

Описание
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Описание

Создание или удаление проверки 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 (добавлено в 1.5)	По умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
check_type обязательно	Варианты: 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	Тип проверки для создания. Проверки `remote.` могут быть созданы для любого объекта rax_mon_entity. Проверки `agent.` могут быть созданы только для объектов rax_mon_entities, которые имеют непустое значение `agent_id`.
credentials		Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file
details		Дополнительные детали, специфичные для типа проверки. Должно быть хэшем строк длиной от 1 до 255 символов или массивом или объектом, содержащим от 0 до 256 элементов.
disabled bool	Варианты: no yes	Если "yes", то проверка создается, но не используется.
entity_id обязательно		ID объекта rax_mon_entity, на который нацелена эта проверка.
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 до 64 символов.
metadata		Хэш произвольных пар ключ-значение для сопровождения этой проверки в случае срабатывания. Ключи и значения должны быть строками длиной от 1 до 255 символов.
monitoring_zones_poll		Список зон мониторинга через запятую, из которых должна выполняться проверка. Доступные зоны мониторинга включают mzdfw, mzhkg, mziad, mzlon, mzord и mzsyd. Требуется для проверок remote.; запрещено для проверок agent..
period		Количество секунд между каждым выполнением проверки. Должно быть больше минимального значения, установленного для вашего аккаунта.
region	По умолчанию: "DFW"	Регион для создания экземпляра.
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 (добавлено в 1.5)		Идентификатор клиента, используемый для аутентификации.
tenant_name (добавлено в 1.5)		Имя клиента, используемое для аутентификации.
timeout		Количество секунд, которое эта проверка будет ждать при попытке сбора результатов. Должно быть меньше периода.
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: Create a monitoring check
  gather_facts: False
  hosts: local
  connection: local
  tasks:
  - name: Associate a check with an existing entity.
    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

Статус

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

Техническое обслуживание

Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

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

Автор

Эш Уилсон

Подсказка

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

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