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 pour SAP de Google Cloud, version 3.4 ou ultérieure.

Lorsque vous contactez l'équipe Cloud Customer Care pour obtenir de l'aide pour résoudre un problème de performances avec 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 accélérer le dépannage et la résolution.

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 de la charge de travail.

Avant de commencer

Collecter des informations de diagnostic des performances

Pour collecter des informations de diagnostic des performances pour 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 de l'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, qui contient 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 spécifié est créé s'il n'existe pas.

Pour en savoir plus sur les paramètres acceptés par cette commande, consultez la section Paramètres acceptés.

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 que vous souhaitez exécuter, séparés par une virgule. Voici les types de diagnostics acceptés:

  • backup: exécute l'autodiagnostic et les diagnostics gsutil perfdiag 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 stress sur les capacités d'E/S des systèmes de stockage de votre charge de travail. Il exécute également des simulations de charge 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 Compute Engine. 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 qu'aucune règle de conservation n'est définie pour le bucket utilisé pour les tests.

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é par la présence ou l'absence du paramètre output-file-path.

Pour permettre à l'outil d'importer la sortie dans Cloud Storage, le compte de service utilisé par l'agent doit disposer du rôle IAM Utilisateur des objets de l'espace 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 vous souhaitez que l'outil de diagnostic des performances enregistre le fichier ZIP de sortie. Le chemin 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. Spécifiez si 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 enregistré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 à accélérer la résolution du problème de performances lié à votre charge de travail SAP.