This document lists significant changes to Google Cloud's Agent for SAP.
Google Cloud's Agent for SAP is the successor to the Google Cloud agents: Google Cloud's monitoring agent for SAP NetWeaver, Google Cloud monitoring agent for SAP HANA, and the Cloud Storage Backint agent for SAP HANA.
If you are using any of these Google Cloud agents, then we recommend that you upgrade to using version 3.15 (latest) of Google Cloud's Agent for SAP at your earliest convenience. For details about Google Cloud's Agent for SAP, see the Google Cloud's Agent for SAP planning guide.
To view all of the announcements from SAP on Google Cloud, see Release notes.
Supported versions
Use the filters or search box to find updates by agent version, agent feature, or keyword.
| Version | Feature | Enhancements and bug fixes |
|---|---|---|
| 3.15 |
Agent framework and general updates
|
This version updates the libraries in the agent's GitHub repository to address vulnerabilities when you're building the agent from its GitHub source. |
| 3.14 |
Disk snapshot based backup and recovery for SAP HANA
|
While you're recovering an SAP HANA database by using a disk snapshot based backup, you can encrypt the restored disks with a Cloud KMS key. To encrypt your SAP HANA disks with a CMEK, you use the following arguments
while running the For more information, see Encrypt disks during recovery. |
| 3.14 |
Disk snapshot based backup and recovery for SAP HANA
|
For recovering an SAP HANA database that uses two or more disks to
host the |
| 3.14 |
Disk snapshot based backup and recovery for SAP HANA
|
This version introduces logging and stability enhancements that strengthen agent resiliency and improve error reporting during disk snapshot based recovery operations. |
| 3.13 |
Agent framework and general updates
|
This version introduces more descriptive error messages that help improve debugging and troubleshooting. |
| 3.13 |
Disk snapshot based backup and recovery for SAP HANA
|
This version introduces improved safeguards for disk snapshot based recovery operations for SAP HANA. |
| 3.13 |
Agent framework and general updates
|
This version introduces security and stability enhancements that strengthen agent resiliency and access controls during agent operations. |
| 3.13 |
SAP HANA monitoring metrics collection
|
This version introduces fixes for rendering of SAP HANA monitoring metrics in Cloud Monitoring dashboards. |
| 3.12 |
Disk snapshot based backup and recovery for SAP HANA
|
The following enhancements and changes are applicable when you use the agent's disk snapshot feature to recover an SAP HANA database that uses two or more disks to host the SAP HANA data volume:
For more information, see Recover the database by using a disk snapshot based backup. |
| 3.12 |
Workload Manager evaluation metrics collection
|
The agent collects more Workload Manager evaluation
metrics as part of the For more information about this evaluation, see the best practices that belong to the "SAP High Availability" category in Workload Manager best practices for SAP. |
| 3.11 |
Configure guest OS on bare metal instances for SAP HANA
|
To help you optimize the performance of SAP HANA workloads running
on X4 instances, the agent's
For information about configuring the guest OS on Compute Engine bare metal instances that run SAP workloads, see Configure guest OS on Compute Engine bare metal instances. |
| 3.11 |
Disk snapshot based backup and recovery for SAP HANA
|
The following enhancements are available when you perform disk snapshot based backup and recovery for SAP HANA:
For more information, see Back up and recover SAP HANA by using disk snapshots. |
| 3.11 |
Agent lifecycle management
|
As a Preview offering, you can use VM Extension Manager policies to install and manage version 3.11 or later of the agent on your VM fleet. For more information, see Install and manage Agent for SAP on a fleet of VMs. |
| 3.10 |
Disk snapshot based backup and recovery for SAP HANA
|
The disk snapshot feature of the agent is generally available (GA) for the following types of systems:
For more information about this feature, see Backup and recovery for SAP HANA by using disk snapshots. |
| 3.10 |
Feature enablement
|
Once you update to version 3.10 of the agent, the Workload Manager observability dashboard displays information about the agent and its configuration related to observability. This information is displayed in the following fields of the Applications and Databases tabs of the observability dashboard: Agent version, Process metrics, System discovery, and HANA monitoring. For more information, see Applications and Databases tabs. |
| 3.10 |
Workload Manager evaluation metrics collection
|
As part of the |
| 3.9 |
Process monitoring metrics collection
|
The following enhancements and fixes are available:
|
| 3.8 |
Process monitoring metrics collection
|
To improve the monitoring of memory usage by Linux system processes, the "Compute resources" category of Process Monitoring metrics has been introduced. For more information, see the metric descriptions in Process Monitoring metrics and SAP HANA monitoring metrics. |
| 3.8 |
Process monitoring metrics collection
SAP HANA monitoring metrics collection
|
To improve the monitoring of memory usage by SAP HANA, the agent additionally collects the following metrics:
For more information, see the metric descriptions in Process Monitoring metrics and SAP HANA monitoring metrics. |
| 3.8 |
Generate support bundle
|
To help you and Cloud Customer Care better troubleshoot issues with
your SAP workloads, the output of the
For more information, see Support Bundle. |
| 3.7 |
Disk snapshot based backup and recovery for SAP HANA
|
You can use the disk snapshot feature of the agent to back up and restore SAP HANA scale-out systems that don't use the host auto-failover solution. For more information, see Backup and recovery for SAP HANA by using disk snapshots. |
| 3.7 |
SAP HANA monitoring metrics collection
|
The following enhancements are available:
|
| 3.7 |
Workload Manager evaluation metrics collection
|
The agent collects more Workload Manager evaluation
metrics as part of the For information about the introduced evaluations, see the best practices that belong to the "SAP High Availability" category in Workload Manager best practices for SAP. |
| 3.7 |
Agent configuration management
|
By running the agent's For more information, see the configuration guides in the agent documentation. For example, for information about how to validate the Google Cloud setup for the collection of Process Monitoring metrics collection, see Validate the setup for Process Monitoring metrics collection. |
| 3.7 |
Feature enablement
|
You can set up monitoring for certain SAP system events by displaying them as annotations in Cloud Monitoring dashboards and predefined observability dashboards. For more information, see Show SAP events on Cloud Monitoring dashboards. |
| 3.7 |
Backint based backup and recovery for SAP HANA
|
This version introduces support for the following configuration parameters parallel_recovery_streams,
object_retention_time, and
object_retention_mode. These let you specify
object-level retention policies instead of a bucket-level retention
policy. For information about these parameters, see their
description in
Configuration parameters.
|
| 3.7 |
Agent configuration management
|
When you manually edit the agent's configuration file, you no longer need to restart the agent for the changes to take effect. The changes are auto-picked within the next 30 seconds. |
| 3.6 |
Disk snapshot based backup and recovery for SAP HANA
|
As a Preview
offering, you can use the disk snapshot feature of the agent to back
up and restore SAP HANA scale-up databases where the
To use this feature enhancement, you need to contact Customer Care. For more information, see Backup and recovery for SAP HANA by using disk snapshots. |
| 3.6 |
SAP HANA monitoring metrics collection
|
The following updates to SAP HANA monitoring metrics collection:
For more information, see the descriptions of these metrics in SAP HANA monitoring metrics. |
| 3.6 |
Backint based backup and recovery for SAP HANA
|
The Backint configuration parameter |
| 3.6 |
Configure guest OS on bare metal instances for SAP HANA
|
This version introduces enhancements for the agent's
For information about the agent's |
| 3.5 |
Feature enablement
|
Support for setting up observability for your SAP workloads by using Workload Manager. For more information, see SAP system discovery. |
| 3.5 |
SAP HANA monitoring metrics collection
|
When you enable the collection of SAP HANA monitoring metrics, the agent additionally collects the following metrics by default:
For information about these metrics, see SAP HANA monitoring metrics. |
| 3.5 |
Workload Manager evaluation metrics collection
|
The agent collects additional label-value pairs as part of the
Workload Manager evaluation metric |
| 3.5 |
Agent lifecycle management
|
On Linux, you can disable and enable the agent's
|
| 3.5 |
Process monitoring metrics collection
|
This version fixes the behavior of the Process Monitoring metric
|
| 3.4 |
Workload performance diagnostics
|
To help Cloud Customer Care in accelerating troubleshooting any performance issues with your SAP workloads that run on Google Cloud, a performance diagnostics tool is built into Google Cloud's Agent for SAP. For more information, see Workload performance diagnostics. |
| 3.4 |
Backint based backup and recovery for SAP HANA
|
You can specify the |
| 3.4 |
Disk snapshot based backup and recovery for SAP HANA
|
The following enhancements are available:
For more information, see Supported arguments for disk restoration. |
| 3.3 |
Disk snapshot based backup and recovery for SAP HANA
|
When you
create
a disk snapshot based backup by running the
This means that the arguments |
| 3.3 |
Backint based backup and recovery for SAP HANA
|
This version introduces the following enhancements:
|
| 3.3 |
Disk snapshot based backup and recovery for SAP HANA
Process monitoring metrics collection
SAP HANA monitoring metrics collection
Workload Manager evaluation metrics collection
|
To authenticate the database user account that the agent uses to
query your SAP HANA database, you can specify an
|
| 3.2 |
Workload Manager evaluation metrics collection
|
For more information, see Configure Workload Manager evaluation metrics collection. |
| 3.2 |
Agent configuration management
|
In addition to manually editing the configuration file and restarting the agent, you can use commands to configure the agent and automatically restart it. For more information, see Configuration commands for Google Cloud's Agent for SAP. |
| 3.2 |
Backint based backup and recovery for SAP HANA
|
For information about the Backint configuration parameters, see Configuration parameters. |
| 3.2 |
Disk snapshot based backup and recovery for SAP HANA
|
You can do the following while creating disk snapshot based backups for SAP HANA:
|
| 3.2 |
Process monitoring metrics collection
|
The agent additionally collects the following
Process monitoring metrics: |
| 3.1 |
SAP system discovery
|
This version introduces the
|
| 3.1 |
Backint based backup and recovery for SAP HANA
|
To let you organize backups of multiple SAP HANA systems in the
same Cloud Storage bucket, the
|
| 3.0 |
Backint based backup and recovery for SAP HANA
|
You can back up and recover your SAP HANA database by using the agent's Backint feature. This feature is available for SAP HANA systems running on Google Cloud, on Bare Metal Solution, on premises, or on other cloud platforms. For more information about this feature of the agent, see Backup and recovery for SAP HANA by using Backint. |
| 3.0 |
Disk snapshot based backup and recovery for SAP HANA
|
You can back up and recover SAP HANA databases running on Google Cloud by using the agent's disk snapshot feature. For more information about this feature, see Backup and recovery for SAP HANA by using disk snapshots. |
| 3.0 |
Workload Manager evaluation metrics collection
|
The agent collects the latest set of Workload Manager evaluation metrics without requiring you to update the agent. Consequently, this lets you seamlessly evaluate your SAP systems against any new best practices introduced in Workload Manager. If you need to turn off this behavior, then set the
For more information about version 3.0 of Google Cloud's Agent for SAP, see the Google Cloud's Agent for SAP planning guide. |
Legacy versions
This section lists changes in legacy versions of Google Cloud's Agent for SAP that are no longer supported.
Version 2.8
Version 2.8 of Google Cloud's Agent for SAP additionally collects the SAP Host Agent
metrics Guaranteed IOPS and Guaranteed Throughput for Google Cloud Hyperdisk
volumes.
Version 2.7
Version 2.7 of Google Cloud's Agent for SAP introduces the following:
- Fixed the handling of SAP HANA database passwords that contain special characters. They are now encoded in double quotes, as mandated by SAP.
- The
sap/networkstatsfamily of Process Monitoring metrics that are related to TCP network. For more information, see Process Monitoring metrics. - For visualizing the SAP HANA monitoring metrics collected by agent versions 2.0 or later, the Agent for SAP - Detailed HANA Overview and Agent for SAP - HANA performance dashboards. For information about these dashboards, see View the collected metrics.
Version 2.6
Version 2.6 of Google Cloud's Agent for SAP introduces the following:
- Fixes for the collection of Workload Manager evaluation metrics that are related to SAP HANA and Pacemaker instances.
- From this version, for agent instances running on Bare Metal Solution servers,
the agent configuration parameter
instance_idhas been replaced by the parameterinstance_name. For more information, see Install the agent. Configuration parameter updates for the collection of the Process Monitoring metrics:
process_metrics_frequency: From version 2.6, this parameter determines the collection frequency for the following fast-changing Process Monitoring metrics:sap/hana/availability,sap/hana/ha/availability, andsap/nw/availability. All other Process Monitoring metrics are now referred to as slow-changing Process Monitoring metrics.slow_process_metrics_frequency: This parameter determines the collection frequency of all other Process Monitoring metrics.process_metrics_to_skip: This parameter determines the Process Monitoring metrics that the agent skips from collecting. This parameter accepts a comma-separated value of Process Monitoring metric names. For example:"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].
For more information about the configuration parameters related to the collection Process Monitoring metrics, see:
- For agent instances on Compute Engine instances, see Configuration parameters.
- For agent instances on Bare Metal Solution servers, see Configuration parameters.
Version 2.5
Version 2.5 of Google Cloud's Agent for SAP introduces the following:
- A new metric,
sap/validation/hanasecurity, which indicates the collection of SAP HANA database metrics for Workload Manager evaluation. For more information, see Workload Manager evaluation metrics. - Enhancement to use the SOAP interface of
sapcontrolfor the collection of the Process Monitoring metrics. - For the collection of Process Monitoring metrics, included fixes in SAP system discovery to ignore commented entries.
Version 2.4
Version 2.4 of Google Cloud's Agent for SAP includes bug fixes for the collection
of the Workload Manager evaluation metric, sap/validation/corosync.
Version 2.3
Version 2.3 of Google Cloud's Agent for SAP includes bug fixes for SAP system discovery sending data to Cloud Logging.
Version 2.2
Version 2.2 of Google Cloud's Agent for SAP includes bug fixes for SAP system discovery.
Version 2.1
Version 2.1 of Google Cloud's Agent for SAP includes the following features and bug fixes:
- SAP system discovery: Identifies all Google Cloud platform resources related to the SAP system and sends this information to Cloud Logging.
- Support bundle feature: Facilitates the collection of necessary information, such as logs and error strings, to improve supportability.
- Bug fixes in the collection of Workload Manager evaluation metrics.
Version 2.0
Version 2.0 of Google Cloud's Agent for SAP introduces the following features:
- Collection of SAP HANA monitoring metrics: On Linux, you can configure Google Cloud's Agent for SAP to collect the SAP HANA monitoring metrics. These metrics provide you visibility into the performance, availability, and health of your SAP HANA instances and the underlying infrastructure. For more information, see SAP HANA monitoring metrics.
For more information about version 2.0 of Google Cloud's Agent for SAP, see Google Cloud's Agent for SAP planning guide.
Version 1.6
Version 1.6 of Google Cloud's Agent for SAP includes the following bug fixes:
- Fix to collect the Process Monitoring metric
/sap/nw/enq/locks/usercountownerfrom all applicable instance types - ASCS and ERS. - Fixes for accessing the
cloud_propertiesconfiguration of agent instances running on Bare Metal Solution servers.
Version 1.5
Version 1.5 of Google Cloud's Agent for SAP includes the following bug fixes:
- Fix for the agent instances on Linux to always overwrite the
systemdservice file contents, which ensure that the agent capabilities works as expected during version updates. - Fix in Linux command-line execution while parsing the command's exit code. This fix prevents the agent from shutting down in some edge cases.
Version 1.4
Version 1.4 of Google Cloud's Agent for SAP includes the following bug fixes and features:
- Added a new
startdaemonsub-command to run the agent in daemon mode.- This change is non-impacting to the normal operation of the agent.
- Prevented changes to the agent configuration file from being overwritten during updates.
- Fixed sending time-value logs to Cloud Logging.
- Fixed the collection of Workload Manager maintenance mode
and the Process Monitoring metric
sap/nw/abap/sessions. - New metrics that the agent can collect:
/sap/nw/enq/locks/usercountowner: a Process Monitoring metric that monitors the enqueue locks in SAP NetWeaver systems.
Version 1.3
Version 1.3 of Google Cloud's Agent for SAP includes the following bug fixes and features:
- Fixed the collection of SAP HANA related Workload Manager evaluation metrics.
- The agent's logs are now redirected to Cloud Logging by default. You no longer need to do any configuration for this.
- Bug fix in Process Monitoring metrics to use
REPLICATION_MODEto determine whether an SAP HANA node is primary or secondary. This improves metric accuracy for HANA secondary systems.
Version 1.2
Version 1.2 of Google Cloud's Agent for SAP includes the following bug fixes and features:
- The Process Monitoring metrics now consider the status of the
enq_replicatorandenq_serverservices to determine the availability of SAP NetWeaver instances. - New metrics that the agent can collect:
/sap/infra/migration: an infrastructure migration metric that indicates if a Compute Engine instance is undergoing a live migration./sap/agent/health: a metric that shows the agent's health in Cloud Monitoring./sap/agent/cpu/utilizationand/sap/agent/memory/utilization: these Cloud Monitoring metrics enable you to monitor the CPU and memory resources used by the agent.
Version 1.1
Version 1.1 of Google Cloud's Agent for SAP fixes a Workload Manager evaluation related bug to strip double quotes from Linux OS metric value.
Version 1.0
Version 1.0 of Google Cloud's Agent for SAP introduces the following features:
Collection of SAP Host Agent metrics: Google Cloud's Agent for SAP collects and sends all the required information to the SAP Host Agent, as mandated by SAP. For more information, see the SAP Host Agent metrics.
Collection of Process Monitoring metrics: On Linux, you can configure Google Cloud's Agent for SAP to collect Process Monitoring metrics for your SAP applications and their runtime states. This information helps you troubleshoot the issues related to your SAP workloads. For more information, see the Process Monitoring metrics.
Collection of Workload Manager evaluation metrics: On Linux, you can configure Google Cloud's Agent for SAP to collect Workload Manager evaluation metrics that are required to enable the Workload Manager services for your SAP workloads. For more information, see the Workload Manager evaluation metrics.