• 유저 가이드
• 에어브릿지와 연동하기
• 데이터 스토리지 연동하기

아마존 S3

Written by Dana Kang,

11시간 전에 업데이트됨

알립니다

에어브릿지는 2024년 7월 1일부터 액세스 키를 통한 아마존 S3 연동을 지원하지 않습니다. 계속해서 아마존 S3로 데이터를 전송하기 위해서는 2024년 6월 30일까지 아래 작업을 모두 완료해야 합니다.

• 아마존 S3 데이터 필드 변경

• 액세스 키 방식 커넥션 삭제

• IAM 역할 방식 커넥션 생성

각 작업에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

기존에 IAM 역할 방식으로 연동한 고객사는 어떠한 조치도 필요하지 않습니다.

에어브릿지는 아마존 S3(Amazon S3) 연동을 지원합니다. 연동을 완료하면 에어브릿지 앱, 웹 SDK와 트래킹 링크에서 수집한 이벤트의 로우 데이터를 아마존 S3에서 확인할 수 있습니다. 에어브릿지 이벤트의 로우 데이터는 일별로 아마존 S3에 전송됩니다. 아마존 S3로 전송된 데이터는 목적에 맞게 원하는 형태로 활용할 수 있습니다.

주의하세요

기존 연동을 삭제하고 다시 연동하면 연동 버전이 항상 최신 버전으로 업데이트됩니다. 데이터 필드는 연동 버전에 따라 바뀌기 때문에 다시 연동하기 전에 먼저 데이터 필드 작업이 필요한지 검토해 주세요.

데이터 필드는 에어브릿지 가이드에서 확인할 수 있습니다.

아래 정보를 에어브릿지 대시보드에 입력해 커넥션을 생성하면 아마존 S3와 연동할 수 있습니다.

• 버킷 이름

• 리전

• IAM 역할 ARN

버킷 이름, 리전은 AWS의 아마존 S3 콘솔에서 확인할 수 있습니다. IAM 역할 ARN은 AWS의 IAM 콘솔에서 확인할 수 있습니다.

아마존 S3 콘솔에서 버킷 이름과 리전을 확인합니다.

1. AWS 매니지먼트 콘솔에 로그인하고 아마존 S3 콘솔로 이동합니다.

2. [버킷]에서 에어브릿지와 연동할 버킷의 이름과 리전을 확인합니다. 버킷이 없거나 새로운 버킷을 연동하고 싶다면 ‘버킷 만들기’를 클릭합니다. 자세한 과정은 AWS 가이드를 참고해 주세요.

아마존 S3 콘솔에서 확인한 버킷 이름과 리전을 에어브릿지 대시보드에 입력합니다.

1. 에어브릿지 대시보드의 [Integrations]>[Third-party Integration]에서 ‘Amazon S3’를 클릭합니다.

2. ‘생성하기’를 클릭합니다.

3. 아마존 S3 콘솔에서 확인한 버킷 이름과 리전을 입력합니다.

4. CSV와 Parquet 방식 중 원하는 연동 포맷을 선택하고 ‘등록’을 클릭합니다.

5. 모든 정보를 정확하게 등록하면 IAM 정책 생성에 필요한 정책을 확인할 수 있습니다. ‘복사’를 클릭해서 정책을 복사합니다. 다음 단계는 AWS의 IAM 콘솔에서 진행됩니다.

IAM 콘솔에서 아마존 S3 리소스에 대한 접근 권한을 부여하는 IAM 정책을 생성합니다.

1. AWS 매니지먼트 콘솔에 로그인하고 IAM 콘솔로 이동합니다.

2. [액세스 관리]>[정책]에서 ‘정책 생성’을 클릭합니다.

3. [JSON] 탭을 클릭합니다. 에어브릿지 대시보드에서 복사한 정책을 정책 편집기에 입력하고 ‘다음’을 클릭합니다.

4. [검토 및 생성]에서 원하는 정책 이름을 입력합니다. 그 외 설정은 변경하지 않습니다. ‘정책 생성’을 클릭하면 정책 생성이 완료됩니다.

