에어브릿지는 구글 클라우드 스토리지(Google Cloud Storage, GCS) 연동을 지원합니다. 연동을 완료하면 에어브릿지 앱, 웹 SDK와 트래킹 링크에서 수집한 이벤트의 로우 데이터를 구글 클라우드 스토리지에서 확인할 수 있습니다. 에어브릿지 이벤트의 로우 데이터는 일별로 구글 클라우드 스토리지에 전송됩니다. 구글 클라우드 스토리지로 전송된 데이터는 목적에 맞게 원하는 형태로 활용할 수 있습니다.
연동하기
구글 클라우드 스토리지(Google Cloud Storage)와 연동하기 위해서는 아래 정보를 에어브릿지 대시보드에 입력해야 합니다.
- 클라이언트 이메일(Client Email)
- 프라이빗 키(Private Key)
- 버킷 이름(Bucket Name)
클라이언트 이메일과 프라이빗 키는 구글 클라우드 콘솔(Google Cloud Console)에서 JSON 파일로 다운로드할 수 있습니다. 버킷 이름은 구글 클라우드 콘솔에서 버킷을 생성할 때 지정할 수 있습니다.
구글 클라우드 콘솔에서 연동 정보 생성하기
구글 클라우드 콘솔에서 에어브릿지 대시보드에 입력할 클라이언트 이메일과 프라이빗 키를 JSON 파일 형태로 다운로드합니다.
1. 구글 클라우드 콘솔(Console)에 로그인하고 [IAM 및 관리자]를 선택합니다.
2. [서비스 계정]에서 ‘서비스 계정 만들기’를 클릭합니다.
3. 서비스 계정을 생성합니다.
4. 생성한 서비스 계정의 ‘작업’에서 ‘키 관리’를 클릭합니다.
5. ‘키 추가’에서 ‘새 키 만들기’를 클릭합니다.
6. JSON 형식으로 키를 다운로드합니다. 해당 키는 클라이언트 이메일과 프라이빗 키를 포함합니다.
구글 클라우드 콘솔에서 버킷 만들기
구글 클라우드 콘솔에서 에어브릿지 이벤트 데이터를 받기 위한 버킷을 생성합니다. 버킷을 생성하는 과정에서 지정한 버킷 이름은 에어브릿지 대시보드에서 동일하게 사용됩니다.
1. 구글 클라우드 콘솔(Console)에서 탐색 메뉴 아이콘을 클릭해 [Cloud Storage]>[버킷]을 선택합니다.
2. ‘만들기’ 또는 ‘버킷 만들기’를 클릭합니다.
3. 버킷을 생성합니다. 버킷 만들기에서 지정한 버킷 이름은 에어브릿지 대시보드에서 동일하게 사용되므로 주의해 주세요.
4. 버킷 세부정보의 [권한]에서 ‘액세스 권한 부여’를 클릭합니다.
5. 주 구성원 추가에 새 주 구성원으로 client_email을 입력합니다.
클라이언트 이메일은 구글 클라우드 콘솔에서 연동 정보를 생성하며 다운로드한 JSON 파일에서 확인할 수 있습니다. client_email의 값을 큰따옴표(” “)를 제외하고 입력해 주세요.
6. 새로 추가한 주 구성원에 역할을 지정하기 위해 ‘역할 선택’을 클릭합니다.
7. Cloud Storage에서 저장소 개체 관리자 역할을 지정하고 저장합니다.
에어브릿지에서 연동 정보 입력하기
에어브릿지 대시보드에 구글 클라우드 콘솔에서 생성한 연동 정보를 입력합니다. 필요한 연동 정보는 아래와 같습니다. 필요한 연동 정보를 모두 준비하지 않았다면 이전 단계부터 진행해 주세요.
- 클라이언트 이메일(Client Email)
- 프라이빗 키(Private Key)
- 버킷 이름(Bucket Name)
1. 에어브릿지 대시보드 [Integrations]>[Third-party Integration]에서 ‘Google Cloud Storage’를 클릭합니다.
2. 클라이언트 이메일(Client Email)과 프라이빗 키(Private Key)에는 구글 클라우드 콘솔에서 연동 정보를 생성하며 다운로드한 JSON 파일에 포함된 값을 입력합니다.
클라이언트 이메일은 client_email, 프라이빗 키는 private_key를 입력합니다. client_email과 private_key의 값을 큰따옴표(” “)를 제외하고 입력해 주세요. 프라이빗 키는 ----BEGIN PRIVATE KEY-----\n부터 ----END PRIVATE KEY-----\n까지 포함돼야 합니다.
3. 에어브릿지 대시보드에서 버킷 이름(Bucket Name)에는 연동하고 싶은 버킷의 이름을 입력합니다. 구글 클라우드 콘솔 [Cloud Storage]>[버킷]에서 버킷 이름을 확인할 수 있습니다. 구글 클라우드 콘솔의 버킷 세부정보에서 아래 표시된 아이콘으로 버킷 이름을 복사할 수 있습니다.
4. CSV와 Parquet 방식 중 원하는 연동 포맷을 선택하고 ‘등록’을 클릭합니다.
상태 메시지
연동 정보를 등록하면 상태 메시지에서 버킷 경로별로 연동 상태를 확인할 수 있습니다. 연동을 등록한 직후에는 에어브릿지가 구글 클라우드 스토리지에 데이터를 전송하기 전까지 Waiting이 표시됩니다. 에어브릿지는 KST(한국표준시간) 기준으로 매일 오전 4시에 데이터를 전송합니다. 상태 메시지는 아래처럼 표시됩니다.
| 상태 메시지 | 의미 |
|---|---|
| Waiting | 연동 정보를 등록한 후에 데이터를 전송하기 전까지 대기하고 있습니다. |
| Success | 서드파티 플랫폼에 하루치 데이터를 정상적으로 전송했습니다. |
| Error | 연동 정보 관련 또는 그 외 문제로 인해 데이터를 전송하지 못했습니다. |
| No Data | 연동이 정상적으로 진행 중이지만 서드파티 플랫폼에 전송할 데이터가 존재하지 않습니다. |
연동 정보 수정
연동하는 구글 클라우드 스토리지의 연동 정보가 바뀌었다면 이미 등록한 연동 정보를 변경된 값으로 수정해야 합니다. 각 연동 정보 입력창 오른쪽의 연필 아이콘을 클릭해 변경할 값으로 수정합니다. 수정이 끝나면 ‘수정 완료’를 클릭합니다.
연동 등록 삭제
연동하는 구글 클라우드 스토리지의 연동 정보를 삭제하고 연동을 중단하고 싶다면 ‘등록 삭제’를 클릭합니다. 연동 정보를 삭제하기 전에 전송된 데이터는 구글 클라우드 스토리지에서 사라지지 않습니다. 삭제 이후에 다시 연동하고 싶다면 연동 정보를 다시 등록해 주세요.
연동 관련 오류 발생
에어브릿지 대시보드에서 연동에 대한 오류 알림을 확인했다면 전체 연동 정보를 다시 입력해야 합니다. 전체 연동 정보를 올바르게 입력한 후에 ‘등록’을 클릭합니다.
서드파티 플랫폼 연동에 대한 오류 알림은 [Integrations]>[Integration Overview]에서도 확인할 수 있습니다. 오류가 발생한 서드파티 플랫폼을 확인하고 해당하는 대시보드로 바로 이동할 수 있습니다.
주의사항
클라우드 스토리지형 서드파티 플랫폼 지원 제한
에어브릿지는 클라우드 스토리지 유형의 서드파티 플랫폼 연동을 1개만 기본 지원합니다. 에어브릿지에서 지원하는 클라우드 스토리지 유형의 서드파티 플랫폼은 아마존 S3, 구글 클라우드 스토리지(Google Cloud Storage), 애저 블롭 스토리지(Azure Blob Storage)로 총 3개입니다. 2개 이상 연동을 하기 위해서는 추가 비용이 발생할 수 있습니다. 관련 사항은 에어브릿지 CSM에게 문의해 주세요.
클라우드 스토리지형 서드파티 플랫폼 연동 상태
클라우드 스토리지형 서드파티 플랫폼의 연동 상태는 아래의 상태 메시지를 통해 확인할 수 있습니다. 에어브릿지 대시보드 [Integrations]>[Third-party Integration]에서 각 서드파티 플랫폼의 표시 이름 아래에 나타납니다.
Configured는 기본적으로 연동 정보가 등록된 상태를 의미합니다. 데이터 전송 여부를 보여주는 일부 서드파티 플랫폼만 데이터 전송 여부까지 확인할 수 있습니다.
| 연동 상태 | 의미 |
|---|---|
| (메시지 없음) | 연동 정보를 등록하지 않았거나 연동 상태를 알 수 없습니다. |
| Configured | 데이터가 정상적으로 전송되고 있습니다. |
| Error | 문제가 발생해 데이터 전송이 진행되고 있지 않습니다. |
| Closed | 서드파티 플랫폼이 잠겨 있습니다. 에어브릿지 CSM에게 문의해 주세요. |
