エージェントを手動でアップグレードする方法

Pendoエージェントとは何ですか?また、「スニペット」とは何ですか?

Pendoエージェントは、ウェブアプリケーションの訪問者のブラウザ内部で実行されるJavascriptコードです。標準的な方法でPendoをインストールした場合、安全かつ非同期的にPendoエージェントがCloudfront CDNから読み込まれます。

「スニペット」は、[Pendoインストール設定(Pendo Install Setup)]のインストール(Install)ページから確認できる数行のコードで、これにより完全なエージェントがアプリケーションに組み込まれます。

 

古いバージョンと新しいバージョンはどうすれば見分けられますか?

ブラウザのコンソールで、pendo.VERSIONと入力することで、現在使用しているPendoスニペットとPendoエージェントのバージョンを確認できます。2.120.4以上の数字が表示される場合は、新しいバージョンのスニペットとエージェントが使用されています。1.xと表示される場合は古いバージョンが使用されているため、2.120.4以降のバージョンにアップグレードする必要があります。

 

ベータ版(Beta)、安定版(Stable)、手動(Manual)の違いは何ですか?

BetaVsStableVsManual

ベータ版の場合、最新版のPendoエージェントが適用されるようにサイトが自動で更新されます。これは、ステージングサーバーのデフォルトであり、推奨設定です。

安定版の場合、ベータ版から1~2週間遅れたエージェントのバージョンが適用されるようにサイトが自動で更新されます。これは、本番サーバーのデフォルトであり、推奨設定です。

手動では、特定のバージョンのエージェントを手動で選択できます。この場合、たとえばステージング環境でバージョンをテストしてから、必要に応じてそのテスト済みのバージョンを本番環境に切り替えることなどができます。

 

エージェントの更新通知はどこでサブスクライブできますか?

Pendoの開発者サイトからRSSフィードで購読できます。

 

新しいバージョンに移行するにはどうすればよいですか?

Pendoでは、エージェントに対する最新のアップデートと重大なバグ修正を受信できるように、エージェントのバージョンを自動的に「安定版」に更新することをお勧めしています。エージェントのバージョンを手動で更新する場合は、(Pendo管理者として)[サブスクリプション設定(Subscription Settings)]に移動します。

subscription-settings.png

複数のウェブアプリケーションを設定している場合は、対象のアプリケーションを選択し、[エージェント設定(Agent Settings)]タブに移動します。

agent-settings.jpg

このセクションでは、ステージング環境および本番環境で現在使用しているエージェントのバージョンを表示します。[ステージング/本番設定管理(Manage Staging / Production Settings)]を選択し、次に[手動(Manual)]ラジオボタンを選択して、対象のバージョンを選択します。

manage-settings.jpg
 
 

ステージング環境および本番環境での推奨設定は何ですか?具体的には、どのバージョンを実行すべきですか?

これは許容範囲によります。ステージング環境で「最新版」を使用して、最も新しいテスト済みバージョンを手動で選択し、それを本番環境で使用することもできます。

JSONP、XHRとは何ですか?どれを使用すればよいですか?

JsonVsXhr

Pendoの現在のデフォルトはJSONPであるため、これが使用されている可能性が高いです。特に問題がなければ、そのままJSONPを使用してください。一般的に、JSONPはブラウザの対応範囲が最も広いオプションです。プロダクトで古いブラウザを使用する場合は特に、JSONPの使用を強く推奨します。

お客様のセキュリティチームの中には、セキュリティ要件上の理由からJSONPを利用できない方もいます。このようなお客様は、ガイドコンテンツにPendoのXHRトランスポートを使用しています。

新しいバージョンに移行する必要がありますか?移行しない場合どうなりますか?

通常は移行する必要があります。ユーザーが古いエージェントを使用しても問題は発生しませんが、新しい機能を使うことはできません。最新版のエージェントにアップグレードしないことを選択したお客様は、古いバージョンのエージェントに自動的に適用されるセキュリティアップデートも受け取れません。