IAM 콘솔에서 AWS 리소스에 대한 접근 권한을 위임할 수 있는 IAM 역할을 생성합니다.

1. 에어브릿지 대시보드에서 ‘다음 단계’를 클릭합니다.

2. IAM 역할 생성에 필요한 계정 ID와 외부 ID를 복사합니다.

3. IAM 콘솔의 [액세스 관리]>[역할]에서 ‘역할 생성’을 클릭합니다.

4. [신뢰할 수 있는 엔터티 유형]에서 ‘AWS 계정’을 선택합니다.

5. [AWS 계정]에서 ‘다른 AWS 계정’을 선택하고 에어브릿지 대시보드에서 복사한 계정 ID를 입력합니다. 옵션으로 ‘외부 ID 필요’를 선택하고 에어브릿지 대시보드에서 복사한 외부 ID를 입력합니다. ‘다음’을 클릭합니다.

6. [권한 추가]에서 에어브릿지와 아마존 S3를 연동하기 위해 생성한 정책을 정책 이름으로 검색합니다. 체크 박스를 클릭하고 ‘다음’을 클릭합니다.

7. [역할 세부 정보]에서 원하는 역할 이름을 입력합니다. 그 외 설정은 변경하지 않습니다. ‘역할 생성’을 클릭하면 역할 생성이 완료됩니다.

IAM 콘솔에서 확인한 IAM 역할 ARN을 에어브릿지 대시보드에 입력합니다.

1. IAM 콘솔의 [액세스 관리]>[역할]에서 에어브릿지와 아마존 S3를 연동하기 위해 생성한 IAM 역할의 이름을 클릭합니다.

2. ARN을 복사합니다.

3. 에어브릿지 대시보드에 IAM 역할 ARN을 입력하고 ‘등록’을 클릭합니다. 커넥션 테스트를 진행하면 모든 연동 과정이 완료됩니다.

에어브릿지가 아마존 S3에 정상적으로 데이터를 전송할 수 있는지 테스트합니다. 테스트를 진행하지 않으면 연동이 완료되지 않습니다.

1. 에어브릿지 대시보드에서 ‘커넥션 테스트’를 클릭합니다.

2. 테스트가 완료될 때까지 10초 정도 기다립니다. 테스트에 성공하면 생성한 커넥션이 저장됩니다.

테스트에 실패하면 입력한 연동 정보를 확인한 후에 테스트를 다시 진행하세요. 테스트에 성공하지 않은 상태로 페이지를 떠나면 모든 연동 과정을 처음부터 다시 진행해야 합니다.

연동 정보를 수정하거나 삭제하고 싶다면 아래 내용을 확인해 보세요.

아마존 S3 커넥션 삭제하기

데이터 스토리지의 연동 오류 대응하기

연동 정보를 입력하면 목록의 상태 메시지를 통해서 데이터 소스별 연동 상태를 확인할 수 있습니다. 확인할 수 있는 데이터 소스별 상태 메시지와 데이터 스토리지의 연동 주기는 아래와 같습니다.

데이터 스토리지의 데이터 소스별 상태 메시지

알립니다

아마존 S3 최신 연동 버전은 2.0입니다. 해당 버전의 샘플 데이터는 아래에서 확인할 수 있습니다.

• CSV

• Parquet

아마존 S3 연동 설정을 완료하면 다음 날부터 데이터가 연동한 버켓의 아래 위치로 전송됩니다. 버컷에 전송되는 파일의 형식은 .csv.gz입니다. 이벤트별로 전송되는 파일의 열 이름에는 에어브릿지 데이터 스펙의 Field Name 열의 이름이 사용됩니다.

• 앱 이벤트: ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/app/${VERSION}/date=${year}-${month}-${day}/

• 웹 이벤트: ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/web/${VERSION}/date=${year}-${month}-${day}/

• 트래킹 링크 이벤트: ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/tracking-link/${VERSION}/date=${year}-${month}-${day}/

아래 사항을 주의해 주세요.

데이터 스토리지의 연동 상태 확인하기