Informations de diagnostic sur l'agent Google Cloud pour SAP

Pour les problèmes liés à la version 3.8 (la plus récente) de l'agentGoogle Cloudpour SAP, transmettez les informations de diagnostic suivantes au service Cloud Customer Care dès que possible:

• Une description exhaustive et détaillée du problème
• Le bundle d'assistance de l'agent.
• Les données les plus récentes collectées par l'agent
• Le fichier de configuration de l'agent
• Le fichier journal de l'agent

Description détaillée du problème

Fournissez une description complète et détaillée du problème, y compris la version de l'agent, ainsi que la date et l'heure auxquelles le problème s'est produit.

Pour afficher la version de l'agent, procédez comme suit :

Bundle d'assistance

Le bundle d'assistance est un ensemble d'informations de l'agent Google Cloudpour SAP qui permettent au service client de vous fournir une assistance. Cette fonctionnalité est disponible pour l'agent Google Cloudpour SAP version 2.1 ou ultérieure.

À partir de la version 3.4 de l'agent, vous pouvez importer la sortie de la commande supportbundle à l'aide de l'option result-bucket. Pour ce faire, vous devez vous assurer que le compte de service utilisé par l'agent dispose de l'autorisation IAM suivante: storage.objects.create.

Contenu du bundle d'assistance

• Les fichiers de journal et de configuration de l'agent.

  À partir de la version 3.0 de l'agent, cela inclut les journaux et les fichiers de configuration liés aux fonctionnalités Backint et d'instantanés de disque de l'agent.

• Traces et fichiers de topologie SAP HANA pour le nom d'hôte et le SID donnés.

• Fichier de configuration et journaux de l'agent Backint de Cloud Storage pour SAP HANA.

• Pour un cluster à haute disponibilité (HD) sur RHEL, lorsque vous spécifiez pacemaker-diagnosis="true", la sortie de sosreport est enregistrée dans le répertoire suivant : /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Si l'exécution de la commande sosreport échoue, la sortie de crm_report est enregistrée dans le répertoire spécifié.

• Pour un cluster à haute disponibilité sur SUSE, lorsque vous spécifiez pacemaker-diagnosis=true, la sortie des utilitaires hb_report et supportconfig est enregistrée dans le répertoire suivant : /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Si l'exécution de ces utilitaires échoue, la sortie de hb_report et crm_report est enregistrée dans le répertoire spécifié.

• Le fichier /var/log/messages, qui fournit des informations utiles sur les opérations de votre système Linux.

• À partir de la version 3.8 de l'agent, le fichier sapdiscovery.json est inclus par défaut. Le fichier contient des informations sur les produits SAP et les composants associés exécutés sur l'instance de calcul. Ces informations fournissent au service client un contexte plus précis sur le rôle et la configuration de votre système SAP.

  Pour autoriser l'agent à collecter ces informations, vous devez répondre aux exigences suivantes:

  • Spécifiez "log_to_cloud": true dans le fichier de configuration de l'agent.
  • Accordez l'autorisation IAM logging.logEntries.list au compte de service utilisé par l'agent.

• À partir de la version 3.8 de l'agent, lorsque vous spécifiez l'option metrics, le bundle inclut des informations sur les occurrences d'événements SAP prédéfinis et les modifications des valeurs de la métrique de surveillance des processus et de la métrique de surveillance SAP HANA pour une période spécifique.

  • Pour permettre à l'agent de collecter des informations sur les occurrences d'événements SAP prédéfinis à partir des journaux Cloud Logging, vous devez respecter les conditions suivantes :
    • Spécifiez "log_to_cloud": true dans le fichier de configuration de l'agent.
    • Accordez l'autorisation IAM logging.logEntries.list au compte de service utilisé par l'agent.
  • Pour permettre à l'agent de collecter des informations sur les modifications des valeurs de métriques à partir de Cloud Monitoring, vous devez respecter les conditions suivantes :
    • Spécifiez "send_metrics_to_monitoring": true dans le fichier de configuration de l'agent.
    • Accordez les autorisations IAM suivantes au compte de service utilisé par l'agent: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list et monitoring.timeSeries.list.
  • La période pendant laquelle l'agent filtre les journaux Cloud Logging et les entrées Cloud Monitoring est déterminée par le comportement des options suivantes :
    • timestamp: code temporel, au format YYYY-MM-DD HH:MM:SS, autour duquel vous souhaitez collecter des informations sur les occurrences des types d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut correspond à l'heure à laquelle vous exécutez la commande supportbundle.
    • before-duration: nombre de secondes avant timestamp pendant lesquelles l'agent recherche les occurrences d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut est de 3 600 secondes.
    • after-duration: nombre de secondes après timestamp pendant lesquelles l'agent recherche les occurrences d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut est de 1 800 secondes.

  • Les informations collectées sont organisées dans des dossiers contenant des fichiers JSON pour chaque type d'événement SAP qui s'est produit et pour chaque métrique qui a modifié sa valeur. Voici un exemple de sortie:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Générer un lot d'assistance

Pour générer le bundle d'assistance pour une instance d'agent exécutée sous Linux, exécutez la commande suivante sur votre instance de calcul:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Remplacez les éléments suivants :

• SID : ID de votre système SAP.
• INSTANCE_NUMBERS : numéros d'instance SAP pour lesquels vous souhaitez générer le bundle d'assistance.

  Pour spécifier plusieurs numéros d'instance, séparez-les par un espace. (par exemple, 00 11 22) Lorsque vous spécifiez au moins deux numéros d'instance SAP, la commande génère un groupe d'assistance combiné pour les instances spécifiées.

• HOST_NAME : nom de l'hôte sur lequel vous exécutez la commande.
• BOOLEAN_VALUE: valeur true ou false, qui détermine si le diagnostic lié au stimulateur cardiaque est effectué ou non. La valeur par défaut est false.
• BUCKET_NAME: nom du bucket Cloud Storage dans lequel vous souhaitez importer la sortie de la commande supportbundle.
• TIMESTAMP: code temporel, au format YYYY-MM-DD HH:MM:SS, autour duquel vous souhaitez collecter des informations sur les occurrences des types d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut correspond à l'heure à laquelle vous exécutez la commande supportbundle.
• BEFORE_DURATION: nombre de secondes avant la valeur de l'option timestamp pendant lesquelles l'agent recherche les occurrences d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut est de 3 600 secondes.
• AFTER_DURATION: nombre de secondes après la valeur de l'option timestamp pendant lesquelles l'agent recherche les occurrences d'événements SAP prédéfinis et les modifications des valeurs de métrique. La valeur par défaut est de 1 800 secondes.

Données les plus récentes collectées par l'agent

Fournissez les données les plus récentes collectées par l'agent. Enregistrez les données les plus récentes collectées par l'agent dans un fichier et joignez ce fichier à votre demande d'assistance.

Pour afficher les données les plus récentes collectées par l'agent, procédez comme suit :

Fichier de configuration

Après avoir supprimé les identifiants tels que le nom d'utilisateur et le mot de passe de la base de données SAP HANA, fournissez le fichier de configuration pour l'agent Google Cloudpour SAP.

Pour trouver le fichier de configuration de l'agent, accédez au chemin suivant :

/etc/google-cloud-sap-agent/configuration.json

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

Fichier journal

Fournissez le fichier journal de l'agent Google Cloudpour SAP.

Pour trouver le fichier journal de l'agent, accédez au chemin suivant :

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log