プロファイラーのアタッチ

この記事では、プロファイラーをアタッチする方法と、出力ファイルを取得する方法について説明します。プロファイラーは、ゲームサーバーのグラフィックスおよびパフォーマンスに関する問題をデバッグするために使用されます。dotnet trace や PIX などのツールを使用するには、まず使用するプロファイラーをアップロードする必要があります。次に、ビルドに関連付けると、出力ファイルがログフォルダーに保存されます。プロファイラーはパフォーマンスに影響を与える可能性があるため、運用ビルドへのアタッチは推奨されません。プロファイラーをアタッチする設定は、ビルド作成時に行う必要があります。現在、Game Manager 経由でのプロファイラーのアタッチはサポートされていないため、API を使用してビルドを作成する必要があります。詳細については、チュートリアル: PowerShell/API を使用したビルドのデプロイを参照してください。ビルドを作成する際、監視構成の下にアセット参照のフィールドがあります。監視構成にアセット参照を含めてください。アセットが Game Manager でアップロードされていることを確認してください。詳細については、ビルド概要のアセット管理を参照してください。 Linux サーバー用のプロファイラー実行スクリプトのサンプルを以下に示します。

Script

sighdl()
{
    #This is the folder the monitoring output should be written to.
    monitoring_folder_path = "${PF_MONITORING_LOG_FOLDER}"

    #Code to end monitoring and copy the output 

    exit 0
}

#set up the trap function to catch the signals and exit gracefully
trap sighdl SIGKILL SIGINT SIGTERM
sleep 3600

Windows サーバー用のプロファイラー実行スクリプトのサンプルを以下に示します。

#Sample function that checks for the sentinel file's existence in order to end.
function Check_Sentinel_File()
{
    $fullPath = $Env:PF_SENTINEL_FILE
    while(!(Test-Path $fullPath)) { Start-Sleep 10}

    #PF_MONITORING_LOG_FOLDER contains the log folder where the monitoring output should be saved
    
    $outputPath = "{0}/{1}" -f $Env:PF_MONITORING_LOG_FOLDER, "output.txt"
    "I've died!" | Out-File $outputPath 
}

Check_Sentinel_File

出力が確実に保存されるよう、PF_MONITORING_LOG_FOLDER 環境変数で設定されたフォルダー内に出力を保存するようにしてください。
サーバーがアーカイブされた後、ログをダウンロードできます。その中に PlayfabProfilingOutput というフォルダーがあり、実行スクリプトに記述した内容と、標準出力およびエラーが格納されています。

XBOX Services

PlayFab