Amazon EventBridge를 사용하여 EC2 플릿 또는 스팟 플릿에서 발생하는 이벤트를 모니터링하고 프로그래밍 방식으로 대응하세요.

EC2 플릿 또는 스팟 플릿 상태가 변경되면 플릿에서 알림을 보냅니다. 알림은 Amazon EventBridge로 전송되는 이벤트(이전의 Amazon CloudWatch Events) 형태로 제공됩니다. 이벤트는 최선의 작업을 기반으로 발생됩니다.

Amazon EventBridge를 사용하여 이벤트에 대한 응답으로 프로그래밍 동작을 트리거하는 규칙을 생성할 수 있습니다. 예를 들어, 두 개의 EventBridge 규칙을 생성할 수 있습니다. 하나는 플릿 상태가 변경될 때 트리거되고, 다른 하나는 플릿의 인스턴스가 종료될 때 트리거됩니다. 이 예제에서는 플릿 상태가 변경되면 규칙이 SNS 주제를 호출하여 사용자에게 이메일 알림을 보내도록 첫 번째 규칙을 구성할 수 있습니다. 플릿의 인스턴스가 종료되면 두 번째 규칙이 Lambda 함수를 호출하여 새 인스턴스를 시작하도록 두 번째 규칙을 구성할 수 있습니다.

플릿의 이벤트 기록을 설명하는 방법에 대한 지침은 EC2 플릿의 이벤트 기록 설명 섹션을 참조하세요.

EC2 플릿 또는 스팟 플릿 이벤트를 모니터링하는 Amazon EventBridge 규칙 생성

EC2 플릿 또는 스팟 플릿에 대한 상태 변경 알림이 생성되면 해당 알림은 JSON 파일 형식의 이벤트로 Amazon EventBridge에 전송됩니다. EventBridge에서 규칙에 정의된 패턴과 일치하는 이벤트 패턴이 감지되는 경우, EventBridge는 규칙에 정의된 대상을 호출합니다.

일치하는 이벤트 패턴을 기반으로 작업을 자동화하는 EventBridge 규칙을 작성할 수 있습니다.

다음과 같은 이벤트 필드는 규칙에 정의된 이벤트 패턴을 형성합니다.

EC2 플릿 또는 스팟 플릿 이벤트 목록 및 이벤트 데이터 예는 EC2 집합 이벤트 유형 및 스팟 플릿 이벤트 유형 섹션을 참조하세요.

알림을 보내는 EventBridge 규칙 생성

다음 예제에서는 Amazon EC2에서 EC2 플릿 상태 변경 알림이 생성될 때마다 이메일, 문자 메시지 또는 모바일 푸시 알림을 보내는 EventBridge 규칙을 생성합니다. 이 예제의 신호는 규칙에 정의된 작업을 트리거하는 EC2 Fleet State Change 이벤트로 생성됩니다.

전제 조건

EventBridge 규칙을 생성하기 전에 이메일, 문자 메시지 또는 모바일 푸시 알림에 대한 Amazon SNS 주제를 생성해야 합니다.

자세한 내용은 Amazon EventBridge 사용 설명서에서 Amazon EventBridge 규칙 및 Amazon EventBridge 이벤트 패턴을 참조하세요.

Lambda 함수를 트리거하는 EventBridge 규칙 생성

다음 예제에서는 Amazon EC2에서 인스턴스가 시작되는 경우 EC2 플릿 인스턴스 변경 알림이 생성될 때마다 Lambda 함수를 트리거하는 EventBridge 규칙을 생성합니다. 이 예제의 신호는 규칙에서 정의한 작업을 트리거하는 하위 유형 launched인 EC2 Fleet Instance Change 이벤트로 전송됩니다.

EventBridge 규칙을 생성하기 전에 Lambda 함수를 생성해야 합니다.

Lambda 함수를 생성하고, Lambda 함수를 실행하는 EventBridge 규칙을 생성하는 방법에 대한 자습서는 AWS Lambda 개발자 안내서에서 자습서: EventBridge를 사용하여 Amazon EC2 인스턴스의 상태 로깅을 참조하세요.

EC2 집합 이벤트 유형

EC2 집합 이벤트 유형은 5가지입니다. 각 이벤트 유형에는 몇 가지 하위 유형이 있습니다.

EC2 플릿 상태 변경

