Ресурс aws_cloudwatch_alarm

[редактировать на GitHub]

Используйте ресурс проверки InSpec для проверки свойств одной сигнализации CloudWatch.

Если совпадет более одной сигнализации, будет выведено сообщение об ошибке.

Синтаксис

Обеспечить существование сигнализации.

  aws_cloudwatch_alarm(metric_name: 'my-metric-name', metric_namespace: 'my-metric-namespace') do
    it { should exist }
  end

Параметры

metric_name (обязательно)

Имя метрики, используемой этой сигнализацией. Оно должно быть передано как metric_name: 'value' ключ-значение в хэше.

metric_namespace (обязательно)

Пространство имен метрики, используемой этой сигнализацией. Оно должно быть передано как metric_namespace: 'value' ключ-значение в хэше.

dimensions (необязательно)

Размеры, связанные с этой сигнализацией. Они должны быть переданы как массив хэшей dimensions: [{key:'value'}] .

Свойства

Свойство	Описание
alarm_actions	Действия, которые должны быть выполнены, когда эта сигнализация переходит в состояние ALARM из любого другого состояния. Каждое действие задаётся как Amazon Resource Name (ARN).
alarm_name	Имя сигнализации.
metric_name	Имя метрики.
metric_namespace	Пространство имен метрики.

Примеры

Обеспечить, чтобы у сигнализации было как минимум одно действие сигнализации

describe aws_cloudwatch_alarm(metric_name: 'my-metric-name', metric_namespace: 'my-metric-namespace') do
  its('alarm_actions') { should_not be_empty }
end

Обеспечить существование сигнализации с размерами

describe aws_cloudwatch_alarm(metric_name: 'my-metric-name', metric_namespace: 'my-metric-namespace', dimensions: [{key: 'value'}]) do
  it { should exist }
end

Сопоставители

Этот ресурс проверки InSpec имеет следующие специальные сопоставители. Полный список доступных сопоставителей можно найти на странице сопоставителей.

exist

Контроль пройдёт, если функция describe вернёт как минимум один результат.

Используйте should_not для проверки, что сущность не должна существовать.

describe aws_cloudwatch_alarm(metric_name: 'good-metric', metric_namespace: 'my-metric-namespace') do
  it { should exist }
end

describe aws_cloudwatch_alarm(metric_name: 'bed-metric', metric_namespace: 'my-metric-namespace') do
  it { should_not exist }
end

Разрешения AWS

У вашего Принципала должны быть разрешения на cloudwatch:DescribeAlarmsForMetric действие с Effect, установленным в Allow.

Подробную документацию можно найти по адресу Действия, ресурсы и ключи условий для Amazon CloudWatch.