Rassemblez des informations de diagnostic sur les performances de la charge de travail SAP

Ce guide vous explique comment collecter des informations de diagnostic sur les performances de vos charges de travail SAP à l'aide de l'agent Google Cloud pour SAP, version 3.4 ou ultérieure.

Lorsque vous contactez Cloud Customer Care pour obtenir de l'aide afin de résoudre un problème de performances lié à votre charge de travail SAP, vous devez partager des informations de diagnostic pertinentes sur votre charge de travail. En utilisant l'outil de diagnostic des performances intégré de l'agent, vous pouvez automatiser la collecte des informations de diagnostic nécessaires, ce qui peut vous aider à accélérer le dépannage et la résolution des problèmes.

Pour en savoir plus sur les diagnostics de performances que l'agent peut exécuter pour vos charges de travail SAP, consultez la section Diagnostic des performances des charges de travail.

Avant de commencer

Assurez-vous d'utiliser la version 3.4 ou une version ultérieure de l'agent Google Cloud pour SAP.

Pour savoir comment vérifier et mettre à jour l'agent, consultez la section Mettre à jour l'agent Google Cloud pour SAP.

Recueillir des informations de diagnostic sur les performances

Pour collecter des informations de diagnostic des performances de votre charge de travail SAP, appelez l'outil de l'agent à l'aide de la commande performancediagnostics :

sudo /usr/bin/google_cloud_sap_agent performancediagnostics \
    --type="COMMA_SEPARATED_DIAGNOSTIC_TYPES" \
    --test-bucket=STORAGE_BUCKET_NAME \
    --backint-config-file=BACKINT_CONFIG_FILE_PATH \
    --output-file-name=OUTPUT_FILE_NAME \
    --output-file-path=OUTPUT_FILE_PATH

Remplacez les éléments suivants :

COMMA_SEPARATED_DIAGNOSTIC_TYPES : types de diagnostic que vous souhaitez exécuter.
STORAGE_BUCKET_NAME : nom du bucket Cloud Storage que l'outil doit utiliser pour exécuter les diagnostics backup.
BACKINT_CONFIG_FILE_PATH : chemin d'accès au fichier de configuration Backint requis.
OUTPUT_FILE_NAME : nom du fichier ZIP de sortie contenant les informations de diagnostic sur votre charge de travail SAP
OUTPUT_FILE_PATH : chemin d'accès au répertoire dans lequel vous souhaitez que l'outil de diagnostic des performances enregistre le fichier ZIP de sortie. Le chemin d'accès spécifié est créé s'il n'existe pas.

Pour en savoir plus sur les paramètres compatibles avec cette commande, consultez la section Paramètres compatibles.

Paramètres possibles

Le tableau suivant décrit les arguments que vous pouvez utiliser avec la commande performancediagnostics :

