이 페이지에서

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Amazon Kinesis Firehose

Amplitude Data의 Kinesis Data Firehose 연동은 Amplitude 이벤트 데이터를 Kinesis Firehose 스트림으로 바로 스트리밍합니다.

고려 사항

  • AWS 계정이 필요합니다.
  • Amplitude는 user_id, event_name 및 created_at를 모든 사용자, 그룹 및 이벤트 속성과 함께 Firehose 스트림으로 전송합니다.
  • Kinesis Firehose는 거의 실시간으로 진행되는 스트리밍 목적지이므로 이벤트 스트리밍 사용량에 포함됩니다. 동일한 웨어하우스 목적지 섹션에 있는 배치 내보내기 목적지(예: Amazon S3)는 이벤트 스트리밍 사용량에 포함되지 않습니다.
  • Amplitude가 Firehose에 게시하는 데이터는 Amplitude Export API에 설명된 것과 동일한 JSON입니다.
  • 이 목적지는 Identify Forwarding을 지원합니다. 사용자가 Amplitude에 대해 Identify 호출을 할 때마다 Amplitude는 해당 사용자 정보를 전달합니다. 자세한 내용은 Identify 문서를 참조하십시오.
  • 역할 이름을 다음 형식으로 입력하십시오: arn:aws:iam::{your aws account id}:role/{role name}.

연동 설정

Kinesis 설정

1. Kinesis Data Firehose 스트림 생성

AWS 콘솔에서 Kinesis Data Firehose 스트림을 생성합니다.

2. IAM 역할 생성

Amplitude가 AWS Kinesis Data Firehose Stream에 직접 쓰기 권한을 가질 수 있도록 IAM 역할을 생성하십시오.

  • 계정 ID에 358203115967을 지정하십시오. 이것은 이벤트를 내보내는 데 사용되는 Amplitude의 AWS 계정입니다.

  • 전체 정책을 할당하지 않고 역할을 완료합니다.

  • 새 역할에 대한 신뢰 관계는 다음과 같아야 합니다.

    json
    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::358203115967:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

3. IAM 정책 생성

  1. IAM 정책을 생성하여 Amplitude가 귀하의 Kinesis 스트림에 쓸 수 있는 권한을 부여하십시오.

  2. JSON에서 정책 생성 옵션을 선택하고 정책 문서 필드에서 다음 템플릿 정책을 사용하십시오. {account-id}을(를) 계정 ID로 변경하고, {region} 및 {stream-name}을(를) 해당 값으로 바꿉니다. 또한 {role-name}을(를) 방금 생성한 역할로 바꿉니다.

    json
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "firehose:PutRecord",
                "firehose:PutRecordBatch",
                "iam:SimulatePrincipalPolicy"
            ],
            "Resource": [
                "arn:aws:firehose:{region}:{account-id}:deliverystream/{stream-name}",
                "arn:aws:iam::{account-id}:role/{role-name}"
            ]
        }
    ]
}

  3. 역할에 새 정책을 할당합니다.

    1. 역할을 엽니다.
    2. 정책 연결 옵션을 선택하고 새 정책을 선택합니다.

역할 ARN, 스트림 리전 및 스트림 이름을 기록해 둡니다. Amplitude에서 목적지를 설정하려면 이것들이 필요합니다.

Amplitude 설정

Amplitude에서 Kinesis Firehose 목적지를 생성합니다.

  1. Amplitude 데이터에서 카탈로그를 클릭하고 대상 탭을 선택합니다.
  2. 웨어하우스 목적지 섹션에서 Kinesis Data Firehose를 클릭합니다.
  3. 동기화 이름을 입력한 다음 동기화 생성을 클릭합니다.
  4. 편집을 클릭한 다음 Kinesis Firehose 설정 다음 기간동안 생성한 AWS 리전, 스트림 이름 및 역할 이름(ARN)을 입력하십시오.
  5. 이벤트 보내기 필터를 사용하여 전송할 이벤트를 선택합니다. 모든 이벤트를 전송할 수 있지만, Amplitude는 가장 중요한 이벤트를 선택할 것을 권장합니다.
  6. 완료되면 목적지를 활성화하고 저장합니다.

이 내용이 도움이 되었나요?