この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

プラットフォームイベントの割り当て

プラットフォームイベントの定義、プラットフォームイベントの公開と登録、および CometD クライアントへのイベント配信で使用できる各種割り当てについて説明します。

一般的なプラットフォームイベントの割り当て

標準量プラットフォームイベントと大規模プラットフォームイベントには次の割り当てが適用されます。

説明 Performance Edition および Unlimited Edition Enterprise Edition Developer Edition Professional Edition (API アドオンあり)
1 つの組織で作成できるプラットフォームイベント定義の最大数 100 50 5 5
すべてのチャネルおよびすべてのイベント種別での、同時 CometD クライアント (登録者) の最大数 2,000 1,000 20 20
プラットフォームイベントを登録できるプロセスの最大数 4,000 4,000 4,000 5
プラットフォームイベントを登録できる有効なプロセスの最大数 2,000 2,000 2,000 5
  • 同時クライアント割り当ては、PushTopic、汎用、およびプラットフォームイベントを含む、ストリーミング API で登録可能なすべての種別のイベントで共有されます。同時クライアント割り当てを超えたクライアントはエラーになり、登録できません。クライアントのいずれかが接続解除し、その時点で接続が使用可能な場合、新しいクライアントが登録できます。『ストリーミング API 開発者ガイド』「ストリーミング API エラーコード」を参照してください。
  • インストール済み管理パッケージから発生したプラットフォームイベントは、プラットフォームイベント定義の最大数に対する組織の割り当てを共有します。

メモ

標準量プラットフォームイベントの割り当て

API バージョン 44.0 以前で定義された標準量イベントの割り当てを次に示します。

説明 Performance Edition および Unlimited Edition Enterprise Edition Developer Edition および Professional Edition (API アドオンあり)
イベント配信: 24 時間以内に配信され、すべての CometD クライアントで共有されるイベント通知の最大数1 50,000 25,000 10,000
イベント公開: 公開されるイベント通知の 1 時間あたりの最大数 100,000 100,000 1,000


イベント配信割り当てを超えると、エラーになります。『ストリーミング API 開発者ガイド』「ストリーミング API エラーコード」を参照してください。割り当てを超えた後に生成されたイベントメッセージは、イベントバスに保存されます。保存されたイベントメッセージは、24 時間の保持ウィンドウである限り取得できます。

標準量イベント配信の使用状況を監視するには、limits REST API リソースを使用して、DailyStandardVolumePlatformEvents 値を調べます。詳細は、『REST API 開発者ガイド』「組織の制限をリストする」を参照してください。

1CometD クライアントに配信するイベント数の増加を要求する合���、Salesforce に連絡してアドオンライセンスを購入してください。アドオンライセンスは、配信されるイベントの 1 日の制限を 100,000 イベントずつ増加します。たとえば、Unlimited Edition の場合、アドオンライセンスによって、配信されるイベントの 1 日の制限が 50,000 から 150,000 イベントに増加します。複数のアドオンを購入することで、CometD クライアントのイベント要件を満たすことができます。リリースの問題とサービスの低下を回避するため、CometD クライアントに配信するイベントの数を 1 日あたり 500 万以内に抑えることをお勧めします。これ以上の外部イベントが必要な場合は、Salesforce 担当者に連絡し、製品をどのように拡張すればニーズを満たすことができるかを確認してください。

大規模プラットフォームイベントのデフォルトの割り当て

Salesforce エディションごとに、CometD クライアントに配信されるイベント数のデフォルトの割り当てが提供されます。デフォルトの割り当ては日単位で適用され、マルチテナント環境のリソースが均等に共有されてサービスが保護されます。

外部の CometD クライアントに配信されたイベント数は、登録されたクライアントごとにカウントされます。複数のクライアント登録者がいる場合、使用量はすべての登録者に対して追加されます。たとえば、デフォルトの割り当てが 24 時間で 50,000 件のイベントの Unlimited Edition の組織があるとします。数時間以内に、20,000 件のイベントメッセージが 2 つの登録済みクライアントに配信されます。40,000 件のイベントを消費したことになり、まだこの 24 時間の期間内に 10,000 件のイベントを配信できます。

