Monitor and Troubleshoot a Dedicated Server
Armada はまだ AGS Starter ティアではご利用いただけません。まもなく提供を開始します。
概要
ゲームの開発中は、専用サーバーを使用すると問題が発生します。このセクションでは、ゲームサーバーをできるだけ素早くデバッグする方法について説明します。
さらに、ゲームが本稼働に入ると、各リージョンで実行中の専用サーバーすべての本稼働ステータスを確認する必要があります。また、本稼働中でも非アクティブでも、すべての専用サーバーの健全性をモニタリングする必要があります。
このガイドでは、デバッグとモニタリングのために利用できるツールの概要を説明します。
目標
このガイドを完了すると、次のことができるようになります。
- 管理者ポータルを使用して、サーバー全体のステータスを確認する。
- 管理者ポータルを使用して、リージョナルサーバーのステータスを確認する。
- 本稼働専用サーバーを見つけて調べる。
- トラブルシューティングとデバッグのために、専用サーバーの本稼働ログにアクセスする。
- 過去の専用サーバーを見つけて調べる。
- 専用サーバー割り当てイベントとサーバーステータスを見つけて理解する。
- 専用サーバーログとアーティファクトファイルを過去のサーバーエントリーからダウンロードする。
前提条件
このガイドを読む前に、次のことを行う必要があります。
- 専用サーバーと AccelByte Server SDK を統合する。
- ゲームアセットの読み込みが完了した後に、Armada に登録できる専用サーバーを作成する。
- ゲームの管理者ポータルと名前空間にアクセスする。
- 専用サーバーを Armada にアップロードする。
- Armada 環境の設定を完了する。
- デプロイメントを作成する。
モニタリングダッシュボードのツアー
モニタリングダッシュボードを開くには、サイドバーの［Dedicated Server Management (専用サーバー管理)］セクションを見つけ、［Server (サーバー)］ボタンをクリックします。
モニタリングダッシュボードは、次のページにあります。
このダッシュボードに表示されるステータスは、名前空間が必要とするすべてのアクティブなデプロイメントの組み合わせです。
1：ローカルサーバー
ダッシュボードのこのセクションには、ローカルで接続されている専用サーバーの数が表示されます。数字の横にある矢印ボタンをクリックすると、Armada に接続されているローカルの専用サーバーのリストを表示して管理できます。ローカルでの専用サーバーのデバッグ.を参照してください。
2：サーバーの概要
このセクションには、Armada が管理する専用サーバーの数が示されます。数字の横にある矢印ボタンをクリックすると、Armada に管理されている専用サーバーのリストを表示して管理できます。これはダッシュボードで最もよく使用されるセクションであり、Armada サーバーの概要で後述します。
3：利用可能なリージョン
このセクションには、Armada に登録されているリージョンの数が示されます。数字の横にある矢印ボタンをクリックすると、リージョンのリストを表示して管理できます。
1：QoS サーバーのステータス
QoS サーバーの詳細情報に加えて、トグルボタンを使用してサーバーの可用性を切り替えることができます。
リージョンを無効にすると、そのリージョンで追加の専用サーバーがスピンアップしなくなり、すべての［"Ready" (「準備完了」)］サーバーが削除されます。実行中の［"Busy" (「ビジー」)］専用サーバーは影響を受けません。
2：リージョンリスト
リスト内のリージョンをクリックすると、リージョンごとに仮想マシンプロバイダーを詳しく見ることができます。
4：すべてのセッション
このセクションには、すべてのアクティブなセッションが表示されます。数字の横にある矢印ボタンをクリックすると、セッションを表示して管理できます。
5：ワールドマップ
このセクションには利用可能なすべてのリージョンが表示されます。リージョンのマーカーをクリックすると、詳細なリージョンステータスが表示されます。
6：リージョン情報
このセクションでは、名前空間内のすべてのデプロイメントに関する、専用サーバーのリージョンステータスが表示されます (リージョン内の QoS サーバーに関する詳細情報を含む)。
Armada サーバーの概要
モニタリングダッシュボードの サーバーの概要 セクションで矢印ボタンをクリックすると、サーバーリストページに移動し、割り当てられたすべての専用サーバーの詳細が表示されます。
リージョンフィルター：このドロップダウンボックスを使用して、リージョン別に専用サーバーをフィルタリングします。
専用サーバーエントリー：専用サーバーの重要な情報を表示します。
専用サーバーの Pod 名は、その一意の識別子です。
更新ボタン：ページ内のデータを更新します。
アクションボタン：アクションメニューを開きます。利用可能なアクションは［View (表示)］と［Delete (削除)］です。
一時的なサーバー
Armada の需要が高まっているか、一時的なリソースが枯渇している場合は、サフィックス "-temp" が付いた一時的なエントリーが表示されることがあります。これらの一時エントリーは、リソースに実行されるのを待っている割り当てジョブのプレースホルダーです。したがって、これらの一時的なエントリーには、Pod 名も、サーバー IP も、利用可能なポートもありません。
専用サーバーの表示
このページには、選択した専用サーバーの詳細情報が含まれています。このページにアクセスするには、専用サーバーエントリーで［"View" (「表示」)］アクションを使用します。
［Details (詳細)］：専用サーバーの詳細情報が含まれています。
［Ports (ポート)］：外部ポート (ゲームクライアントが接続するポート) のリストが、専用サーバーがリッスンするそれぞれのポートにポート転送されます。
［Status history (ステータス履歴)］と割り当てイベント：専用サーバーの状態変化履歴、およびオーケストレーターからの割り当てイベントを確認できます。この情報は、専用サーバーのトラブルシューティングに役立ちます。
［Details (詳細)］タブと［Logs (ログ)］タブ：これらのタブボタンを使用して、［Details (詳細)］タブと本稼働ログのタブにアクセスします。
履歴ログボタン：このボタンを使用して、サーバーセッションの履歴ログにリダイレクトし、専用サーバーログとアーティファクトファイルをダウンロードできます。
専用サーバーのトラブルシューティングを行うには、サーバーステータスと割り当てイベントのさまざまな意味を理解することが重要です。
専用サーバーステータス
Armada は専用サーバーのステータスを追跡します。詳細については、専用サーバーのライフサイクルを参照してください。
| ステータス | 説明 |
|---|---|
| ［Creating (作成中)］ | サーバーがゲームセッションのワークロードを処理するためにリソースを準備しているとき、サーバーが RegisterServerToDSM API を呼び出して Armada への準備が整ったことを確認すると、［Ready (準備完了)］に変化します。このステータスの直後に［Removing (削除中)］ステータスが表示されると、専用サーバーがクラッシュしている可能性があります。割り当てイベントをさらに調べると、終了したイベントでゼロ以外の終了コードを確認できます。あるいは、このステータスの後で履歴ログに他に何も表示されない場合、サーバーは作成のタイムアウトによってシャットダウンされている可能性があります。その場合、割り当てイベントをさらに調べて、サーバーが起動状態になる前に強制終了状態になっていないかを確認します。もう1つの一般的な原因として、サーバーが作成のタイムアウトに達したときにまだダウンロード中である場合が挙げられます。この場合、Docker イメージのプル進行状況が 8/8 に達していないことをドライバーの状態で確認できます。以下の画像を参照してください。 |
| ［Ready (準備完了)］ | サーバーはロックされ、ゲームセッションのワークロードを処理するためにロードされ、マッチメイカーまたはカスタムサービスがサーバーを要求すると［Busy (ビジー)］に変更されます。 |
| ［Busy (ビジー)］ | サーバーはゲームセッションのワークロードを処理しています。 |
| ［Unreachable (到達不可)］ | サーバーは Armada との接続を失い、Armada がサーバーを削除しました。 |
| ［Removing (削除中)］ | サーバーは Armada によって削除されています。また、サーバーが問題なく終了したか、強制終了されたか、いずれかのタイムアウトによって削除されたかを問わず、サーバーが削除された理由を確認できます。 |
割り当てイベント
オーケストレーターがアクションを実行して、仮想マシン上に専用サーバーを物理的に割り当てると、割り当てイベントが生成されます。
| イベント | 説明 |
|---|---|
Received | Armada がリクエストを受け取り、新しい専用サーバーをスピンアップしたときに発動します。 |
Task Setup | Armada が新しい専用サーバーにリソースを割り当てているときに発動します。 |
Driver | 専用サーバーコンテナが初期化されると発動します。サーバーが仮想マシンで初めて実行される場合は、専用サーバーのダウンロードステータスも表示されます。 |
Started | コンテナの初期化が完了し、サーバーバイナリの実行を開始したときに発動します。 |
Signaling | 専用サーバーが Armada からシグナルを受け取ると発動します。シグナルは通常、終了シグナルです。 |
Terminated | 専用サーバーが終了すると発動します。専用サーバーの終了コードを確認して、エラーが発生したかどうかを確認することもできます。 |
Killing | コンテナが強制終了され、使用されていたリソースが Armada に戻されると発動します。 |
本稼働ログ
本稼働ログを使用すると、デベロッパーは専用サーバーがプレイヤーのアクションにどのように反応したかを確認できるため、本稼働トラブルシューティングがはるかに簡単になります。本稼働ログにアクセスするには、［Logs (ログ)］タブをクリックしてください。
stdout と stderr のログは別々に保存されます。
各更新から取得される文字数です。取得する文字数が多いほど、応答が遅くなります。
ログを簡単に見つけるために提供されるシンプルな検索機能です。
［Refresh (更新)］ボタンを押すと、ログ表示が更新されます。
履歴ログ
専用サーバーで問題が発生し、それらに気付いたときに、専用サーバーがシャットダウンすることがあります。Armada は最大 30 日間、サーバーの詳細とログを保持するため、ユーザーは問題のトラブルシューティングを行う時間を確保できます。
検索バー：検索する専用サーバーに関連付けられているマッチ ID、パーティ ID、Pod 名のいずれかを把握している場合は、この検索バーを使用してサーバーエントリーを検索します。
フィルター：または、このボタンをクリックして検索結果にフィルターを適用することもできます。利用可能なフィルターオプションには、サーバーの［deployment name (デプロイメント名)］、［start date (開始日)］、［end date (終了日)］があります。
必要なサーバーエントリーを見つけたら、エントリーの［view (表示)］ボタンをクリックして詳細にアクセスしてください。
履歴サーバーの詳細ページは、本稼働サーバーの詳細ページと非常によく似ていますが、本稼働ログが使用できなくなりました。ただし、ページの右上隅にあるそれぞれのボタンをクリックすると、長期ストレージから専用サーバーログとアーティファクトファイルをダウンロードできます。
最新の専用サーバーログを長期ストレージで更新するには 15 分かかります。
アーティファクトファイルは、専用サーバーが削除されてから 15 分後に使用できるようになります。
トラブルシューティング
このセクションには、サービス使用時に発生しうる一般的なエラーや問題、およびそれらを解決する方法についての推奨事項を記載しています。
サーバーが作成中、長時間スタックする
この問題の原因として考えられるものがいくつかあります。
仮想マシンは専用サーバーイメージをダウンロードしています。サーバーイメージが十分大きい場合、仮想マシンがダウンロードを完了するまでに数分かかることがあります。［"allocation events" (「割り当てイベント」)］でダウンロード状況を追跡できます。
専用サーバーが Armada に登録できない可能性があります。専用サーバーログをチェックして、リクエストが適切に応答したかどうかを確認します。
お使いの環境では、専用サーバーを実行するための仮想マシンリソースが不足している可能性があります。一時サーバーエントリーが表示され、対応する Pod 名のエントリーがない場合に、この問題が発生することがあります。
ログ/アーティファクトファイルがダウンロードできない
15 分間待機して、ファイルを長期ストレージに移動させます。この問題が解決しない場合は、デベロッパーパートナーマネージャーにお問い合わせください。