このページでは

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など）は、イベントストリーミングの使用量にはカウントされません。
  • Firehoseに投稿されるAmplitudeのデータは、Amplitude Export APIに記載されているものと同じJSONです。
  • この送信先はID転送をサポートしています。AmplitudeにIdentify呼び出しを発信するたびに、Amplitudeはそのユーザー情報を転送します。詳細については、Identifyドキュメントを参照してください。
  • ロール名を次の形式で入力します：arn:aws:iam::{your aws account id}:role/{role name}。

連携を設定する

Kinesis の設定

1. Kinesis データ Firehose ストリームの作成

AWSコンソールでKinesisデータFirehoseストリームを作成します。

2. IAM ロールを作成する

AmplitudeがAWS KinesisデータFirehoseストリームに直接書き込む権限を付与する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. 「Create Policy from JSON」オプションを選択し、「Policy Document」フィールドで次のテンプレートポリシーを使用します。 {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. ［Attach Policies］ オプションを選択し、新しいポリシーを選択します。

ロールARN、ストリームリージョン、およびストリーム名を記録しておいてください。これらは Amplitude で送信先を設定するために必要です。

Amplitude設定

Amplitude で Kinesis Firehose の送信先を作成します。

  1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
  2. 「ウェアハウス送信先」セクションで、Kinesis Data Firehoseをクリックします。
  3. 同期名を入力し、[同期を作成] をクリックします。
  4. [編集] をクリックし、AWS リージョン、ストリーム名、および Kinesis Firehose のセットアップ時に作成したロール名 (ARN) を入力します。
  5. ［イベントを送信］ フィルタを使用して、送信するイベントを選択します。 すべてのイベントを送信できますが、Amplitudeでは最も重要なイベントを選択することをお勧めしています。
  6. 完了したら、送信先を有効にして保存します。

これは役に立ちましたか？