デフォルトのイベント配信割り当てを超えると、エラーになります。『ストリーミング API 開発者ガイド』「ストリーミング API エラーコード」を参照してください。割り当てを超えた後に生成されたイベントメッセージは、イベントバスに保存されます。保存されたイベントメッセージは、72 時間の保持ウィンドウである限り取得できます。

表 1. デフォルトの割り当て
説明 Performance Edition および Unlimited Edition Enterprise Edition および Professional Edition (API アドオンあり) Developer Edition
イベント配信: 24 時間以内に配信され、すべての CometD クライアントで共有されるイベント通知の最大数 50,000 25,000 10,000
イベント公開: 公開されるイベント通知の 1 時間あたりの最大数 250,000 250,000 50,000

大規模プラットフォームイベントのアドオンライセンスと使用量ベースのエンタイトルメント

アドオンにより、使用量ベースのエンタイトルメントとして、配信されるイベント通知の 24 時間の割り当てが 1 日ごとに 100,000 件増加します (1 か月ごとに 300 万件)。エンタイトルメントにより、割り当ての使用方法の選択肢が広がります。エンタイトルメントは、デフォルトの割り当てほど厳密には適用されません。エンタイトルメントにより、ある程度は 24 時間のイベント配信割り当てを超えることができます。

Salesforce は、その月の初日または契約開始日から始まるカレンダー月に基づいてイベント超過を監視します。月次エンタイトルメントを超えた場合、Salesforce からイベント使用量のニーズについて話し合うために連絡します。月次イベント超過を監視するために使用されるエンタイトルメントは、日次割り当てに 30 を掛けた値です。

アドオンライセンスを購入すると、1 時間のイベント公開割り当てが 1 時間あたり 25,000 件のイベント増加します。

表 2. 例: 1 つの大規模プラットフォームイベントのアドオンライセンスのエンタイトルメント
説明 Performance Edition および Unlimited Edition Enterprise Edition および Professional Edition (API アドオンあり)
イベント配信: 24 時間以内に配信され、すべての CometD クライアントで共有されるイベント通知のエンタイトルメント

エラーになる前に、ある程度はこのエンタイトルメントを超えることができます。Salesforce はイベント超過の監視に月次エンタイトルメントを使用します。月次エンタイトルメントは limits REST API リソースで返されます。

15 万件 (組織ライセンスの 5 万件 + アドオンライセンスによる 10 万件)

月次エンタイトルメント: 450 万件 (組織ライセンスの 150 万件 + アドオンライセンスによる 300 万件)

12 万 5000 件 (組織ライセンスの 2 万 5000 件 + アドオンライセンスによる 10 万件)

月次エンタイトルメント: 375 万件 (組織ライセンスの 75 万件 + アドオンライセンスによる 300 万件)

イベント公開: 公開されるイベント通知の 1 時間あたりの最大数 27 万 5000 件 (組織ライセンスの 25 万件 + アドオンライセンスによる 2 万 5000 件) 27 万 5000 件 (組織ライセンスの 25 万件 + アドオンライセンスによる 2 万 5000 件)

公開できるイベントメッセージの最大サイズは 1 MB です。イベントオブジェクトに数百件のカスタム項目または多数のロングテキストエリア項目が含まれる場合、この制限に達する可能性もあります。この場合、公開コールでエラーが発生します。

Lightning プラットフォームの登録者 (Apex トリガ、プロセス、フローを含む CometD 以外のクライアント) は、24 時間の CometD イベント配信制限にカウントされません。Apex トリガ、プロセス、またはフローで処理できるイベントメッセージ数は、各登録者の処理の時間によって異なります。処理時間が長いほど、登録者がイベントストリームの終了に到達するまでの時間が長くなります。

メモ

大規模イベントの使用状況の監視

毎月のイベント配信の使用状況を監視するには、limits REST API リソースを使用して、MonthlyPlatformEvents 値を調べます。limits リソースは 1 か月の最大割り当てを返します。アドオンライセンスがない場合、1 日のデフォルトの最大割り当ては、返された 1 か月の割り当てを 30 で割った値になります。詳細は、『REST API 開発者ガイド』「組織の制限をリストする」を参照してください。