

# 경보 작업
<a name="alarm-actions"></a>

경보 상태가 OK, ALARM, INSUFFICIENT\$1DATA 간에 변경될 때 경보가 수행하는 작업을 지정할 수 있습니다.

세 가지 상태 각각으로 전환하기 위한 대부분의 작업을 설정할 수 있습니다. Auto Scaling 작업을 제외한 모든 작업은 상태 전환 시에만 수행되며 상태가 몇 시간 또는 며칠 동안 지속되는 경우 다시 수행되지 않습니다.

다음이 경보 작업으로 지원됩니다.
+ Amazon Simple Notification Service 주제를 사용하여 한 명 이상의 구독자에게 알립니다. 구독자는 개인일 뿐만 아니라 애플리케이션일 수도 있습니다.
+ Lambda 함수를 간접적으로 호출합니다. 이는 경보 상태 변경에 대한 사용자 지정 작업을 자동화하는 가장 쉬운 방법입니다.
+ EC2 지표를 기반으로 하는 경보는 EC2 인스턴스 중지, 종료, 재부팅 또는 복구와 같은 EC2 작업을 수행할 수도 있습니다.
+ 경보는 오토 스케일링의 규모를 조정하는 작업을 수행할 수 있습니다.
+ 경보는 Systems Manager Ops Center에서 OpsItems를 생성하거나 AWS Systems Manager Incident Manager에서 인시던트를 생성할 수 있습니다. 이러한 작업은 경보가 ALARM 상태가 될 때만 수행됩니다.
+ 경보는 ALARM 상태가 되었을 때 조사를 시작할 수 있습니다.

경보도 상태가 변경될 때 Amazon EventBridge로 이벤트를 내보내며, 이러한 상태 변경에 대해 다른 작업을 트리거하도록 Amazon EventBridge를 설정할 수 있습니다.

## 경보 작업 및 알림
<a name="alarm-actions-notifications"></a>

다음 표에는 여러 시계열(또는 기고자) 경보에 대한 동작과 함께 경보에 대해 실행된 작업이 나와 있습니다.


| 작업 유형 | Metrics Insights 다중 시계열 경보 지원 | PromQL 경보 지원 | 추가 정보 | 
| --- | --- | --- | --- | 
| SNS 알림 | 기고자 수준 | 기고자 수준 | [Amazon SNS event destinations](https://docs.aws.amazon.com/sns/latest/dg/sns-event-destinations.html) | 
| EC2 작업(중지, 종료, 재부팅, 복구) | 지원되지 않음 | 지원되지 않음 | [EC2 인스턴스 중지, 종료, 재부팅 또는 복구](UsingAlarmActions.md) | 
| 오토 스케일링 작업 | 지원되지 않음 | 지원되지 않음 | [Amazon EC2 Auto Scaling의 단계별 조정 및 단순 조정 정책](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html) | 
| Systems Manager OpsItem 생성 | 경보 수준 | 지원되지 않음 | [OpsItems를 생성하도록 CloudWatch 경보 구성](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-create-OpsItems-from-CloudWatch-Alarms.html) | 
| Systems Manager Incident Manager 인시던트 | 경보 수준 | 지원되지 않음 | [CloudWatch 경보를 사용하여 자동으로 인시던트 생성](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-alarms) | 
| Lambda 함수 간접 호출 | 기고자 수준 | 기고자 수준 | [경보에서 Lambda 함수 간접 호출](alarms-and-actions-Lambda.md) | 
| CloudWatch 조사 | 경보 수준 | 지원되지 않음 | [경보에서 CloudWatch 조사를 시작](Start-Investigation-Alarm.md) | 

경보 알림의 내용은 경보 유형에 따라 다릅니다.
+ 단일 지표 경보에는 상태 이유와 세부 상태 이유 데이터가 모두 포함되며 상태 변경의 원인이 된 특정 데이터 포인트를 표시합니다.
+ 다중 시계열 Metrics Insights 경보는 자세한 상태 이유 데이터 블록 없이 각 기고자에 대한 간소화된 상태 이유를 제공합니다.
+ PromQL 경보 알림에는 상태 이유 또는 상태 이유 데이터가 포함되지 않습니다.

**Example 알림 콘텐츠 예제**  
단일 지표 경보 알림에는 자세한 데이터가 포함됩니다.  

```
{
  "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...
    ]
  }
}
```
기고자에 대한 여러 시계열 Metrics Insights 경보 SNS 알림 예제:  

```
{
  "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...
}
```
기고자에 대한 PromQL 경보 SNS 알림 예제:  

```
{
  "AlarmName": "HighCPUUsageAlarm",
  "NewStateValue": "ALARM",
  "StateChangeTime": "2025-12-01T13:42:04.919+0000",
  "OldStateValue": "OK",
  "AlarmContributorId": "1d502278dcd546a1",
  "AlarmContributorAttributes": {
    "team": "example-team-name"
  }
  // Additional information...
}
```

## 경보 작업 음소거
<a name="mute-alarm-actions"></a>

 경보 음소거 규칙을 사용하면 유지 관리 기간 또는 운영 이벤트와 같은 사전 정의된 기간에 경보 작업을 자동으로 음소거할 수 있습니다. CloudWatch는 원치 않는 알림을 방지하면서 경보 상태를 계속 모니터링합니다. 자세한 내용은 [경보 음소거 규칙](alarm-mute-rules.md) 섹션을 참조하세요.

**음소거 규칙 및 경보 작업 비활성화**  
 경보 음소거 규칙은 예약된 기간에 일시적으로 작업을 음소거하고 해당 기간이 종료되면 자동으로 음소거를 해제합니다. 반대로 `DisableAlarmActions` API는 사용자가 `EnableAlarmActions`를 수동으로 직접 호출할 때까지 경보 작업을 영구적으로 비활성화합니다. `EnableAlarmActions` API는 활성 음소거 규칙에 의해 음소거된 경보를 음소거 해제하지 않습니다.

**참고**  
 경보를 음소거해도 CloudWatch가 경보의 생성, 업데이트, 삭제 및 상태 변경에 대한 경보 이벤트를 Amazon EventBridge로 전송하는 작업은 중지되지 않습니다.