기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS 를 통해 전달되는 서비스 이벤트 AWS CloudTrail
<a name="eb-service-event-cloudtrail"></a>

 AWS CloudTrail 는 AWS API 호출과 같은 이벤트를 자동으로 기록하는 서비스입니다. CloudTrail의 정보를 사용하는 EventBridge 규칙을 생성할 수 있습니다. CloudTrail에 대한 자세한 내용은 [란 무엇입니까 AWS CloudTrail?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)를 참조하세요.

CloudTrail은 다음과 같은 유형의 이벤트를 기본 EventBridge 이벤트 버스로 전송합니다. 각 경우 이벤트 `detail-type` 값은 나열된 이벤트 유형입니다.
+ `AWS API Call via CloudTrail`

  퍼블릭 AWS 서비스 API에 대한 요청을 나타내는 이벤트입니다.

  자세한 내용은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 이벤트 이해](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-events.html)를 참조하세요.
+ `AWS Console Signin via CloudTrail`

   AWS 관리 콘솔, AWS 토론 포럼 및 AWS 지원 센터에 로그인하려고 시도합니다.

  자세한 내용은 *AWS CloudTrail 사용 설명서*의 [AWS Management Console 로그인 이벤트](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)를 참조하세요.
+ `AWS Console Action via CloudTrail`

  API 직접 호출이 아닌 콘솔에서 수행된 작업입니다.

  자세한 내용은 *AWS CloudTrail 사용 설명서*의 [AWS Management Console 로그인 이벤트](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)를 참조하세요.
+ `AWS Service Event via CloudTrail`

   AWS 서비스에서 생성하지만 퍼블릭 AWS 서비스 API에 대한 요청에 의해 직접 트리거되지 않는 이벤트입니다.

  자세한 내용을 알아보려면 *AWS CloudTrail 사용 설명서*의 [AWS 서비스 이벤트](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/non-api-aws-service-events.html)를 참조하세요.
+ `AWS Insight via CloudTrail`

  인사이트 이벤트는 고객이 CloudTrail Insight 기능을 활성화하면 CloudTrail에 의해 트리거됩니다.

  자세한 설명은 *AWS CloudTrail 사용자 가이드*의 [CloudTrail Insight](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-insight-details.html)를 참조하세요.
+ `AWS Network Activity Event via CloudTrail`

  네트워크 활동 이벤트는 프라이빗 VPC에서 VPC 엔드포인트를 통해 이루어진 API 호출을 캡처VPCs. 이러한 이벤트에는 관련 이벤트 소스에 대한 네트워크 활동 이벤트 선택기로 구성된 추적이 필요합니다.

  자세한 내용은 *AWS CloudTrail 사용 설명서*의 [네트워크 활동 이벤트 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html)을 참조하세요.

CloudTrail `detail-type` 값 중 하나를 사용하여 이벤트를 기록하려면 로깅을 사용하여 CloudTrail 추적을 활성화해야 합니다. 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 트레일을 통해 작업](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-trails.html)을 참조하세요.

**참고**  
모든 CloudTrail 이벤트는 기본 이벤트 버스에만 전달됩니다. 사용자 지정 이벤트 버스에서 CloudTrail 이벤트를 처리하려면 일치하는 이벤트를 사용자 지정 버스로 전달하는 규칙을 기본 버스에 생성합니다.

규칙 상태는 일치하는 이벤트 범주를 제어합니다.
+ *관리 이벤트 쓰기(변환)* - 기본 `ENABLED` 상태의 규칙과 일치합니다. 활성 추적 외에는 특별한 구성이 필요하지 않습니다.
+ *읽기 전용 관리 이벤트 -* 상태가 로 설정된 규칙에 의해서만 일치합니다`ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`. 자세한 내용은 [AWS 서비스에서 읽기 전용 관리 이벤트 수신](eb-service-event-cloudtrail-management.md) 단원을 참조하십시오.
+ *데이터 이벤트* - 기본 `ENABLED` 상태의 규칙과 일치합니다. 추적은 특정 데이터 이벤트 유형을 캡처하도록 구성되어야 합니다. 자세한 내용을 알아보려면 *AWS CloudTrail 사용 설명서*의 [데이터 이벤트 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)을 참조하세요.
+ *네트워크 활동 이벤트* - 기본 `ENABLED` 상태의 규칙과 일치합니다. 추적은 관련 이벤트 소스에 대한 네트워크 활동 이벤트 선택기로 구성되어야 하며, API 호출은 VPC 엔드포인트를 통해 이루어져야 합니다.

 AWS 서비스의 일부 발생은 서비스 자체와 CloudTrail 모두에 의해 EventBridge에 보고될 수 있습니다. 예를 들어 인스턴스를 시작하는 Amazon EC2 API 직접 호출은 여러 이벤트를 생성합니다.
+ `EC2 Instance State-change Notification` 인스턴스가 `pending`에 들어갔다가 `running` 상태가 되면 Amazon EC2에서 EventBridge로 직접 전송되는 이벤트입니다. 예제:

  ```
  {
      . . . 
     "detail-type":"EC2 Instance State-change Notification",
     "source":"aws.ec2",
      . . . 
     "detail":{
        "instance-id":"i-abcd1111",
        "state":"pending"
     }
  }
  ```
+ API 직접 호출을 나타내는 CloudTrail에서 EventBridge로 전송되는 `AWS API Call via CloudTrail` 이벤트입니다. 예제:

  ```
  {
      . . . 
     "detail-type":"AWS API Call via CloudTrail",
     "source":"aws.ec2",
      . . . 
     ],
    "detail": {
      "eventSource": "ec2.amazonaws.com",
      "eventName": "StartInstances"
      }
  }
  ```

**참고**  
`Put*Events` API 호출 이벤트를 이벤트 패턴 생성의 기반으로 사용하는 경우 최종 이벤트 패턴이 1MB를 초과하지 않도록 해야 합니다. `Put*Events` 요청의 최대 크기는 1MB입니다. 자세한 내용은 [](eb-putevents.md) 단원을 참조하십시오.

CloudTrail이 지원하는 서비스에 대한 자세한 내용은 *CloudTrail 사용 설명서*의 [CloudTrail 지원 서비스 및 통합](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)을 참조하세요.