Alarmes do CloudWatch
A ação de alarme do CloudWatch (cloudWatchAlarm
) altera o estado de um alarme do Amazon CloudWatch. Você pode especificar o motivo da alteração do estado e o valor nessa chamada.
Requisitos
Esta ação de regra tem os seguintes requisitos:
-
Um perfil do IAM que AWS IoT pode assumir a execução da operação
cloudwatch:SetAlarmState
. Para obter mais informações, consulte Conceder a uma regra AWS IoT o acesso que ela exige.No console AWS IoT, você pode escolher ou criar uma função para permitir que AWS IoT execute essa ação de regra.
Parâmetros
Ao criar uma regra AWS IoT com esta ação, você deve especificar as seguintes informações:
alarmName
-
O nome do alarme do CloudWatch.
Compatível com modelos de substituição: API e AWS CLI somente
stateReason
-
O motivo para a alteração do alarme.
Compatível com modelos de substituição: Sim
stateValue
-
O valor do estado do alarme. Valores válidos:
OK
,ALARM
,INSUFFICIENT_DATA
.Compatível com modelos de substituição: Sim
roleArn
-
O perfil do IAM que permite o acesso ao alarme do CloudWatch. Para obter mais informações, consulte Requisitos.
Compatível com modelos de substituição: Não
Exemplos
O seguinte exemplo de JSON mostra como definir uma ação de alarme do CloudWatch em uma regra AWS IoT.
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "cloudwatchAlarm": { "alarmName": "IotAlarm", "stateReason": "Temperature stabilized.", "stateValue": "OK", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw" } } ] } }
Consulte também
-
O que é o Amazon CloudWatch? no Guia do usuário do Amazon CloudWatch
-
Uso de alarmes do Amazon CloudWatch no Manual do usuário do Amazon CloudWatch