For problems that are related to version 2 of
Google Cloud's Agent for SAP, provide
the following diagnostic information to Cloud Customer Care as soon as
you can:
Provide a complete and detailed description of the problem, including
the version of the agent, and the date and time when the problem occurred.
To check the version of your agent, complete the following steps:
Linux
For RHEL, follow these steps:
Use SSH to connect to the host Compute Engine instance or
Bare Metal Solution server.
Run the following command:
yum info google-cloud-sap-agent
For SLES, follow these steps:
Use SSH to connect to the host Compute Engine instance or
Bare Metal Solution server.
Run the following command:
zypper info google-cloud-sap-agent
Windows
Use RDP to connect to the host Compute Engine instance or
Bare Metal Solution server.
As an administrator, run the following command from PowerShell:
googet installed google-cloud-sap-agent
Support Bundle
Support bundle is a collection of information from Google Cloud's Agent for SAP,
that helps Customer Care in providing you troubleshooting support. This
feature is available for Google Cloud's Agent for SAP version 2.1 or later.
Support bundle includes the following information:
Google Cloud's Agent for SAP log and configuration file
SAP HANA traces and topology files for the given hostname and SID
Cloud Storage Backint agent for SAP HANA configuration file and logs
For a high-availability (HA) cluster on RHEL, the output of the sosreport
and crm_report commands.
For a HA cluster on SUSE, the output of the hrb_report, crm_report, and
supportconfig utilities.
To generate the support bundle for an agent instance running on Linux, run the following command on your
host:
INSTANCE_NUMBERS: the SAP instance numbers for which
you want to generate the support bundle.
To specify multiple instance numbers, separate them using a space. For
example, 00 11 22. When you specify two or more SAP instance
numbers, the command generates one combined support bundle for the specified
instances.
HOST_NAME: the name of the host on which you run the
command.
Most recent data collected by the agent
Provide the most recent data collected by the agent. Save the most recent data
collected by the agent to a file and attach the file to your support case.
To view the most recent data collected by the agent, complete the following steps:
Linux
Use SSH to connect to the host machine.
Run the following command:
curl http://localhost:18181/
Windows
Use RDP to connect to the host machine.
As an administrator, run the following command from PowerShell:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Version 2: Google Cloud's Agent for SAP diagnostic information\n\n\u003cbr /\u003e\n\n\n| **Warning:** Support for version 2 of Google Cloud's Agent for SAP ended on July 31, 2025.\n|\n| If you're using version 2 of Google Cloud's Agent for SAP, then we recommend that you switch to the\n| latest version of the agent as soon as possible. For information about how to update\n| Google Cloud's Agent for SAP, see\n| [Update\n| Google Cloud's Agent for SAP](/sap/docs/agent-for-sap/latest/operations#agent4sap-update).\n\n\u003cbr /\u003e\n\nFor problems that are related to **version 2** of\nGoogle Cloud's Agent for SAP, provide\nthe following diagnostic information to Cloud Customer Care as soon as\nyou can:\n\n- [A complete and detailed description of the problem](#detailed_desc).\n- [The support bundle for the agent](#support_bundle).\n- [The most recent data collected by the agent](#data_collected).\n- [The configuration file for the agent](#config_file).\n- [The log file for the agent](#log_file).\n\nDetailed description of the problem\n-----------------------------------\n\nProvide a complete and detailed description of the problem, including\nthe version of the agent, and the date and time when the problem occurred.\n\n\nTo check the version of your agent, complete the following steps: \n\n### Linux\n\n\nFor RHEL, follow these steps:\n\n1. Use SSH to connect to the host Compute Engine instance or Bare Metal Solution server.\n2. Run the following command: \n\n ```\n yum info google-cloud-sap-agent\n ```\n\nFor SLES, follow these steps:\n\n1. Use SSH to connect to the host Compute Engine instance or Bare Metal Solution server.\n2. Run the following command: \n\n ```\n zypper info google-cloud-sap-agent\n ```\n\n### Windows\n\n1. Use RDP to connect to the host Compute Engine instance or Bare Metal Solution server.\n2. As an administrator, run the following command from PowerShell: \n\n ```\n googet installed google-cloud-sap-agent\n ```\n\n\u003cbr /\u003e\n\nSupport Bundle\n--------------\n\nSupport bundle is a collection of information from Google Cloud's Agent for SAP,\nthat helps Customer Care in providing you troubleshooting support. This\nfeature is available for Google Cloud's Agent for SAP version 2.1 or later.\n\nSupport bundle includes the following information:\n\n- Google Cloud's Agent for SAP log and configuration file\n- SAP HANA traces and topology files for the given hostname and SID\n- Cloud Storage Backint agent for SAP HANA configuration file and logs\n- For a high-availability (HA) cluster on RHEL, the output of the `sosreport` and `crm_report` commands.\n- For a HA cluster on SUSE, the output of the `hrb_report`, `crm_report`, and `supportconfig` utilities.\n\nTo generate the support bundle for an agent instance running on Linux, run the following command on your\nhost: \n\n```\nsudo /usr/bin/google_cloud_sap_agent supportbundle --sid=\"SID\" --instance-numbers=\"INSTANCE_NUMBERS\" --hostname=\"HOST_NAME\"\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eSID\u003c/var\u003e: your SAP system ID.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NUMBERS\u003c/var\u003e: the SAP instance numbers for which you want to generate the support bundle.\n\n To specify multiple instance numbers, separate them using a space. For\n example, `00 11 22`. When you specify two or more SAP instance\n numbers, the command generates one combined support bundle for the specified\n instances.\n- \u003cvar translate=\"no\"\u003eHOST_NAME\u003c/var\u003e: the name of the host on which you run the command.\n\nMost recent data collected by the agent\n---------------------------------------\n\nProvide the most recent data collected by the agent. Save the most recent data\ncollected by the agent to a file and attach the file to your support case.\n\nTo view the most recent data collected by the agent, complete the following steps: \n\n### Linux\n\n1. Use SSH to connect to the host machine.\n2. Run the following command: \n\n ```\n curl http://localhost:18181/\n ```\n\n### Windows\n\n1. Use RDP to connect to the host machine.\n2. As an administrator, run the following command from PowerShell: \n\n ```\n \"(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent\"\n ```\n\nConfiguration file\n------------------\n\nAfter removing credentials such as the SAP HANA database username and passwords,\nprovide the configuration file for Google Cloud's Agent for SAP.\n\nTo find the configuration file for the agent, navigate to the following path: \n\n### Linux\n\n\n```\n/etc/google-cloud-sap-agent/configuration.json\n```\n\n\u003cbr /\u003e\n\n### Windows\n\n\n```\nC:\\Program Files\\Google\\google-cloud-sap-agent\\conf\\configuration.json\n```\n\n\u003cbr /\u003e\n\nLog file\n--------\n\nProvide the log file for Google Cloud's Agent for SAP.\n\nTo find the log file for the agent, navigate to the following path: \n\n### Linux\n\n\n```\n/var/log/google-cloud-sap-agent.log\n```\n\n\u003cbr /\u003e\n\n### Windows\n\n\n```\nC:\\Program Files\\Google\\google-cloud-sap-agent\\logs\\google-cloud-sap-agent.log\n```\n\n\u003cbr /\u003e"]]
