Spec-Zone.ru › Ansible 2.4

ec2_metric_alarm - Создание/обновление или удаление метрических тревог AWS Cloudwatch

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

  • Описание
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Примечания
    • Статус

Описание

  • Может создавать или удалять метрические тревоги AWS.
  • Метрики, по которым вы хотите установить тревогу, должны уже существовать.

Требования (к хосту, на котором выполняется модуль)

  • python >= 2.6
  • boto

Параметры

параметр обязателен по умолчанию возможные значения комментарии
alarm_actions
нет
Список имен действий, выполняемых при состоянии тревоги 'alarm'
aws_access_key
нет
Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY.
псевдонимы: ec2_access_key, access_key
aws_secret_key
нет
Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY.
псевдонимы: ec2_secret_key, secret_key
comparison
нет
  • <=
  • <
  • >
  • >=
Определяет, как сравнивать значение порога
description
нет
Более подробное описание тревоги
dimensions
нет
Описание, к чему применяется тревога
ec2_url
нет
URL для подключения к EC2 или вашему Eucalyptus облаку (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если не используется регион. Если не задан, используется значение переменной окружения EC2_URL, если есть.
evaluation_periods
нет
Количество раз, когда метрика оценивается перед окончательным расчетом
insufficient_data_actions
нет
Список имен действий, выполняемых при состоянии тревоги 'insufficient_data'
metric
нет
Название отслеживаемой метрики (например, CPUUtilization)
Метрика должна уже существовать
name
да
Уникальное имя для тревоги
namespace
нет
Название соответствующего пространства имён ('AWS/EC2', 'System/Linux' и т. д.), которое определяет категорию, под которой она будет отображаться в cloudwatch
ok_actions
нет
Список имен действий, выполняемых при состоянии тревоги 'ok'
period
нет
Время (в секундах) между оценками метрики
profile
(добавлен в 1.6)
нет
Использует профиль boto. Работает только с boto >= 2.24.0.
region
нет
Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
псевдонимы: aws_region, ec2_region
security_token
(добавлен в 1.6)
нет
Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN.
псевдонимы: access_token
state
да
  • present
  • absent
регистрация или отключение тревоги
statistic
нет
  • SampleCount
  • Average
  • Sum
  • Minimum
  • Maximum
Операция, применяемая к метрике
Работает совместно с period и evaluation_periods для определения сравниваемого значения
threshold
нет
Устанавливает минимально/максимальную границу для срабатывания тревоги
unit
нет
  • Seconds
  • Microseconds
  • Milliseconds
  • Bytes
  • Kilobytes
  • Megabytes
  • Gigabytes
  • Terabytes
  • Bits
  • Kilobits
  • Megabits
  • Gigabits
  • Terabits
  • Percent
  • Count
  • Bytes/Second
  • Kilobytes/Second
  • Megabytes/Second
  • Gigabytes/Second
  • Terabytes/Second
  • Bits/Second
  • Kilobits/Second
  • Megabits/Second
  • Gigabits/Second
  • Terabits/Second
  • Count/Second
  • None
Единица измерения порога
validate_certs
(добавлен в 1.5)
нет да
  • да
  • нет
При значении "нет", сертификаты SSL не будут проверены для boto версий >= 2.6.0.

Примеры

- name: create alarm
  ec2_metric_alarm:
    state: present
    region: ap-southeast-2
    name: "cpu-low"
    metric: "CPUUtilization"
    namespace: "AWS/EC2"
    statistic: Average
    comparison: "<="
    threshold: 5.0
    period: 300
    evaluation_periods: 3
    unit: "Percent"
    description: "This will alarm when a bamboo slave's cpu usage average is lower than 5% for 15 minutes "
    dimensions: {'InstanceId':'i-XXX'}
    alarm_actions: ["action1","action2"]

Примечания

Примечание

  • Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
  • Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
  • AWS_REGION или EC2_REGION обычно используются для указания региона AWS, когда это требуется, но это также можно настроить в файле конфигурации boto

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочитайте Community Information & Contributing, Testing Ansible и Developing Modules.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API