Télécharger les données de profil
Ce document explique comment télécharger les données de votre profil sur votre système local et comment les récupérer de manière programmatique à l'aide d'une application Go.
Télécharger des profils à l'aide de la console Google Cloud
Pour télécharger le profil affiché dans le graphique de type "flamme", cliquez sur Télécharger get_app.
Profiler utilise la convention d'attribution de noms suivante pour le fichier téléchargé :
profiler_[SERVICE_NAME]_[PROFILE_TYPE]_[FROM_DATE]_[TO_DATE]_[ZONE]_[VERSION].pb.gz
Dans cette expression :
SERVICE_NAME
correspond au service sélectionné ;PROFILE_TYPE
contient le type de profil sélectionné ;FROM_DATE
etTO_DATE
sont remplacés par les informations de la période d'affichage spécifiées ;ZONE
contient la zone sélectionnée ;VERSION
correspond à la version sélectionnée.
Exemple : profiler_docdemo-service_HEAP_2018-04-22T20_25_31Z_2018-05-22T20_25_31Z_us-east1-c.pb.gz
Télécharger des profils de manière programmatique
Pour récupérer les données de profil, utilisez la méthode d'API ListProfiles
. L'exemple de programme Go suivant illustre l'utilisation de cette API.
L'exemple de programme crée un dossier dans le répertoire à partir duquel il est exécuté et génère un ensemble de fichiers pprof
numérotés. Chaque fichier suit une convention de dénomination semblable à profile000042.pb.gz
. Chaque répertoire contient des données de profil et un fichier de métadonnées (metadata.csv
) qui contient des informations sur les fichiers téléchargés.
Le programme d'exemple accepte les arguments de ligne de commande suivants :
project
: projet à partir duquel les profils sont récupérés. Obligatoire.page_size
: nombre maximal de profils récupérés par appel d'API. La valeur maximale depage_size
est de 1 000. Si ce champ n'est pas spécifié, il est défini sur 100.page_token
: jeton de chaîne généré par une exécution précédente du programme pour reprendre les téléchargements. Facultatif.max_profiles
: nombre maximal de profils à récupérer. Si un entier non positif est fourni, le programme tente de récupérer tous les profils.
Facultatif.
Exécuter l'exemple d'application
Pour exécuter l'exemple d'application, procédez comme suit :
Clonez le dépôt :
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
Accédez au répertoire qui contient l'exemple de programme :
cd golang-samples/profiler/export
Exécutez le programme après avoir remplacé YOUR_GCP_PROJECT par l'ID de votre projetGoogle Cloud :
go run main.go -project YOUR_GCP_PROJECT -page_size 1000 -max_profiles 10000
L'exécution du programme peut prendre un certain temps. Le programme génère un jeton pour la page suivante après avoir récupéré la page actuelle. Vous pouvez utiliser le jeton pour reprendre le processus si le programme est interrompu.
Afficher les profils téléchargés
Pour lire un fichier téléchargé, qui est écrit au format tampon de protocole sérialisé, utilisez l'outil Open Source pprof
.