EC2 집합 상태가 변경될 때 EC2 집합은 EC2 Fleet State Change 이벤트를 Amazon EventBridge로 전송합니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "715ed6b3-b8fc-27fe-fad6-528c7b8bf8a2",
    "detail-type": "EC2 Fleet State Change",
    "source": "aws.ec2fleet",
    "account": "123456789012",
    "time": "2020-11-09T09:00:20Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:fleet/fleet-598fb973-87b7-422d-be4d-6b0809bfff0a"
    ],
    "detail": {
        "sub-type": "active"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 플릿 스팟 인스턴스 요청 변경

플릿의 스팟 인스턴스 요청 상태가 변경될 때 EC2 집합은 EC2 Fleet Spot Instance Request Change 이벤트를 Amazon EventBridge로 보냅니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "19331f74-bf4b-a3dd-0f1b-ddb1422032b9",
    "detail-type": "EC2 Fleet Spot Instance Request Change",
    "source": "aws.ec2fleet",
    "account": "123456789012",
    "time": "2020-11-09T09:00:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:fleet/fleet-83fd4e48-552a-40ef-9532-82a3acca5f10"
    ],
    "detail": {
        "spot-instance-request-id": "sir-rmqske6h",
        "description": "SpotInstanceRequestId sir-rmqske6h, PreviousState: cancelled_running",
        "sub-type": "cancelled"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 플릿 인스턴스 변경

플릿의 인스턴스가 상태가 변경될 때 EC2 집합은 EC2 Fleet Instance Change 이벤트를 Amazon EventBridge로 보냅니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "542ce428-c8f1-0608-c015-e8ed6522c5bc",
    "detail-type": "EC2 Fleet Instance Change",
    "source": "aws.ec2fleet",
    "account": "123456789012",
    "time": "2020-11-09T09:00:23Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:fleet/fleet-598fb973-87b7-422d-be4d-6b0809bfff0a"
    ],
    "detail": {
        "instance-id": "i-0c594155dd5ff1829",
        "description": "{\"instanceType\":\"c5.large\",\"image\":\"ami-6057e21a\",\"productDescription\":\"Linux/UNIX\",\"availabilityZone\":\"us-east-1d\"}",
        "sub-type": "launched"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 플릿 정보

이행 중에 오류가 발생할 때 EC2 집합은 EC2 Fleet Information 이벤트를 Amazon EventBridge로 보냅니다. 정보 이벤트는 플릿에서 목표 용량을 이행하려는 시도를 차단하지 않습니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "76529817-d605-4571-7224-d36cc1b2c0c4",
    "detail-type": "EC2 Fleet Information",
    "source": "aws.ec2fleet",
    "account": "123456789012",
    "time": "2020-11-09T08:17:07Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:fleet/fleet-8becf5fe-bb9e-415d-8f54-3fa5a8628b91"
    ],
    "detail": {
        "description": "c4.xlarge, ami-0947d2ba12ee1ff75, Linux/UNIX, us-east-1a, Spot price in either SpotFleetRequestConfigData or SpotFleetLaunchSpecification or LaunchTemplate or LaunchTemplateOverrides is less than Spot market price $0.0619",
        "sub-type": "launchSpecUnusable"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 플릿 오류

이행 중에 오류가 발생할 때 EC2 집합은 EC2 Fleet Error 이벤트를 Amazon EventBridge로 보냅니다. 오류 이벤트는 플릿에서 목표 용량을 이행하려는 시도를 차단합니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "69849a22-6d0f-d4ce-602b-b47c1c98240e",
    "detail-type": "EC2 Fleet Error",
    "source": "aws.ec2fleet",
    "account": "123456789012",
    "time": "2020-10-07T01:44:24Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:fleet/fleet-9bb19bc6-60d3-4fd2-ae47-d33e68eafa08"
    ],
    "detail": {
        "description": "m3.large, ami-00068cd7555f543d5, Linux/UNIX: IPv6 is not supported for the instance type 'm3.large'. ",
        "sub-type": "spotFleetRequestConfigurationInvalid"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

스팟 플릿 이벤트 유형

스팟 플릿 이벤트 유형은 5가지입니다. 각 이벤트 유형에는 몇 가지 하위 유형이 있습니다.

EC2 스팟 플릿 상태 변경

스팟 플릿의 상태가 변경될 때 스팟 플릿은 EC2 Spot Fleet State Change 이벤트를 Amazon EventBridge로 보냅니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "d1af1091-6cc3-2e24-203a-3b870e455d5b",
    "detail-type": "EC2 Spot Fleet State Change",
    "source": "aws.ec2spotfleet",
    "account": "123456789012",
    "time": "2020-11-09T08:57:06Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:spot-fleet-request/sfr-4b6d274d-0cea-4b2c-b3be-9dc627ad1f55"
    ],
    "detail": {
        "sub-type": "submitted"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 스팟 플릿 스팟 인스턴스 요청 변경

스팟 플릿은 플릿의 스팟 인스턴스 요청 상태가 변경될 때 EC2 Spot Fleet Spot Instance Request Change 이벤트를 Amazon EventBridge로 보냅니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "cd141ef0-14af-d670-a71d-fe46e9971bd2",
    "detail-type": "EC2 Spot Fleet Spot Instance Request Change",
    "source": "aws.ec2spotfleet",
    "account": "123456789012",
    "time": "2020-11-09T08:53:21Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:spot-fleet-request/sfr-a98d2133-941a-47dc-8b03-0f94c6852ad1"
    ],
    "detail": {
        "spot-instance-request-id": "sir-a2w9gc5h",
        "description": "SpotInstanceRequestId sir-a2w9gc5h, PreviousState: cancelled_running",
        "sub-type": "cancelled"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 스팟 플릿 인스턴스 변경

플릿의 인스턴스가 상태가 변경될 때 스팟 플릿은 EC2 Spot Fleet Instance Change 이벤트를 Amazon EventBridge로 보냅니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "11591686-5bd7-bbaa-eb40-d46529c2710f",
    "detail-type": "EC2 Spot Fleet Instance Change",
    "source": "aws.ec2spotfleet",
    "account": "123456789012",
    "time": "2020-11-09T07:25:02Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:spot-fleet-request/sfr-c8a764a4-bedc-4b62-af9c-0095e6e3ba61"
    ],
    "detail": {
        "instance-id": "i-08b90df1e09c30c9b",
        "description": "{\"instanceType\":\"r4.2xlarge\",\"image\":\"ami-032930428bf1abbff\",\"productDescription\":\"Linux/UNIX\",\"availabilityZone\":\"us-east-1a\"}",
        "sub-type": "launched"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 스팟 플릿 정보

이행 중에 오류가 발생할 때 스팟 플릿은 EC2 Spot Fleet Information 이벤트를 Amazon EventBridge로 보냅니다. 정보 이벤트는 플릿에서 목표 용량을 이행하려는 시도를 차단하지 않습니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "73a60f70-3409-a66c-635c-7f66c5f5b669",
    "detail-type": "EC2 Spot Fleet Information",
    "source": "aws.ec2spotfleet",
    "account": "123456789012",
    "time": "2020-11-08T20:56:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:spot-fleet-request/sfr-2531ea06-af18-4647-8757-7d69c94971b1"
    ],
    "detail": {
        "description": "r3.8xlarge, ami-032930428bf1abbff, Linux/UNIX, us-east-1a, Spot bid price is less than Spot market price $0.5291",
        "sub-type": "launchSpecUnusable"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.

EC2 스팟 플릿 오류

이행 중에 오류가 발생할 때 스팟 플릿은 EC2 Spot Fleet Error 이벤트를 Amazon EventBridge로 보냅니다. 오류 이벤트는 플릿에서 목표 용량을 이행하려는 시도를 차단합니다.

다음은 이 이벤트의 예제 데이터입니다.

{
    "version": "0",
    "id": "10adc4e7-675c-643e-125c-5bfa1b1ba5d2",
    "detail-type": "EC2 Spot Fleet Error",
    "source": "aws.ec2spotfleet",
    "account": "123456789012",
    "time": "2020-11-09T06:56:07Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:ec2:us-east-1:123456789012:spot-fleet-request/sfr-38725d30-25f1-4f30-83ce-2907c56dba17"
    ],
    "detail": {
        "description": "r4.2xlarge, ami-032930428bf1abbff, Linux/UNIX: The associatePublicIPAddress parameter can only be specified for the network interface with DeviceIndex 0. ",
        "sub-type": "spotFleetRequestConfigurationInvalid"
    }
}

sub-type에 대해 가능한 값은 다음과 같습니다.