このページでは

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 データストリーム

AmplitudeデータのKinesisデータストリーム連携は、Amplitudeイベントデータを直接Kinesisデータストリームにストリーミングします。

考慮事項

  • Amplitudeは、すべてのユーザー、グループ、イベントプロパティとともに、user_id、event_nameおよびcreated_atをKinesisストリームに送信します。
  • Kinesis Data Streamはほぼリアルタイムの送信先であるため、イベントストリーミングの使用状況にカウントされます。同じウェアハウス送信先セクション内のバッチエクスポート先（Amazon S3など）は、イベントストリーミングの使用量にはカウントされません。
  • Kinesis に投稿されるデータは Amplitude Export API に記載されているものと同じ JSON です。
  • この送信先はID転送をサポートしています。AmplitudeにIdentify呼び出しを発信するたびに、Amplitudeはそのユーザー情報を転送します。詳細については、Identifyドキュメントを参照してください。
  • ロール名は次の形式である必要があります：arn:aws:iam::{your aws account id}:role/{role name}。

連携を設定する

Kinesis の設定

1. Kinesis ストリームの作成

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

2. IAM ロールを作成する

AmplitudeにAWS Kinesis 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. 「Create Policy from JSON」オプションを選択し、「Policy Document」フィールドで次のテンプレートポリシーを使用します。 {account-id}をアカウントIDに変更し、{region}および{stream-name}を該当する値に置き換えます。また、{role-name} を先ほど作成したロールに置き換えてください。

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

  3. 新しいポリシーをロールに割り当てます。

    1. ロールを開きます。
    2. ポリシーを添付オプションを選択し、新しいポリシーを選択します。

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

Amplitude設定

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

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

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