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 обязательно | Массив портов, которые будут контролироваться. | ||
| alert_if обязательно |
| Случай срабатывания оповещения. | |
| email_notification обязательно | Установите значение true для отправки уведомлений по электронной почте. | ||
| protocol обязательно |
| Интернет-протокол. | |
| port обязательно | Номер порта. minimum=1, maximum=65535 | ||
| processes обязательно | Массив процессов, которые будут контролироваться. | ||
| process обязательно | Имя процесса. maxLength=50 | ||
| alert_if обязательно |
| Случай срабатывания оповещения. | |
| remove_ports | Порты для удаления из политики мониторинга. | ||
| remove_processes | Процессы для удаления из политики мониторинга. | ||
| remove_servers | Серверы для удаления из политики мониторинга. | ||
| state |
| Определение состояния политики мониторинга для создания, удаления, обновления. | |
| thresholds обязательно | Пороговые значения политики мониторинга. Каждый из подвариантов имеет значения предупреждения и критические значения, которые оба содержат подварианты оповещения и значения. Предупреждение используется для установки пределов для предупреждений, критические значения используются для установки критических оповещений. Оповещение включает оповещение, а значение используется для указания, когда значение превышено. | ||
| transfer обязательно | Пределы потребления для передачи. | ||
| disk обязательно | Пределы потребления жесткого диска. | ||
| ram обязательно | Пределы потребления оперативной памяти. | ||
| cpu обязательно | Пределы потребления ЦП. | ||
| internal_ping обязательно | Пределы реакции внутреннего пинга. | ||
| update_ports | Порты для обновления в политике мониторинга. | ||
| update_processes | Процессы для обновления в политике мониторинга. | ||
| wait |
| Ожидание, пока экземпляр перейдет в состояние 'запущен' перед возвратом | |
| 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": "Политика по умолчанию"} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/oneandone_monitoring_policy_module.html