oneandone_monitoring_policy - Настройка политики мониторинга 1&1.
Новое в версии 2.5.
Обзор
- Создать, удалить, обновить политики мониторинга (и добавить/удалить порты, процессы и серверы). Этот модуль зависит от 1and1 >= 1.0
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- 1and1
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| add_ports | Порты для добавления в политику мониторинга. | ||
| add_processes | Процессы для добавления в политику мониторинга. | ||
| add_servers | Серверы для добавления в политику мониторинга. | ||
| agent обязательно | Установите значение true для использования агента. | ||
| api_url | Пользовательский URL API. Перезаписывает переменную окружения ONEANDONE_API_URL. | ||
| auth_token обязательно | Токен аутентификации API, предоставленный 1&1. | ||
| description | Описание политики мониторинга. maxLength=256 | ||
| email обязательно | Электронная почта пользователя. maxLength=128 | ||
| monitoring_policy обязательно | Идентификатор (id или имя) политики мониторинга, используемой для обновления состояния. | ||
| name обязательно | Имя политики мониторинга, используемое для текущего состояния. Используется в качестве идентификатора (id или имя) при использовании состояния отсутствия. maxLength=128 | ||
| ports обязательно | Массив портов, которые будут контролироваться. | ||
| protocol обязательно |
| Интернет-протокол. | |
| port обязательно | Номер порта. minimum=1, maximum=65535 | ||
| alert_if обязательно |
| Случай срабатывания оповещения. | |
| email_notification обязательно | Установите значение true для отправки уведомлений по электронной почте. | ||
| processes обязательно | Массив процессов, которые будут контролироваться. | ||
| process обязательно | Имя процесса. maxLength=50 | ||
| alert_if обязательно |
| Случай срабатывания оповещения. | |
| remove_ports | Порты для удаления из политики мониторинга. | ||
| remove_processes | Процессы для удаления из политики мониторинга. | ||
| remove_servers | Серверы для удаления из политики мониторинга. | ||
| state |
| Определение состояния политики мониторинга для создания, удаления, обновления. | |
| thresholds обязательно | Пороговые значения политики мониторинга. Каждый из подвариантов имеет предупреждение и критическое значение, которые оба имеют подварианты оповещения и значения. Предупреждение используется для установки пределов для предупреждающих оповещений, критический - для установки критических оповещений. alert включает оповещение, а значение используется для указания, когда значение превышено. | ||
| cpu обязательно | Пределы потребления ЦП. | ||
| ram обязательно | Пределы потребления ОЗУ. | ||
| disk обязательно | Пределы потребления жесткого диска. | ||
| internal_ping обязательно | Пределы ответа внутреннего пинга. | ||
| transfer обязательно | Пределы потребления для передачи. | ||
| update_ports | Порты для обновления в политике мониторинга. | ||
| update_processes | Процессы для обновления в политике мониторинга. | ||
| wait bool |
| Ожидание, пока экземпляр будет в состоянии 'running', перед возвратом | |
| wait_interval | Значение по умолчанию: 5 | Определяет количество секунд ожидания при использовании методов _wait_for | |
| wait_timeout | Значение по умолчанию: 600 | Сколько времени ждать, прежде чем ожидание прекратится, в секундах | |
Примеры
# Provisioning example. Create and destroy a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
name: ansible monitoring policy
description: Testing creation of a monitoring policy with ansible
email: your@emailaddress.com
agent: true
thresholds:
-
cpu:
warning:
value: 80
alert: false
critical:
value: 92
alert: false
-
ram:
warning:
value: 80
alert: false
critical:
value: 90
alert: false
-
disk:
warning:
value: 80
alert: false
critical:
value: 90
alert: false
-
internal_ping:
warning:
value: 50
alert: false
critical:
value: 100
alert: false
-
transfer:
warning:
value: 1000
alert: false
critical:
value: 2000
alert: false
ports:
-
protocol: TCP
port: 22
alert_if: RESPONDING
email_notification: false
processes:
-
process: test
alert_if: NOT_RUNNING
email_notification: false
wait: true
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
state: absent
name: ansible monitoring policy
# Update a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy
name: ansible monitoring policy updated
description: Testing creation of a monitoring policy with ansible updated
email: another@emailaddress.com
thresholds:
-
cpu:
warning:
value: 70
alert: false
critical:
value: 90
alert: false
-
ram:
warning:
value: 70
alert: false
critical:
value: 80
alert: false
-
disk:
warning:
value: 70
alert: false
critical:
value: 80
alert: false
-
internal_ping:
warning:
value: 60
alert: false
critical:
value: 90
alert: false
-
transfer:
warning:
value: 900
alert: false
critical:
value: 1900
alert: false
wait: true
state: update
# Add a port to a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
add_ports:
-
protocol: TCP
port: 33
alert_if: RESPONDING
email_notification: false
wait: true
state: update
# Update existing ports of a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
update_ports:
-
id: existing_port_id
protocol: TCP
port: 34
alert_if: RESPONDING
email_notification: false
-
id: existing_port_id
protocol: TCP
port: 23
alert_if: RESPONDING
email_notification: false
wait: true
state: update
# Remove a port from a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
remove_ports:
- port_id
state: update
# Add a process to a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
add_processes:
-
process: test_2
alert_if: NOT_RUNNING
email_notification: false
wait: true
state: update
# Update existing processes of a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
update_processes:
-
id: process_id
process: test_1
alert_if: NOT_RUNNING
email_notification: false
-
id: process_id
process: test_3
alert_if: NOT_RUNNING
email_notification: false
wait: true
state: update
# Remove a process from a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
remove_processes:
- process_id
wait: true
state: update
# Add server to a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
add_servers:
- server id or name
wait: true
state: update
# Remove server from a monitoring policy.
- oneandone_moitoring_policy:
auth_token: oneandone_private_api_key
monitoring_policy: ansible monitoring policy updated
remove_servers:
- server01
wait: true
state: update
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| monitoring_policy dict | всегда | Информация о политике мониторинга, которая была обработана Пример: {"id": "92B74394A397ECC3359825C1656D67A6", "name": "Политика по умолчанию"} |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Amel Ajdinovic (@aajdinov)
- Ethan Devenport (@edevenport)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/oneandone_monitoring_policy_module.html