When you contact Cloud Customer Care for assistance in troubleshooting a performance issue with your SAP workload, you need to share pertinent diagnostic information about your workload. By using the agent's built-in performance diagnostic tool, you can automate the gathering of the necessary diagnostic information, which in turn can help accelerate troubleshooting and resolution.
For information about the performance diagnostics that the agent can run for your SAP workloads, see Workload performance diagnostics.
Before you begin
Make sure that you're using version 3.4 or later of Google Cloud's Agent for SAP.
For information about how to check and update the agent, see Update Google Cloud's Agent for SAP.
Gather performance diagnostics information
To gather performance diagnostics information for your SAP workload, invoke the
agent's tool by using the performancediagnostics
command:
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
Replace the following:
COMMA_SEPARATED_DIAGNOSTIC_TYPES
: the diagnostic types that you want to run.STORAGE_BUCKET_NAME
: the name of the Cloud Storage that the tool must use to run thebackup
diagnostics.BACKINT_CONFIG_FILE_PATH
: the path to the required Backint configuration file.OUTPUT_FILE_NAME
: the name of the output ZIP file, which contains the diagnostic information about your SAP workloadOUTPUT_FILE_PATH
: the path to the directory where you want the performance diagnostic tool to save the output ZIP file. The specified path is created if it doesn't exist.
For information about the parameters supported by this command, see Supported parameters.
Supported parameters
The following table describes the parameters that you can use with the
performancediagnostics
command:
Parameter | Description |
---|---|
type |
STRING
Specify a comma-separated list of diagnostic types that you want to run. The following are the supported diagnostic types:
If you're running the For more information about the supported diagnostics, see Workload performance diagnostics. |
backint-config-file |
String
If you want to run the To run the If you're using separate configuration files for data, log, or catalog backups, then specify the path that corresponds to the backup type for which you want to collect diagnostic information. |
test-bucket |
String
If you want to run the To run the |
output-bucket |
String
Optional. Specify the name of the Cloud Storage bucket where
you want to upload the output of the performance diagnostics tool. For
example: If you don't specify this parameter, then the tool saves the output
in the directory determined by whether or not you specify the
To let the tool upload the output to Cloud Storage, the
service account used by the agent must be assigned the Storage Object
User ( |
output-file-name |
String
Optional. Specify the name of the output ZIP file that the performance diagnostics tool creates. By default, the ZIP file is named
|
output-file-path |
String
Optional. Specify the path to the directory where you want the performance diagnostic tool to save the output ZIP file. The specified path is created if it doesn't exist. By default, the ZIP file is saved in the |
hyper-threading |
String
Optional. Specify to set the hyperthreading settings for
Compute Engine bare metal machine types, such as X4. The default
value is |
log-level |
String
Optional. Sets the agent's logging level for the duration it runs the
performance diagnostics. The default value is Operations performed by the tool to collect diagnostic
information are captured in the following file:
|
View logs
When you run the performancediagnostics
command, the operations performed are
logged in the following file:
/var/log/google-cloud-sap-agent/performancediagnostics.log
.
What's next
Once you generate the output of performance diagnostic tool, you need to send it to Customer Care. This can help Customer Care accelerate troubleshooting the performance issue with your SAP workload.