専用サーバーのログとアーティファクトを表示および管理する
注釈：本資料はAI技術を用いて翻訳されています。
はじめに
AccelByte Gaming Services（AGS）管理者ポータルのAccelByte Multiplayer Servers（AMS）ログとアーティファクトコンポーネントは、専用サーバーのログにアクセスする2つの方法を提供します。
- ライブログ：現在実行中の専用サーバーからリアルタイムのログを表示
- 収集されたアーティファクト：終了した専用サーバーからログやその他のアーティファクトをダウンロード
- AMSは、専用サーバーによって生成されたすべてのファイルをアーティファクトと呼びます。
- AMSは現在、ログ、コアダンプ、および専用サーバーが
${artifact_path}に出力するカスタムアーティファクトをサポートしています。
この記事では、以下の方法について説明します。
- 実行中の専用サーバーからライブログを表示する
- AccelByte管理者ポータルで収集されたアーティファクトを表示、ダウンロード、削除する
- アーティファクトの使用状況とストレージ制限を監視する
前提条件
このガイドを開始する前に、以下を完了している必要があります。
- AccelByte管理者ポータルでゲームのネームスペースとアカウントへのアクセス権を持っている
- AGS Server SDKと専用サーバーを統合している
- 専用サーバービルドをAMSにアップロードしている
ライブログ
専用サーバーが実行中の間、管理者ポータルを通じてそのログのストリームにリアルタイムでアクセスできます。表示するには、専用サーバーの詳細ページに移動し、「Logs」タブを選択します。ライブログは現在実行中の専用サーバーでのみ利用可能であることに注意してください。サーバーが終了またはクラッシュすると、そのログにアクセスするにはアーティファクト収集システムを使用する必要があります。
実装ミスにより専用サーバーがAMS（Watchdog）に全く接続しない場合、これらのライブログは利用できません。その場合は、まずAMS Simulatorをローカルで使用して、専用サーバーがAMSに接続することをテストしてください。
フリート設定
フリートを設定するには、専用サーバー割り当てを管理するフリートを作成の記事のステップ12を参照してください。
設定したい既存のフリートがある場合は、サンプリングルールを変更する前に無効化し、その後再度有効化してアーティファクトの収集を開始する必要があります。
アーティファクトを表示する
ログとアーティファクトページでアーティファクトを表示および管理できます。ログとアーティファクトページに移動するには、サイドバーのAccelByte Multiplayer Servers > Logs and Artifactsをクリックします。
ページのリストには、ネームスペース内のすべてのフリートのアーティファクト収集レコードが表示されます。
アーティファクト収集レコードは、以下のいずれかのステータスを持つことができます。
Success：アーティファクトが収集され、ダウンロード可能です。Skipped：サンプリングルールのため、アーティファクトは収集されませんでした。Failed：アーティファクトの収集を試みる際にエラーが発生しました。
デフォルトでは、アーティファクトは収集された時点から30日間保持されます。
検索バーを使用して、特定のフリート、イメージ、または専用サーバーのアーティファクトを検索できます。リストは、タイプ、ステータス、日付範囲、サイズでフィルタリングすることもできます。
各行を展開して、アーティファクトの詳細を表示できます。
また、専用サーバーの詳細ページに移動し、右上のView Logs & Artifactsボタンをクリックすることで、特定の専用サーバーのアーティファクトを表示することもできます。
アーティファクトをダウンロードする
アーティファクトは1つずつまたは一括でダウンロードできます。単一のアーティファクトをダウンロードするには、対応するDownloadボタンをクリックします。複数のアーティファクトを一度にダウンロードするには、ダウンロードしたいアーティファクトのチェックボックスをクリックし、リストの上部にあるDownloadボタンをクリックします。
アーティファクトを削除する
アーティファクトを削除すると、リストから削除され、該当する場合はストレージからファイルが削除されます。この操作は元に戻すことができません。
アーティファクトを削除するには、対応するDeleteボタンをクリックします。複数のアーティファクトを削除するには、左側の対応するチェックボックスを選択し、リストの上部にあるDeleteボタンをクリックします。
アーティファクトを削除しても、現在の月間使用量には影響しません。
ログとアーティファクトの使用状況を監視する
現在のログとアーティファクトの使用状況とクォータは、リストページのLogs and Artifacts Quotaセクションに表示されます。AMSは定期的にスキャンし、30日以上経過したログとアーティファクトを削除します。
よくある質問（FAQ）
ログとアーティファクトページにアーティファクトが表示されないのはなぜですか？
アーティファクトは、専用サーバーが終了し、サンプリングルールが満たされた場合にのみ収集されます。アーティファクトが表示されない場合は、以下を確認してください。
- サンプリングルールが正しく設定されていることを確認してください。サンプリングルールがアクティブでない場合、アーティファクトは収集されず、ログとアーティファクトにレコードは表示されません。
- 専用サーバーが期待されるステータスで終了していることを確認してください。専用サーバーが期待されるステータスで終了していない場合、アーティファクトは収集されず、ログとアーティファクトにレコードは表示されません。
アーティファクトはいつ収集されますか？
アーティファクトは、専用サーバーが終了し、サンプリングルールが満たされたときに収集されます。
アーティファクトはどのくらいの期間保存されますか？
アーティファクトは30日間、または手動で削除されるまでのいずれか早い方まで保存されます。自動的に削除されたアーティファクトは、追跡目的でログとアーティファクトページに引き続き表示されますが、ダウンロードはできません。
ストレージ制限に達するとどうなりますか？
使用制限は現在強制されておらず、情報提供のみを目的として表示されています。これは将来変更される可能性があります。
サンプリングルールを約50%に設定していますが、アーティファクトの半分以上（または半分未満）が収集されています。なぜですか？
サンプリングルールの値は、専用サーバーが終了したときにアーティファクトを収集する確率のパーセンテージです。実際に収集されるアーティファクトの数は変動しますが、時間の経過とともに設定された値に近づくはずです。
Unreal Engineのsavedフォルダ配下のアーティファクトを収集するにはどうすればよいですか？
フリート設定にDSコマンドラインパラメータ-UserDir=${artifact_path}を追加します。これにより、Unreal Engineのデフォルトのsavedフォルダがアーティファクト収集パスに上書きされます。
用語集
- アーティファクト収集レコード：アーティファクト収集の試行の記録。ステータスと、収集された場合はアーティファクトが含まれます。
- アーティファクト：ゲームサーバーによって生成され、収集可能なファイル。AMSは現在、ログ、コアダンプ、およびカスタムアーティファクトをサポートしています。
- サンプリングルール：アーティファクトを収集するタイミングを決定するルール。各ルールは、特定のフリート、アーティファクトタイプ、および専用サーバーの終了ステータスに対して定義されます。各ルールの値は、収集するアーティファクトのパーセンテージです。