Pendoのデータ同期機能を使用すると、Pendoのデータ(Pendo Feedbackのデータを除く)をAmazon S3アカウントにエクスポートできます。この記事では、IAMユーザーアクセスキーを使用したAmazon S3とのデータ同期の設定方法を説明します。もしくは、IAMロールを使用してAmazon S3とのデータ同期を設定することもできます。
前提条件
- データ同期は有料の機能です。この機能を利用するには、Pendoの担当者にお問い合わせください。
- この作業においてクラウドストレージの保存先を設定するには、Pendoのサブスクリプション管理者である必要があります。
- ユーザーはS3で
putObject
権限を取得している必要があります。
設定の概要
Amazon S3とのデータ同期では、Pendo側での設定と、S3アカウントでの構成が必要になります。IAMユーザーアクセスキーを使用してAmazon S3とのデータ同期を設定するには、次の手順を実行します。
- S3バケットを作成します。
- S3バケットにフォルダを作成します。
- サービスアカウント用のアクセスキーを生成します。
- Pendoでプロバイダーを選択します。
- PendoにサービスアカウントのアクセスキーとバケットURLを入力します。
運用環境での設定の場合は、個人に関連付けられていないサービスアカウントを作成する必要があります。内部のテスト開発の場合は、AWSの個人アカウントがPendoの組織に関連付けられている限り、そのアカウントを使用できます。
ステップ 1. S3バケットを作成する
PendoのデータはS3バケットにコピーされます。S3バケットは次の手順で作成します。
- [AWSマネジメントコンソール(AWS Management Console)]に移動します。
- Amazon S3コンソールを開き、[バケット]を選択します。
- ページの右上にある[バケットを作成する]を選択します。
- S3バケットにわかりやすい名前を付けます。
- ワークフローに従って、S3バケットを適切に設定します。
- フォームの下部にある [バケットを作成する] を選択します。
ステップ2. S3バケットにフォルダを作成する
ステップ 1で作成したバケットで以下を実施します。
- [フォルダの作成]を選択します。
- フォルダにわかりやすい名前を付けます。
- ワークフローに従って、S3フォルダを適切に設定します。
- フォームの下部にある [フォルダの作成] を選択します。
ステップ3. アクセスキーを生成する
アカウントに関連付けられたアクセスキーがまだない場合は、アクセスキーを生成してPendoのデータ同期先に追加する必要があります。このキーの生成方法は次のとおりです。
- [AWSマネジメントコンソール(AWS Management Console)]に移動します。
- 右上からアカウントを選択し、 [認証情報]を選択します。
- [アクセスキー]で、[アクセスキーの作成]を選択します。
- 説明タグの値を選択し、 [アクセスキーの作成]を選択します。
- 提供されたシークレットアクセスキーを保存するか、認証情報を含むCSVファイルをダウンロードします。この先これが表示されることはありません。これはステップ5で必要になります。
- [閉じる]を選択します。
ステップ4. Pendoでプロバイダーを選択する
ストレージバケットにデータを送信する前に、Pendoでターゲットとなる送信先を設定する必要があります。
- Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
- [宛先に接続(Connect to destination)]を選択します。
- 右側にスライドアウトするパネルで[Amazon Simple Storage Service(Amazon S3)]タイルにカーソルを合わせます。
- [宛先を選択(Choose Destination)]を選択します。パネルには、次のステップがまとめられています。
ステップ5. PendoでS3アカウントの宛先を設定する
最後に、サービスアカウントのキーをアップロードし、バケット名をPendoに設定します。
- バケットのURLを入力します。このURLは、[S3]>[バケット]>[バケット名]>[フォルダ名]で作成したデータ同期バケットの[プロパティ(Properties)]タブで確認できます。このURLを[フォルダ概要(Folder overview)]テーブルの[S3 URI]列にコピーします。
- シークレットアクセスキーを入力します。キーはステップ3でCSVファイルとして保存されているか、手動でコピーされています。
- 認証情報を含むCSVファイルをダウンロードした場合は、[CSVファイルをアップロード(Upload CSV file)]を選択してここにアップロードします。
- サービスアカウントとシークレットキーを手動で入力する場合は、まずアクセスキーを入力します。キーは[アクセスキー(Access Keys)]>[IAM]>[セキュリティ認証情報(Security Credentials)]で作成したデータ同期バケットの[プロパティ(Properties)]タブにあります。次に、ステップ3で保存したシークレットアクセスキーを入力します。
- [宛先を検証(Validate Destination)]を選択し、入力した認証情報をテストします。
- 正常に検証されたら、[宛先を作成(Create Destination)]を選択します。
認証情報のローテーション
PendoでAzureの宛先を構成した後に認証情報を更新するには、以下の2つの方法があります。
- Pendo UIを使って手動で更新する。
- 公開APIを使って自動で更新する。
公開APIのエンドポイントを使用してデータ同期の認証情報を更新するには、書き込み権限のあるインテグレーションキーが必要です。
Pendo UIを使う
- Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
- ページの右上にある[宛先を管理(Manage destination)]を選択します。
- 新しい認証情報を入力します。
公開APIを使う
- Pendoのインテグレーションキーの記事で説明されている手順に従って、新しいPendoインテグレーションキーを生成します。
- Pendoの公開API資料で、[データ同期(Data Sync)]に移動します。
- クラウドストレージの宛先に対応する
PUT
エンドポイントを選択します。 - 公開APIのエンドポイントを使用してクラウドストレージの認証情報を更新する手順に従います。
クラウドストレージの宛先を更新する
クラウドストレージの宛先を、あるS3バケットから別のバケットに移動したり、クラウドストレージサービスをGoogle Cloud Storage(GCS)やMicrosoft Azureなどの別のプロバイダーに変更したりするオプションがあります。
S3バケットを更新する
あるS3バケットから別の既存のS3バケットに変更したい場合は、次の手順でPendoのS3 URIフィールドを更新します。
- Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
- ページの右上にある[宛先を管理(Manage Destination)]を選択します。
- S3 URIフィールドのエントリを、データ同期に使用したい新しいS3バケットの名前に置き換えます。
- [宛先を更新(Update destination)]を選択します。
クラウドストレージプロバイダーを変更する
クラウドストレージの宛先をAmazon S3からGoogle Cloud Storage(GCS)やMicrosoft Azureなどの代替サービスに変更する場合は、既存の宛先を削除して新しい宛先を作成できます。
宛先を削除するには次の手順を実行します。
- Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
- ページの右上にある[宛先を管理(Manage destination)]を選択します。
- 宛先を削除(Delete destination)を選択します。
- 宛先を削除することを確定します。
宛先を削除すると、定期的なレポートと継続的なメタデータの更新は自動的にオフになります。
その後、以下の記事で説明されている手順に沿って、別のクラウドストレージを宛先として設定することができます。
あるいは、PendoがホストするGCSの宛先とのデータ同期を設定することもできます。詳細については、Pendoアカウントチームにお問い合わせください。