> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights のベスト プラクティス

> PlayFab Insights のベスト プラクティスに従って、キャッシュ サイズの決定、パフォーマンス レベルの調整、効率的な Kusto クエリの実行を行い、よくある質問への回答も提供します。

# ベスト プラクティスと FAQ

ここでは、PlayFab Insights を使用する際のベスト プラクティスと、最もよくある質問について取り上げます。

<Note>
  PlayFab Insights Management は 2026/3/31 に廃止されました。今後のパフォーマンスとコストを管理するには、[Data Connections](/services/playfab/data-analytics/export-data/data-connection-adx) の使用をお勧めします。タイトルがまだ **Insights** を使用している場合は、ベスト プラクティスの詳細についてこの記事を参照し続けてください。詳細については、[PlayFab Digest: 3 月の機能更新](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/) を参照してください。
</Note>

## ベスト プラクティス

* 各パフォーマンス レベルには、一定量のキャッシュが付属しています。1 日あたりのデータ フットプリントを計算し、キャッシュに残しておきたい日数を決定するとよいでしょう。小さいバッファーまたは既知のデータ フットプリントを設けることで、クエリを実行する人が最適なパフォーマンスをいつ期待できるかを把握できます。その期待されるパフォーマンスに対して可視化を実行することも、迅速な結果を得るために推奨されます。
  * たとえば、スタジオのデータ フットプリントが 1 日あたり 5 GB である場合、キャッシュ サイズを 450+ に選択すると、キャッシュに 90 日分のデータを保持できます。90 日間の実行ウィンドウ内ですべての可視化を実行すると効率的です。結合、和集合、および高度なクエリも効率的になります。もう 1 つの選択肢としては、ライブ可視化を主に 30 日間のウィンドウに集中させ、業務時間中はキャッシュ サイズを 90 日間、業務時間外は 30 日間に設定することです。これによりコスト削減で大きな効率化が図れます。データはキャッシュ内で圧縮されることにも留意してください。
* Power BI のようなデータ可視化プラットフォームでは、1 つの可視化に対して複数のクエリを実行することがよくあります。可視化はシリアルに更新することを推奨します。負荷が高い場合や、多くのユーザーが使用している場合は、同時クエリの許容数が多いレベルにパフォーマンス レベルを上げて、外部ツールやアナリストのために同時実行クエリの枠を空けることが理にかなうかもしれません。
* スケジュール スケーリングの最も一般的な使用ケースは、通常業務時間中にスケール アップし、時間外や週末にスケール ダウンすることです。パフォーマンス レベルを大きく変更する場合 (例: レベル 3 から 8 へ)、より高いパフォーマンス レベルに数時間留まる意図を持つことをお勧めします。テラバイト単位のデータをキャッシュに素早く出し入れするのは、リソースの非効率な使用です。その他の制限はすべて即座に引き上げられるため、必要に応じてスケーリング変更を選択できます。
* スケジュール スケーリングは、手動スケーリングと相互に排他的ではありません。日中に追加のリソースが必要になった場合は、手動で変更できます。スケジュール スケーリングは想定どおり継続します。
* データ ストレージを削減すると、データ損失が発生する可能性があります。ストレージを削減しようとすると、「Selected retention setting is lower than current setting. Doing so may result in a loss of data.」というメッセージが警告として表示されます。ストレージのコストは低いため、長期リテンションが推奨されます。
* Insights の管理コマンドでは、カスタム テーブルの作成と更新が可能です。コア レポーティングや頻繁に使用されるテーブルには、カスタム集計テーブルを構築すると役立ちます。集計テーブルは通常、ソース データよりも小さなデータ フットプリントを持っています。これによりクエリ パフォーマンスが向上し、より高いパフォーマンス レベルの必要性が低減されます。
  * データ集計の自動化には、低コストでスケーラブルな自動化オプションである Azure Data Factory の使用をお勧めします。Azure Data Factory の使用に関する詳細は、[接続性](/services/playfab/data-analytics/legacy/connectivity) セクションを参照してください。
* タイムスタンプを使用してクエリを制限することは、良好なデータ管理の実践です。過去数日間のすべてのデータを一度に取得することはしないでください。

## FAQ

### データをクエリするにはどうすればよいですか?

1. 最も簡単な方法は、組み込みの [Data Explorer](/services/playfab/data-analytics/learn-data/data-explorer) を使用することです。
2. データにアクセスするその他の方法の詳細は、[接続性](/services/playfab/data-analytics/legacy/connectivity) セクションを参照してください。

### Microsoft 認証リンク (Azure Active Directory 使用) を送信しましたが機能しませんでした。何が起こったのですか?