Paramètre	Description
`type`	`STRING` Spécifiez une liste de types de diagnostic à exécuter, séparés par une virgule. Voici les types de diagnostic acceptés : `backup` : exécute les diagnostics automatiques et les `gsutil perfdiag` diagnostics de la fonctionnalité Backint pour les charges de travail SAP HANA. `IO` : exécute les diagnostics d'entrée/sortie à l'aide du testeur d'E/S flexible (FIO). Cela permet d'effectuer des tests de résistance sur les capacités d'E/S des systèmes de stockage de votre charge de travail. Il exécute également des simulations de charges de travail pour évaluer les performances de l'infrastructure de votre charge de travail, comme les disques et le système de fichiers réseau. `all` : exécute tous les diagnostics à la demande et par défaut compatibles avec l'outil. Si vous exécutez les diagnostics `IO` ou `all`, vous devez vous assurer que l'outil FIO est installé sur votre instance de calcul. Vous pouvez installer cet outil en exécutant `sudo yum install fio` sur RHEL et `sudo zypper install fio` sur SLES. Pour en savoir plus sur les diagnostics compatibles, consultez la section Diagnostic des performances de la charge de travail.
`backint-config-file`	`String` Si vous souhaitez exécuter les diagnostics `backup`, spécifiez le chemin d'accès à votre fichier de configuration Backint. Exemple : `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS.json` Pour exécuter les diagnostics `backup`, vous devez spécifier au moins l'un des paramètres suivants : `backint-config-file` ou `test-bucket`. Si vous utilisez des fichiers de configuration distincts pour les sauvegardes de données, de journaux ou de catalogues, spécifiez le chemin d'accès correspondant au type de sauvegarde pour lequel vous souhaitez collecter des informations de diagnostic.
`test-bucket`	`String` Si vous souhaitez exécuter les diagnostics `backup`, spécifiez le nom du bucket Cloud Storage que l'outil doit utiliser pour tester l'importation et le téléchargement de fichiers vers et depuis Cloud Storage. Exemple : `mybucket`. Assurez-vous que le bucket utilisé pour les tests n'a pas de règle de conservation définie. Pour exécuter les diagnostics `backup`, vous devez spécifier au moins l'un des paramètres suivants : `backint-config-file` ou `test-bucket`. Si vous spécifiez des valeurs pour les deux paramètres, l'outil utilise le bucket spécifié pour `test-bucket`.
`output-bucket`	`String` Facultatif. Spécifiez le nom du bucket Cloud Storage dans lequel vous souhaitez importer la sortie de l'outil de diagnostic des performances. Par exemple, `mytestbucket`. L'outil crée un dossier nommé "performancediagnostics" dans ce bucket pour stocker les fichiers de sortie. Si vous ne spécifiez pas ce paramètre, l'outil enregistre la sortie dans le répertoire déterminé en fonction de la spécification ou non du paramètre `output-file-path`. Pour que l'outil importe le résultat dans Cloud Storage, le compte de service utilisé par l'agent doit disposer du rôle IAM Utilisateur d'objets de stockage (`roles/storage.objectUser`). Si vous utilisez la fonctionnalité Backint de l'agent, le compte de service dispose des autorisations sous-jacentes.
`output-file-name`	`String` Facultatif. Spécifiez le nom du fichier ZIP de sortie créé par l'outil de diagnostic des performances. Par défaut, le fichier ZIP est nommé `performance-diagnostics-TIMESTAMP`, où `TIMESTAMP` correspond à la date et à l'heure auxquelles l'outil crée le fichier ZIP.
`output-file-path`	`String` Facultatif. Spécifiez le chemin d'accès au répertoire dans lequel l'outil de diagnostic des performances doit enregistrer le fichier ZIP de sortie. Le chemin d'accès spécifié est créé s'il n'existe pas. Par défaut, le fichier ZIP est enregistré dans le répertoire `/tmp`.
`hyper-threading`	`String` Facultatif. Indiquez que vous souhaitez définir les paramètres d'hyperthreading pour les types de machines bare metal Compute Engine, tels que X4. La valeur par défaut est `on`. Les valeurs acceptées sont `on` et `off`.
`log-level`	`String` Facultatif. Définit le niveau de journalisation de l'agent pendant la durée d'exécution des diagnostics de performances. La valeur par défaut est `info`. Les valeurs acceptées sont `debug`, `info`, `warn` et `error`. Les opérations effectuées par l'outil pour collecter des informations de diagnostic sont capturées dans le fichier suivant : `/var/log/google-cloud-sap-agent/performancediagnostics.log`.

Afficher les journaux

Lorsque vous exécutez la commande performancediagnostics, les opérations effectuées sont consignées dans le fichier suivant : /var/log/google-cloud-sap-agent/performancediagnostics.log.

Étape suivante

Une fois que vous avez généré la sortie de l'outil de diagnostic des performances, vous devez l'envoyer au service client. Cela peut aider le service client à résoudre plus rapidement le problème de performances lié à votre charge de travail SAP.