Attacher un profileur

Cet article explique comment attacher un profileur et récupérer les fichiers de sortie. Un profileur permet de déboguer les problèmes de graphismes et de performances de vos serveurs de jeu. Pour utiliser des outils tels que dotnet trace ou PIX, vous devez d’abord téléverser le profileur de votre choix. Vous l’associez ensuite à une build, et les fichiers de sortie sont placés dans votre dossier de journaux. Il n’est pas recommandé d’attacher un profileur aux builds de production, car cela peut affecter les performances. La configuration nécessaire pour attacher un profileur doit être effectuée lors de la création de la build. Nous ne prenons actuellement pas en charge l’attachement d’un profileur au moyen de Game Manager; vous devez donc créer une build à l’aide de nos API. Pour plus d’informations, consultez Procédure pas à pas : déployer des builds à l’aide de PowerShell/de l’API. Lors de la création d’une build, un champ de référence d’actif est disponible dans la configuration de supervision. Incluez la référence d’actif dans la configuration de supervision. Assurez-vous que votre actif est téléversée dans Game Manager. Pour en savoir plus, consultez Gérer les actifs dans la vue d’ensemble des builds. Pour un serveur Linux, voici un exemple de script d’exécution pour le profileur.

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

Pour un serveur Windows, voici un exemple de script d’exécution pour le profileur.

#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

Assurez-vous d’enregistrer votre sortie dans le dossier défini par la variable d’environnement PF_MONITORING_LOG_FOLDER, afin de garantir son enregistrement.
Une fois le serveur archivé, vous pouvez télécharger les journaux; vous y trouverez un dossier appelé PlayfabProfilingOutput. Il contiendra ce que vous avez écrit dans votre script d’exécution, ainsi que toutes les sorties et erreurs standard.

XBOX Services

PlayFab