サポート終了通知: 2026 年 5 月 20 日に、 AWS は のサポートを終了します AWS SimSpace Weaver。2026 年 5 月 20 日以降、 SimSpace Weaver コンソールまたは SimSpace Weaver リソースにアクセスできなくなります。詳細については、[AWS SimSpace Weaver 「サポート終了](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Service Quotas との連携
このセクションでは、 のサービスクォータを使用する方法について説明します SimSpace Weaver。**Quotas** は**リミット**とも呼ばれます。Service Quotas のリストについては、「[SimSpace Weaver エンドポイントとクォータ](service-quotas.md)」を参照してください。このセクションの API は**アプリケーション API** セットの一部です。アプリケーション API はサービス API とは異なります。アプリ APIsは SimSpace Weaver アプリ SDK の一部です。アプリケーション API のドキュメントは、ローカルシステムのアプリケーション SDK フォルダで確認できます。
```
{{sdk-folder}}\SimSpaceWeaverAppSdk-{{sdk-version}}\documentation\index.html
```
**Topics**
+ [アプリケーションの制限を取得する](#working-with_quotas_get-app-limits)
+ [アプリケーションが使用しているリソース量を取得する](#working-with_quotas_get-app-resources)
+ [メトリクスをリセットする](#working-with_quotas_reset-metrics)
+ [制限の超過](#working-with_quotas_exceed-limit)
+ [メモリの不足](#working-with_quotas_out-of-memory)
+ [ベストプラクティス](#working-with_quotas_best-practices)
## アプリケーションの制限を取得する
**RuntimeLimits** アプリケーション SDK を使用してアプリケーションの制限をクエリできます。
```
Result RuntimeLimit(Application& app, LimitType type)
```パラメータ
**Application& アプリケーション**
アプリケーションへの参照。
**LimitType タイプ**
以下の制限タイプを含む列挙値。
```
enum LimitType {
Unset = 0,
EntitiesPerPartition = 1,
RemoteEntityTransfers = 2,
LocalEntityTransfers = 3
};
```
以下の例では、エンティティ数の制限をクエリします。
```
WEAVERRUNTIME_TRY(auto entity_limit,
Api::RuntimeLimit(m_app, Api::LimitType::EntitiesPerPartition))
Log::Info("Entity count limit", entity_limit.value);
```
## アプリケーションが使用しているリソース量を取得する
**RuntimeMetrics** アプリケーション SDK を呼び出して、アプリケーションが使用しているリソースの量を取得できます。
```
Result> RuntimeMetrics(Application& app) noexcept
```パラメータ
**Application& アプリケーション**
アプリケーションへの参照。
API は、メトリクスを含む struct への参照を返します。カウンターメトリクスには現在の合計値が含まれ、増加のみします。ゲージメトリクスには増減する値が含まれます。アプリケーションランタイムは、イベントによって値が増加するたびにカウンターを更新します。ランタイムは API を呼び出したときのみゲージを更新します。 SimSpace Weaver はリファレンスがアプリケーションの存続期間中有効であることを保証します。API を繰り返し呼び出しても、参照は変更されません。
```
struct AppRuntimeMetrics {
uint64_t total_committed_ticks_gauge,
uint32_t active_entity_gauge,
uint32_t ticks_since_reset_counter,
uint32_t load_field_counter,
uint32_t store_field_counter,
uint32_t created_entity_counter,
uint32_t deleted_entity_counter,
uint32_t entered_entity_counter,
uint32_t exited_entity_counter,
uint32_t rejected_incoming_transfer_counter,
uint32_t rejected_outgoing_transfer_counter
}
```
## メトリクスをリセットする
**ResetRuntimeMetrics** アプリケーション SDK は `AppRuntimeMetrics` struct 内の値をリセットします。
```
Result ResetRuntimeMetrics(Application& app) noexcept
```
次の例では、アプリケーション内での **ResetRuntimeMetrics** の呼び出し方法を示します。
```
if (ticks_since_last_report > 100)
{
auto metrics = WEAVERRUNTIME_EXPECT(Api::RuntimeMetrics(m_app));
Log::Info(metrics);
ticks_since_last_report = 0;
WEAVERRUNTIME_EXPECT(Api::ResetRuntimeMetrics(m_app));
}
```
## 制限の超過
アプリケーションの API コールが制限を超えると、エンティティ転送を除き、`ErrorCode::CapacityExceeded` が返されます。 SimSpace Weaver は**Commit** 操作および **BeginUpdate** アプリケーション API 操作の一部としてエンティティ転送を非同期的に処理するため、エンティティ転送の上限が原因で転送が失敗した場合にエラーを返す特定の操作はありません。転送の失敗を検出するには、 `rejected_incoming_transfer_counter` および `rejected_outgoing_transfer_counter` (`AppRuntimeMetrics` struct 内) の現在の値を以前の値と比較できます。拒否されたエンティティはパーティションには含まれませんが、アプリケーションではそのエンティティをシミュレートできます。
## メモリの不足
SimSpace Weaver はガベージコレクタープロセスを使用して、解放されたメモリをクリーンアップおよび解放します。ガベージコレクターがメモリを解放するよりも速くデータを書き込むことができます。この場合、書き込み操作がアプリケーションの予約メモリの制限を超える可能性があります。 SimSpace Weaver は `OutOfMemory` (および追加情報) を含むメッセージを含む内部エラーを返します。詳細については、「[書き込みを時系列に分散させる](#working-with_quotas_best-practices_spread-writes)」を参照してください。
## ベストプラクティス
以下のベストプラクティスは、制限を超えないようにアプリケーションを設計するための一般的なガイドラインです。特定のアプリケーションデザインには当てはまらない場合があります。
### 頻繁に監視し、速度を低下させる
メトリクスを頻繁に監視し、制限に近づいている処理は遅くする必要があります。
### サブスクリプション制限や転送制限の超過を避ける
可能であれば、リモートサブスクリプションとエンティティ転送の数を減らすようにシミュレーションを設計します。配置グループを使用して同じワーカーに複数のパーティションを配置し、ワーカー間のリモートエンティティ転送の必要性を減らすことができます。
### 書き込みを時系列に分散させる
ティック内の更新の数とサイズは、トランザクションのコミットに必要な時間とメモリに大きな影響を与える可能性があります。メモリ要件が大きいと、アプリケーションランタイムのメモリが不足する可能性があります。書き込みを時系列に分散させて、1 ティックあたりの更新の平均合計サイズを減らすことができます。これにより、パフォーマンスを向上させ、制限を超えないようにすることができます。各ティックに平均 12 MB、または各エンティティに平均 1.5 KB を超えて書き込まないことをお勧めします。