* 既に PlayFab アカウントを持っている場合は、別の認証方法で招待を受け入れる前にサインアウトする必要があります。

### パフォーマンス レベルまたはデータ リテンションを変更しようとするとエラーが発生するのはなぜですか?

1. 有料アカウントに登録していない場合、パフォーマンス レベル、リテンション、エクスポート、および一部の管理コマンドの変更は利用できません。
2. Insights クラスターが現在パフォーマンス レベルを変更中の場合は、その変更が完了するまで待つ必要があります。

### 無料と有料のパフォーマンス レベルの間で変更できますか?

* もちろんです! 現在、有料機能を必要としない場合は、無料枠に戻すことができます。

### Insights クラスターにデータを取り込むにはどうすればよいですか?

1. ほとんどの PlayFab サービスは自動的にデータを生成します。
2. [PlayStream またはテレメトリ システムを通じて](/services/playfab/data-analytics/ingest-data/playstream-events) 独自のテレメトリを実装することもできます。
3. [管理コマンド](/services/playfab/data-analytics/legacy/insights/management-commands) を使用してカスタム データセットを取り込むこともできます。

### PlayFab イベントの標準データ スキーマは何ですか?

* PlayFab Insights では、すべてのイベントからのすべてのデータを 1 つのテーブルに読み込みます。このテーブルは \['events.all'] という名前です。そのテーブル内には「EventData」という列があり、各イベントの JSON 情報のペイロードが含まれています。events.all テーブルの詳細については、[events.all テーブルについて](/services/playfab/data-analytics/acting-data/schemas-events-all) を参照してください。

### なぜ SQL を書けないのですか?

* 現在、ほとんどのシナリオでは KQL (Kusto クエリ言語) クエリのみをサポートしています。SQL サポートの追加を積極的に検討しています。KQL には慣れが必要ですが、慣れたら気に入っていただけると思います。SQL を Kusto クエリに変換する情報については、[SQL to Kusto query translation](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/query/sqlcheatsheet) を参照してください。

### 私の Insights パフォーマンス レベルにおける Events Per Second と、PlayStream イベントの送信コストとの違いは何ですか?

* Insights パフォーマンス レベルにおける Events per second は、あらゆる手段でクラスターに取り込まれるデータを表します。PlayStream write events と write telemetry events は独立して課金され、クラウドへの書き込みのコストを表します。

### 管理ページに表示されているものよりも高いパフォーマンス レベルを利用できますか?

