# Ações de alarme
É possível especificar quais ações um alarme realizará ao mudar de estado entre os estados OK, ALARM e INSUFFICIENT\_DATA.
A maioria das ações pode ser definida para a transição para cada um dos três estados. Com exceção das ações do Auto Scaling, as ações acontecem somente em transições de estado e não serão executadas novamente se a condição persistir por horas ou dias.
As ações apresentadas a seguir têm suporte como ações de alarme:
+ Notificar um ou mais assinantes ao usar um tópico do Amazon Simple Notification Service. Os assinantes podem ser aplicações e também pessoas.
+ Invocar uma função do Lambda. Essa é a maneira mais fácil de automatizar ações personalizadas em alterações de estado de alarme.
+ Os alarmes baseados em métricas do EC2 também podem executar ações do EC2, como interromper, encerrar, reinicializar ou recuperar uma instância do EC2.
+ Os alarmes podem executar ações para escalar um grupo do Auto Scaling.
+ Os alarmes podem criar OpsItems no OpsCenter do Systems Manager ou criar incidentes no AWS Systems Manager Incident Manager. Essas ações são executadas apenas quando o alarme entra no estado ALARM (ALARME).
+ Um alarme pode iniciar uma investigação quando entra no estado ALARM.
Os alarmes também emitem eventos para Amazon EventBridge quando mudam de estado, e você pode configurar o Amazon EventBridge para acionar outras ações para essas mudanças de estado.
## Ações e notificações de alarmes
A tabela a seguir mostra as ações executadas para alarmes junto com seu comportamento para alarmes de várias séries temporais (ou colaboradores):
| Tipo de ação | Compatível com vários alarmes de séries temporais do Metrics Insights | Compatível com alarmes do PromQL | Mais informações |
| --- | --- | --- | --- |
| Notificações do SNS | Nível do colaborador | Nível do colaborador | [Destinos de eventos do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-event-destinations.html) |
| Ações do EC2 (interromper, terminar, reinicializar, recuperar) | Não suportado | Sem compatibilidade | [Interrupção, encerramento, reinício ou recuperação de uma instância do EC2](UsingAlarmActions.md) |
| Ações do Auto Scaling | Não suportado | Sem compatibilidade | [Políticas de escalabilidade simples e em etapas do Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html) |
| Criação do OpsItem do Systems Manager | Nível do alarme | Não compatível | [Configurar alarmes do CloudWatch para criar OpsItems](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-create-OpsItems-from-CloudWatch-Alarms.html) |
| Incidentes do Systems Manager Incident Manager | Nível do alarme | Não compatível | [Criação automática de incidentes com alarmes do CloudWatch](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-alarms) |
| Invocação da função do Lambda | Nível do colaborador | Nível do colaborador | [Invocar uma função do Lambda de um alarme](alarms-and-actions-Lambda.md) |
| Investigações do CloudWatch | Nível do alarme | Não compatível | [Iniciar uma investigação do CloudWatch em um alarme](Start-Investigation-Alarm.md) |
O conteúdo das notificações de alarme varia de acordo com o tipo de alarme:
+ Os alarmes de métrica única incluem um motivo do estado e dados detalhados do motivo do estado, mostrando os pontos de dados específicos que causaram a alteração de estado.
+ Os alarmes de várias séries temporais do Metrics Insights fornecem um motivo do estado simplificado para cada colaborador, sem o bloco de dados detalhado do motivo do estado.
+ Os alarmes do PromQL não incluem um motivo do estado ou dados do motivo do estado em suas notificações.
**Example Exemplos de conteúdo de notificação**
A notificação de alarme de métrica única inclui dados detalhados:
```
{
"stateReason": "Threshold Crossed: 3 out of the last 3 datapoints [32.6 (03/07/25 08:29:00), 33.8 (03/07/25 08:24:00), 41.0 (03/07/25 08:19:00)] were greater than the threshold (31.0)...",
"stateReasonData": {
"version": "1.0",
"queryDate": "2025-07-03T08:34:06.300+0000",
"startDate": "2025-07-03T08:19:00.000+0000",
"statistic": "Average",
"period": 300,
"recentDatapoints": [41, 33.8, 32.6],
"threshold": 31,
"evaluatedDatapoints": [
{
"timestamp": "2025-07-03T08:29:00.000+0000",
"sampleCount": 5,
"value": 32.6
}
// Additional datapoints...
]
}
}
```
Exemplo de notificação de SNS de alarme do Metrics Insights de várias séries temporais para colaborador:
```
{
"AlarmName": "DynamoDBInsightsAlarm",
"NewStateValue": "ALARM",
"NewStateReason": "Threshold Crossed: 1 datapoint was less than the threshold (1.0). The most recent datapoint which crossed the threshold: [0.0 (01/12/25 13:34:00)].",
"StateChangeTime": "2025-12-01T13:42:04.919+0000",
"OldStateValue": "OK",
"AlarmContributorId": "6d442278dba546f6",
"AlarmContributorAttributes": {
"TableName": "example-dynamodb-table-name"
}
// Additional information...
}
```
Exemplo de notificação do SNS de alarme do PromQL para colaborador:
```
{
"AlarmName": "HighCPUUsageAlarm",
"NewStateValue": "ALARM",
"StateChangeTime": "2025-12-01T13:42:04.919+0000",
"OldStateValue": "OK",
"AlarmContributorId": "1d502278dcd546a1",
"AlarmContributorAttributes": {
"team": "example-team-name"
}
// Additional information...
}
```
## Ações de silenciamento de alarme
As regras de silenciamento do alarme permitem silenciar automaticamente as ações do alarme durante janelas de tempo predefinidas, como períodos de manutenção ou eventos operacionais. O CloudWatch continua monitorando os estados de alarme enquanto evita notificações indesejadas. Para obter mais informações, consulte [Regras de silenciamento de alarmes](alarm-mute-rules.md).
**Regras de silenciamento versus desativação de ações de alarme**
As regras de silenciamento de alarme silenciam temporariamente as ações durante as janelas de horário programadas e restauram o som do alarme automaticamente quando a janela termina. Por outro lado, a API `DisableAlarmActions` desativa permanentemente as ações de alarme até que você chame `EnableAlarmActions` manualmente. A API `EnableAlarmActions` não ativa o som dos alarmes que sejam silenciados por regras ativas de silenciamento.
**nota**
Silenciar um alarme não impede que o CloudWatch envie eventos de alarme para criação, atualização, exclusão e alterações de estado de alarmes para o Amazon EventBridge.