Version 2: Configure Process Monitoring metrics collection

If you're using version 2 of Google Cloud's Agent for SAP, then we recommend that you switch to the latest version of the agent as soon as possible. For information about how to update Google Cloud's Agent for SAP, see Update Google Cloud's Agent for SAP .

This guide shows you how to configure version 2 of Google Cloud's Agent for SAP to collect the Process Monitoring metrics from your SAP systems.

For information about this feature, see Process Monitoring using Google Cloud's Agent for SAP .

Before you begin

• Validate your installation of Google Cloud's Agent for SAP. For instructions, see the installation guide for your scenario .
• If you have installed the agent on a Bare Metal Solution server, then make sure that you have completed the required prerequisites and set up a service account. For instructions, see Configure Google Cloud's Agent for SAP on Linux .

Set IAM roles

To allow Google Cloud's Agent for SAP collect the Process Monitoring metrics, you must ensure that the service account being used by your Compute Engine instance or Bare Metal Solution server includes the following roles:

• Compute Viewer ( roles/compute.viewer )
• Monitoring Metric Writer ( roles/monitoring.metricWriter ) roles.
• Secret Manager Secret Accessor ( roles/secretmanager.secretAccessor ) , if you use Secret Manager for storing SAP HANA database password.

To add these required roles to your service account, follow these steps:

1. In the Google Cloud console, go to the IAMpage.

   Go to IAM

2. Select your Google Cloud project.

3. Identify the service account to which you want to add a role.

   • If the service account isn't already on the principals list, then it doesn't have any roles assigned to it. Click Addand enter the email address of the service account.
   • If the service account is already on the principals list, then it has existing roles. Click the Editbutton for the service account that you want to edit.

4. Select the required role from the list of available roles:

   • Compute Viewer
   • Monitoring > Monitoring Metric Writer
   • Secret Manager > Secret Manager Secret Accessor

5. Click Addor Saveto apply the roles to the service account.

Enable Process Monitoring metrics collection

To enable the collection of Process Monitoring metrics using Google Cloud's Agent for SAP, follow these steps:

1. Establish an SSH connection with your host Compute Engine instance.

2. Open the agent's configuration file:

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

3. In the collection_configuration section, perform the following:

   • For the parameter collect_process_metrics , specify the value true .
   • To enable the collection of process monitoring metrics related to your SAP HANA database instances, you need to configure additional parameters in the hana_metrics_config section. For information about these parameters, see Configuration parameters .

4. Optionally, under the cloud_properties section, you can update the parameter values that are set automatically. To do so, add the cloud_properties section to your configuration file, and then specify the required parameters and their values.

5. Save the configuration file.

6. Restart the agent for the new settings to take effect:

   sudo systemctl restart google-cloud-sap-agent

Example configuration files

 { 
  
 "provide_sap_host_agent_metrics" 
 : 
  
 true 
 , 
  
 "bare_metal" 
 : 
  
 false 
 , 
  
 "log_level" 
 : 
  
 "INFO" 
 , 
  
 "log_to_cloud" 
 : 
  
 true 
 , 
  
 "collection_configuration" 
 : 
  
 { 
  
 "sap_system_discovery" 
 : 
  
 true 
 , 
  
  
 "collect_workload_validation_metrics" 
 : 
  
 true 
 , 
  
  
 "collect_process_metrics" 
 : 
  
 true 
 , 
  
 "process_metrics_frequency" 
 : 
  
 5 
 , 
  
 "slow_process_metrics_frequency" 
 : 
  
 30 
 , 
  
  
 "hana_metrics_config" 
 : 
  
 { 
  
  
  
 "hana_db_user" 
 : 
  
 "db_user_name" 
 , 
  
 "sid" 
 : 
  
 "DEH" 
 , 
  
  
  
 "hana_db_password_secret_name" 
 : 
  
 "db_pwd_secret_name" 
  
  
 } 
  
 }, 
  
 "hana_monitoring_configuration" 
 : 
  
 { 
  
 "enabled" 
 : 
  
 false 
  
 } 
 } 

 { 
  
 "provide_sap_host_agent_metrics" 
 : 
  
 true 
 , 
  
 "bare_metal" 
 : 
  
 true 
 , 
  
 "log_level" 
 : 
  
 "INFO" 
 , 
  
 "log_to_cloud" 
 : 
  
 true 
 , 
  
 "collection_configuration" 
 : 
  
 { 
  
 "sap_system_discovery" 
 : 
  
 true 
 , 
  
  
 "collect_workload_validation_metrics" 
 : 
  
 true 
 , 
  
  
 "collect_process_metrics" 
 : 
  
 true 
 , 
  
 "process_metrics_frequency" 
 : 
  
 5 
 , 
  
 "slow_process_metrics_frequency" 
 : 
  
 30 
 , 
  
  
 "hana_metrics_config" 
 : 
  
 { 
  
  
  
 "hana_db_user" 
 : 
  
 "db_user_name" 
 , 
  
 "sid" 
 : 
  
 "DEH" 
 , 
  
  
  
 "hana_db_password_secret_name" 
 : 
  
 "db_pwd_secret_name" 
  
  
 } 
  
 }, 
  
 "cloud_properties" 
 : 
  
 { 
  
 "project_id" 
 : 
  
 "my-project" 
 , 
  
 "instance_name" 
 : 
  
 "bms-machine-1" 
 , 
  
 "region" 
 : 
  
 "us-central1" 
 , 
  
 "image" 
 : 
  
 "rhel-8" 
  
 }, 
  
 "hana_monitoring_configuration" 
 : 
  
 { 
  
 "enabled" 
 : 
  
 false 
  
 } 
 } 

Configuration parameters

The following table explains the configuration parameters of Google Cloud's Agent for SAP that are specific to the collection of the Process Monitoring metrics.

View the collected metrics

To visualize the Process Monitoring metrics that the agent collects, you can use the following custom dashboards that Google Cloud provides:

• Agent for SAP - HANA Overview: This dashboard provides charts that display status overview for the following metrics: SAP HANA Availability, SAP HANA HA Availability, SAP HANA HA Replication, SAP HANA Service Status, HA Cluster - Node State, and HA Cluster - Resource State for SAP Instances.

  The JSON file for this dashboard is sap-agent-status-overview.json .

• Agent for SAP - HANA Raw Metrics: This dashboard provides charts that display raw metric values for the following metrics: SAP HANA Availability, SAP HANA HA Availability, SAP HANA HA Replication, SAP HANA Service Status, HA Cluster - Node State, and HA Cluster - Resource State for SAP Instances.

  The JSON file for this dashboard is sap-agent-raw-metrics.json .

Install dashboards

To install a custom dashboard, complete the following steps:

View the installed dashboards

To view the installed dashboards, follow these steps:

1. In the Google Cloud console, go to the Monitoringpage:

   Go to Monitoring

2. In the Monitoring navigation panel, click Dashboards.

3. Click the dashboard name in the list.

If you have a lot of dashboards, then you can filter for custom dashboards or for the name of the new dashboard. For information on filtering this list, see View custom dashboards .

The following image is an example that shows a part of the custom dashboard for SAP HANA metrics in Monitoring.