* 弊社に [サポート チケット](https://support.playfab.com/hc/requests/new) を提出してください。ニーズに合ったものを手配するためにご連絡いたします。

### PlayFab Insights の基盤となるテクノロジは何ですか?

* PlayFab Insights は、Azure Data Explorer (Kusto) の特殊な派生を使用しています。

### カスタム クエリを使用してエクスポートする場合、データ スキーマが異なるのはなぜですか?

* カスタム クエリの出力には、ETL (Extract Transform Load) プロセスの詳細が含まれます。追加の列がいくつか含まれています。これらの列は、目的を持たないため、クエリ環境では非表示になっています。

### リテンション設定を、データを保持している合計日数より少ない日数に減らすとどうなりますか?

* リテンションを減らすとデータを削除する可能性があると警告されます。たとえば、1 年間運用してリテンションを 6 か月に減らすと、最新の 6 か月分のデータのみが保存され、それ以外は破棄されます。

### クエリのタイムアウト時間を増やすにはどうすればよいですか?

* クエリのタイムアウト制限は、パフォーマンス レベルで定義されているコンピューティング能力に相対的です。[パフォーマンスとリテンション](/services/playfab/data-analytics/legacy/insights/performance-retention) のコンピューティング能力の下にあるコンピューティング能力表を参照してください。

### 送信できるテレメトリの量に制限はありますか?

* [WriteTelemetryEvents](xref:titleid.playfabapi.com.events.playstreamevents.writetelemetryevents) API 呼び出しには次の制限があります:
  | 制限名                                                                                                    | 制限値                 | 備考                                                                                                      |
  | ------------------------------------------------------------------------------------------------------ | ------------------- | ------------------------------------------------------------------------------------------------------- |
  | 1 リクエストあたりのイベント数                                                                                       | 1 リクエストあたり 200 イベント | この制限を超えると `BadRequest` エラーが発生します。                                                                       |
  | エンティティあたりのイベント数                                                                                        | 1 秒あたり 8,000        | この制限を超えると `PerEntityEventRateLimitExceeded` エラーが発生します。エンティティは通常、個々のプレイヤーを表しますが、プレイヤー グループやタイトルの場合もあります。 |
  | 最大ペイロード サイズ                                                                                            | 10,240 バイト (10 KB)  |                                                                                                         |
  | これらの制限のいずれかに達した場合は、PlayFab サポート チームにお問い合わせください。Game Manager の右上隅で疑問符アイコンを選択し、**\[Contact Us]** を選択します。 |                     |                                                                                                         |

### クエリを実行しようとすると「Query execution has exceeded the allowed limits」というエラーが表示されます

* このエラーは、結果セットのサイズまたは結果セット内の行数が許可された制限を超えた場合に発生します。*where*、*limit*、または *summarize* 演算子を使用して関連データにクエリの範囲を絞り、返されるデータ量を制限してみてください。
* すべてのデータをエクスポートするには、PlayFab Game Manager の **タイトル概要** ページの **\[Data]** の下の **\[Event Export]** タブに移動します。
* データのセグメントのみを取得したい場合や、クエリ制限に達している場合は、時刻または一意の ID (例: Player ID、Title ID) でデータをパーティション分割し、より小さなクエリを複数実行できます。以下は、時刻に基づいてパーティション分割する例です:

Where

```sql theme={null}
let start = datetime(2020-08-03);
let end = datetime(2020-08-07);
['events.all'] | where Timestamp between(start .. end)
```

Limit

```sql theme={null}
['events.all'] | limit 1000
```

Summarize

```sql theme={null}
['events.all'] | summarize count() by FullName_Name, bin(Timestamp, 1d)
```

* 詳細については、[Kusto ドキュメント](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/concepts/querylimits) を参照してください。

### truncationmaxsize および truncationmaxrecords 変数をより大きな値に設定しましたが、まだエラーが表示されます

* PlayFab Insights は現在、これらの変数の設定をサポートしていません。クエリの作成に関するヒントについては、上記を参照してください。

### Insights データをクエリすると、イベントの取り込みが妨げられますか?

* いいえ。PlayFab イベントは、パフォーマンス
* 上のペナルティなしでタイトルのデータベースに流入します。

### クエリで「Partial query failure: Low memory condition」エラーが返されます

* これは、クエリが複雑すぎて、パフォーマンス レベルのメモリ制限に収まらないことを意味します。クエリを簡素化してみてください。たとえば、summarize 呼び出しに含まれるグループが多すぎるか、一度に処理する行数が多すぎるかもしれません。パフォーマンス レベルをアップグレードして、各クエリに割り当てられるメモリを増やすこともできます。
* 詳細については、[Kusto ドキュメント](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/concepts/partialqueryfailures) を参照してください。

### パフォーマンス レベルで許可されている量を超えるイベント量がある場合、データを失いますか?

* いいえ。ただし、超過分に対して課金されます。超過は消費された Insights Credits の数で測定されます。Insights Credit の価格は [PlayFab.com/Pricing](https://playfab.com/pricing/) にあります。

### パフォーマンス レベルはどのように決定すればよいですか?

* 適切なパフォーマンス レベルは、タイトルの使用状況によって最もよく決定されます。パフォーマンス レベルを上げることで、キャッシュ内のより多くのデータやその他のクエリ リソースにアクセスできるようになり、クエリの実行が高速化されます。詳細については、パフォーマンス レベルについて詳しく学ぶために [パフォーマンス レベルとリテンション](/services/playfab/data-analytics/legacy/insights/performance-retention) を参照してください。

## 特定のタイトルの \[Data > Explorer] ページにユーザーの権限を付与するにはどうすればよいですか?

* ユーザー権限へのアクセス、作成、および付与には、[PlayFab ユーザー ロール](/services/playfab/identity/dev-identity/permissions/playfab-user-roles) ガイドに従ってください。
* Data Explorer にアクセスするには、次の 3 つの権限が必要です:
  * Explorer data & tab (読み取りおよび書き込み権限)
  * Analytics data read access (読み取り権限)
  * Analytics data write access (書き込み権限)


## Related topics

- [PlayFab 消費量のベストプラクティス](/ja-jp/services/playfab/pricing/consumption-best-practices.md)
- [ベスト プラクティス](/ja-jp/services/xbox-services/develop/best-practices/index.md)
- [コンテンツ更新のベスト プラクティス](/ja-jp/build/core-features/common/packaging/packaging-updates.md)
- [RTA サービスのベスト プラクティス](/ja-jp/services/xbox-services/fundamentals/rta/concepts/live-rta-best-practices.md)
- [SDK エラー処理のベスト プラクティス](/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/sdk-error-handling-best-practices.md)