メモリストレージの可観測性ダッシュボードは、メモリ使用量とAPIリクエストに関するリアルタイムのチャートを提供します。また、問題が発生した際にメールで通知する組み込みのアラートシステムも搭載されており、同期してトラブルシューティングを助けます。特定のエラーに関する詳細な情報については、ご自身のエラーレポートを確認して、エラーログを見つけることができます。
ダッシュボードにアクセスする
メモリストレージの可観測性ダッシュボードは、MemoryStoreServiceを使用するすべてのゲームで利用可能ですが、ダッシュボードにアクセスするにはゲームのオーナーであるか、分析グループの権限を持っている必要があります。
ダッシュボードにアクセスするには：
- クリエイターダッシュボードのクリエイションページに移動します。
- 左上のアカウントスイッチャーを展開し、ターゲットゲームを所有するアカウントまたはグループを選択します。
- ゲームを選択します。
- モニタリングのドロップダウンで、メモリストレージを選択します。
利用可能なチャート
ダッシュボードには2つのカテゴリの折れ線グラフが含まれています：
- クォータ使用量チャートは、ゲーム内のユーザー数に基づいて計算された動的割り当てクォータに対する使用状況を追跡します。
- メモリ使用量は、メモリ使用量をバイト単位で示し、割り当てられたクォータがどれだけ残っているかを比較します。
- APIリクエストユニットは、1分あたりの総リクエストユニットが割り当てられたクォータがどれだけ残っているかを比較します。このチャートは、各APIメソッドごとに分解できます。
- API使用量とパフォーマンスチャートは、APIメソッドとレスポンスステータスに基づくAPI使用パターンとパフォーマンスを監視します。
- APIごとのリクエスト数は、APIメソッドごとの1分あたりのAPIリクエスト数を示します。例えば、MemoryStoreQueue:ReadAsync()やMemoryStoreSortedMap:UpdateAsync()など。
- ステータスごとのリクエスト数は、レスポンスステータスごとのAPIリクエスト数を示します。
- API×ステータスごとのリクエストは、すべてまたは特定のAPIメソッドから返されるレスポンスステータスを示します。
チャートには過去30日間のデータが含まれており、ページ上部のセレクターでカスタム時間範囲を選択できます。30日より前の時間範囲を選択すると、システムはリクエスト失敗エラーを返します。
レスポンスステータスコード
可観測性ダッシュボードのステータスごとのリクエスト数およびAPI×ステータスごとのリクエストチャートには、エラーを理解しトラブルシューティングするために使用できるAPIレスポンスのステータスコードが含まれています。これらのステータスコードの一覧と説明を示す表については、可観測性を参照してください。また、これらのエラーを解決する方法や、エラーに関連する特定のクォータや制限に関する情報については、トラブルシューティングおよび制限とクォータをそれぞれ参照してください。
通知アラート
メールアラートシステムは、自動的にメモリストレージ使用の問題を検出し、ゲームのパフォーマンスに影響を与える可能性がある場合にアラートを送信します。アラートには2つのタイプがあります：
- 警告は、ゲームに潜在的に影響を与える問題についての低優先度のアラートです。これらの問題が重大な問題になる前に解決するべきです。ダッシュボードは、黄色で警告メッセージを表示してこれらのアラートを強調表示します。
- クリティカルは、ゲームに直接影響を与える問題についての高優先度のアラートです。パフォーマンスが低下しないよう、これらの問題をできるだけ早く解決すべきです。ダッシュボードは、赤でエラーメッセージを表示してこれらのアラートを強調表示します。
ゲームが同時に2種類のアラートをトリガーすると、ダッシュボードはアラートヘッダーメッセージを表示し、重要性を強調するためにチャート領域をクリティカルとして強調表示します。
現在、システムにはメモリ使用量とAPIリクエストのための4つの組み込みアラートがあります。ゲームがアラートしきい値を超えると、システムは各アラートにつき最大1日1回通知します。メールアラートが届いたら、ダッシュボードを確認してパフォーマンス低下を防ぐための対策を講じるべきです。
メモリ使用量アラート
システムは次のメモリ使用量アラートを送信します：
ゲームのメモリ使用量が過去1時間の総クォータの70％を超えた場合の警告アラート。
ゲームが過去1時間でメモリサイズのクォータを超えた場合のクリティカルアラート。
これらの問題は、メモリストレージデータ構造にデータが多すぎると発生することが多く、数少ないキーに対してリクエストを送信するだけでもクォータを迅速に消費する可能性があります。たとえば、キーに長い有効期限を設定したり、処理済みデータをクリーンアップしなかったりすると、余分なデータがメモリクォータを満たすことがあります。
これらの問題を防ぎ、解決するために、ベストプラクティスを適用し、積極的に使用しているデータ構造を把握し、処理済みデータのクリーンアップメカニズムを設定してください。
APIリクエストアラート
システムは次のAPIリクエストアラートを送信します：
メモリストレージのリクエスト失敗の数が過去1時間で20％を超えた場合のクリティカルアラート。
過去1時間のメモリストレージリクエストの10％を超えるリクエストが制限されている場合のクリティカルアラート。
- このアラートは、DataStructureRequestsOverLimit + TotalRequestsOverLimitの数に基づいており、あなたのゲームがリクエストを送りすぎたために制限されていることを示すエラー応答です。
- このアラートはリクエストサイズではなく、数量に関連しています。
すべてのAPIリクエストには対応するレスポンスステータスコードがあるため、ステータスごとのリクエスト数チャートを使用して、成功応答の割合とすべてのエラー応答の割合を確認することができます。