Meta tags:
description=Install Google Cloud s Agent for SAP and enable the collection of evaluation metrics before you evaluate SAP workloads using Workload Manager.;

Headings (most frequently used words):

the, agent, and, on, install, fleet, of, vms, configure, manager, for, rhel, sles, global, vm, to, console, gcloud, update, set, up, your, by, using, manage, extension, workload, evaluation, metrics, collection, configuration, cloud, sles15, 12, zonal, within, policy, zones, sap, workloads, stay, organized, with, collections, save, categorize, content, based, preferences, before, you, begin, package, verify, version, validate, setup, example, file, what, next, required, iam, roles, enable, access, apis, uninstall, from, check, updates, an, products, pricing, support, resources, engage, google, project, specific, zone, modify, include, new, exclude,

Text of the page (most frequently used words):
the (438), agent (162), for (151), sap (140), cloud (120), #google (114), you (106), #policy (105), extension (87), and (78), that (69), manager (64), your (62), configuration (60), vms (50), workload (46), following (44), rollout (41), install (40), compute (39), true (38), see (35), config (35), information (34), from (32), global (32), file (31), update (31), zone (31), policies (29), use (28), then (27), can (26), labels (26), all (25), command (24), using (24), about (23), instance (23), service (23), version (23), plan (23), project (23), more (22), custom (22), gcloud (22), with (21), supported (21), sudo (21), priority (20), want (19), yum (19), fleet (19), are (18), parameters (18), hana (18), false (18), evaluation (18), workloads (18), description (18), terms (17), access (17), this (16), secret (16), default (16), configure (16), roles (16), apply (15), create (15), enabled (14), which (14), set (14), metrics (14), specific (14), policy_name (14), specify (14), authentication (13), key (13), run (13), have (13), steps (13), not (13), name (13), delete (13), modify (13), system (12), example (12), complete (12), section (12), click (12), targets (12), inclusion (12), account (12), uses (11), specified (11), option (11), iam (11), replace (11), zypper (11), x86_64 (11), project_id (11), beta (11), uuid (11), https (11), com (11), running (10), where (10), might (10), list (10), pre (10), within (10), packages (10), deployment (10), manage (9), instead (9), user (9), collection (9), values (9), available (9), latest (9), either (9), predefined (9), any (9), zones (9), extensions (9), config_file_path (9), existing (9), resources (8), support (8), hana_db_user (8), collect_workload_validation_metrics (8), required (8), etc (8), version_number (8), but (8), both (8), same (8), rollout_plan_option (8), console (8), must (8), new (8), flag (8), best (8), repos (8), observability (8), deploy (8), status (7), thumb (7), need (7), oracle (7), enable_workload_discovery (7), enable_discovery (7), port (7), workload_validation_db_metrics_config (7), 3600 (7), workload_validation_db_metrics_frequency (7), hdbuserstore_key (7), parameter (7), one (7), json (7), recommended (7), value (7), value_1 (7), key_1 (7), optional (7), enable (7), practices (7), sql (7), server (7), page (6), evaluations (6), password (6), hana_monitoring_configuration (6), discovery_configuration (6), collect_process_metrics (6), hostname (6), deh (6), sid (6), collection_configuration (6), log_to_cloud (6), info (6), log_level (6), bare_metal (6), provide_sap_host_agent_metrics (6), engine (6), setup (6), permissions (6), establish (6), ssh (6), connection (6), versions (6), alternatively (6), plans (6), zonal (6), feature (6), retry (6), omit (6), field (6), apis (6), prerequisites (6), overview (6), code (5), content (5), recommend (5), store (5), hdbuserstore (5), hana_db_password_secret_name (5), provided (5), perform (5), such (5), gpg (5), recommends (5), specifying (5), subject (5), offerings (5), general (5), features (5), limited (5), launch (5), stage (5), descriptions (5), preview (5), lower (5), restart (5), match (5), local (5), instances (5), how (5), already (5), note (5), management (5), data (5), database (5), rules (5), português (4), español (4), other (4), down (4), what (4), username (4), 30015 (4), localhost (4), hana_db_password (4), secure (4), preferred (4), over (4), only (4), validate (4), scopes (4), granted (4), number (4), sles (4), rhel (4), select (4), these (4), add (4), fast_rollout (4), slow_rollout (4), located (4), request (4), terminal (4), when (4), after (4), include (4), integer (4), 65535 (4), priority_number (4), multiple (4), times (4), selectors (4), logical (4), targeted (4), comma (4), separated (4), pairs (4), define (4), provide (4), inline (4), string (4), path (4), contains (4), done (4), enter (4), test (4), tasks (4), security (4), addrepo (4), refresh (4), sles15 (4), eom (4), doc (4), package (4), tools (4), application (4), samples (3), release (3), updated (3), details (3), send (3), files (3), correct (3), usr (3), 606637668 (3), operating (3), follow (3), updates (3), check (3), because (3), deletion (3), manages (3), uninstall (3), installed (3), based (3), unique (3), identifier (3), identifies (3), projects (3), shell (3), exclude (3), also (3), value_3 (3), key_3 (3), value_2 (3), key_2 (3), numbers (3), indicate (3), higher (3), 1000 (3), overrides (3), written (3), bak (3), directory (3), respective (3), connect (3), subset (3), identified (3), documentation (3), before (3), collect (3), private (3), control (3), administrator (3), grant (3), regions (3), solutions (3), systems (3), monitoring (3), guides (3), troubleshoot (3), post (3), deploying (3), 4hana (3), 한국어 (2), 日本語 (2), עברית (2), brasil (2), italiano (2), indonesia (2), français (2), américa (2), latina (2), deutsch (2), english (2), sign (2), site (2), youtube (2), started (2), pricing (2), products (2), understand (2), missing (2), last (2), 2026 (2), utc (2), licensed (2), under (2), license (2), feedback (2), next (2), temppa55word (2), user_store_key (2), order (2), preference (2), examples (2), completed (2), output (2), review (2), sections (2), systemd (2), fully (2), functional (2), than (2), bin (2), google_cloud_sap_agent (2), ensure (2), change (2), used (2), removes (2), minute (2), applies (2), universally (2), generator (2), creating (2), new_custom_plan_name (2), supply (2), out (2), automatically (2), acts (2), replacement (2), fields (2), revert (2), their (2), retaining (2), modified (2), save (2), edit (2), changes (2), named (2), deployed (2), applied (2), defines (2), limit (2), var (2), begin (2), managed (2), installation (2), shows (2), skip (2), insights (2), let (2), sles12 (2), tee (2), repo (2), baseurl (2), cat (2), redhat (2), cut (2), gpgcheck (2), repo_gpgcheck (2), gpgkey (2), rpm (2), host (2), logs (2), logging (2), writer (2), write (2), viewer (2), has (2), sdk (2), languages (2), frameworks (2), infrastructure (2), costs (2), usage (2), storage (2), networking (2), migration (2), industry (2), distributed (2), hybrid (2), multicloud (2), databases (2), analytics (2), pipelines (2), hosting (2), development (2), view (2), guided (2), automation (2), evaluate (2), redis (2), mysql (2), cross (2), product (2), reference (2), technology (2), areas (2), close (2), subscribe, newsletter, our, third, decade, climate, action, join, cookies, privacy, tech, twitter, events, blog, engage, training, certification, architecture, center, getting, github, notes, community, forums, contact, sales, marketplace, easy, easytounderstand, solved, problem, solvedmyproblem, otherup, hard, hardtounderstand, incorrect, sample, incorrectinformationorsamplecode, missingtheinformationsamplesineed, otherdown, tell, except, otherwise, noted, java, registered, trademark, its, affiliates, developers, apache, creative, commons, attribution, learn, conveys, some, preceding, actions, api, full, valid, discovery, sap_instances_update_frequency, system_discovery_update_frequency, 14400, config_target_environment, production, fetch_latest_config, workload_validation_metrics_frequency, 300, includes, ones, workload_manager, sap_discovery, checks, nogpgcheck, periodically, accurate, periodic, releases, verify, confirm, accessible, inaccessible, removed, deleted, skips, becomes, again, time, guest, while, deleting, another, active, declares, remains, locations, rolloutplans, specifies, follows, entry, created, rolled, does, toggle, tab, show, rolls, applicable, typically, uninstalled, whether, central1, creates, installs, centrail, fails, exists, identify, directs, leave, blank, lists, region, resolve, conflicts, between, conflict, resolution, value2, key2, value1, key1, appropriate, describe, needed, wide, lets, successfully, restarts, starts, sending, systemctl, seconds, settings, take, effect, authenticates, alternative, stores, accepts, queries, machine, remote, hosts, query, workload_evaluation, downgrading, downgrade, applications, doesn, external, address, subnet, services, practice, www, googleapis, auth, platform, requires, minimum, configuring, allow, able, give, through, granting, folders, organizations, secretmanager, secretaccessor, accessor, logwriter, warehouse, workloadmanager, insightwriter, failure, principal, result, permission, errors, important, necessary, authenticate, ask, improve, rather, single, purpose, attached, reviewed, make, sure, met, linux, windows, detect, metadata, evaluating, configurations, along, including, netweaver, ase, maxdb, categorize, preferences, stay, organized, collections, home, issues, dashboards, observe, export, prepare, cmek, rego, implement, results, history, openshift, vpc, controls, consumer, target, agents, get, discover, start, free, main,

Text of the page (random words):
tions to modify the configuration of agent for sap on vms in your google cloud project run the gcloud beta compute global vm extension policies update command when you update a policy by using gcloud the request acts as a complete replacement any optional fields you omit revert to their default values instead of retaining existing values from the modified policy to modify agent configuration gcloud beta compute global vm extension policies update policy_name project project_id extensions google cloud sap extension rollout predefined plan rollout_plan_option config from file google cloud sap extension config_file_path inclusion labels key_1 value_1 inclusion labels key_2 value_2 key_3 value_3 priority priority_number description description replace the following policy_name the name of the vm extension policy that you want to modify project_id the id of the google cloud project where the policy is located rollout_plan_option the rollout option that you want to apply to your global policy the supported values are slow_rollout recommended and fast_rollout alternatively you can use a custom rollout plan by specifying the rollout custom plan option for more information see about rollout plans you can use either rollout predefined plan or rollout custom plan but not both in the same command config_file_path the local path to the json file that contains the configuration for the agent for sap you can also provide the agent configuration as an inline string by using the config flag instead of config from file for example config google cloud sap extension config google cloud recommends that you use config from file you can use either config from file or config but not both in the same command for information about the configuration parameters supported by the agent see configuration parameters key_1 value_1 a comma separated list of key value pairs that define the labels using which the policy targets vms for a vm to be targeted by your policy the vm must have all the specified labels if you specify inclusion labels multiple times then the policy targets vms that match any of the provided selectors logical or if you omit this flag then the policy targets all vms in the project priority_number the priority that you want to set for your policy you can specify an integer from 0 to 65535 description a description of the vm extension policy update a global policy to include new zones preview global vm extension manager policy this feature is subject to the pre ga offerings terms in the general service terms section of the service specific terms pre ga features are available as is and might have limited support for more information see the launch stage descriptions when you create vms in a new zone after you ve created and rolled out a global policy vm extension manager does not automatically apply the policy to the vms in the new zones to include the vms in new zones you must restart the global policy rollout to restart a global policy rollout complete the following steps in your terminal or cloud shell run the gcloud beta compute global vm extension policies update command and supply the rollout entry uuid option as follows gcloud beta compute global vm extension policies update policy_name project project_id extensions google cloud sap extension rollout predefined plan rollout_plan_option config from file google cloud sap extension config_file_path rollout retry uuid uuid replace the following uuid a universally unique identifier uuid that identifies the retry request you can use any uuid generator to create one for more information see retry a rollout rollout_plan_option the rollout option that you want to apply to your global policy the supported values are slow_rollout recommended and fast_rollout alternatively you can use a custom rollout plan by specifying the rollout custom plan option for more information see about rollout plans you can use either rollout predefined plan or rollout custom plan but not both in the same command update a global policy to exclude zones preview global vm extension manager policy this feature is subject to the pre ga offerings terms in the general service terms section of the service specific terms pre ga features are available as is and might have limited support for more information see the launch stage descriptions to update a global policy to exclude zones complete the following steps in your terminal or cloud shell run the gcloud beta compute global vm extension policies update command and supply a custom rollout plan that specifies the zones in which to apply the policy gcloud beta compute global vm extension policies update policy_name project project_id extensions google cloud sap extension rollout custom plan projects project_id locations global rolloutplans new_custom_plan_name rollout retry uuid uuid replace the following new_custom_plan_name the name of the new custom rollout plan that identifies the zones in which to apply the policy for information about creating custom rollout plans see about rollout plans uuid a universally unique identifier uuid that identifies the retry request you can use any uuid generator to create one for more information see retry a rollout uninstall agent from a vm fleet to uninstall agent for sap from your vm fleet you must delete the vm extension manager policy that manages the vm fleet while deleting a policy if another active lower priority policy applies to a vm and declares the agent for sap then the agent remains installed on that vm based on the lower priority policy vm extension manager removes the agent from all accessible vms within one minute of policy deletion if a vm is inaccessible because the guest agent is removed or the vm is deleted then vm extension manager skips deletion of the agent for sap if such a vm becomes available again then vm extension manager removes the agent for sap at that time to uninstall agent for sap from your vm fleet complete the following steps console in the google cloud console go to the vm extension policies page go to vm extension policies click the policy that manages the agent for sap on your vm fleet in the extension policy details page click delete and confirm the deletion gcloud zonal to delete a zonal vm extension manager policy use the gcloud beta compute zone vm extension policies delete command gcloud compute zone vm extension policies delete policy_name project project_id zone zone replace the following policy_name the name of the zonal policy that you want to delete project_id the id of the google cloud project where the policy is located zone the google cloud zone where the policy is located global preview global vm extension manager policy this feature is subject to the pre ga offerings terms in the general service terms section of the service specific terms pre ga features are available as is and might have limited support for more information see the launch stage descriptions to delete a global vm extension manager policy use the gcloud beta compute global vm extension policies delete command gcloud beta compute global vm extension policies delete policy_name project project_id rollout predefined plan rollout_plan_option replace the following policy_name the name of the zonal policy that you want to delete project_id the id of the google cloud project where the policy is located rollout_plan_option the rollout option that you want to apply to your global policy the supported values are slow_rollout recommended and fast_rollout alternatively you can use a custom rollout plan by specifying the rollout custom plan option for more information see about rollout plans you can use either rollout predefined plan or rollout custom plan but not both in the same command verify the agent version google cloud recommends that you install the latest version of agent for sap for accurate evaluation of your sap workloads because periodic releases of the agent for sap might add or change metrics that are used for the evaluation to ensure that you have the latest version of google cloud s agent for sap you need to check for updates periodically and update the agent check for updates select your operating system and then follow these steps rhel establish an ssh connection with your instance run the following command sudo yum check update google cloud sap agent sles establish an ssh connection with your instance run the following command sudo zypper list updates r google cloud sap agent install an update select your operating system and then follow the steps rhel establish an ssh connection with your instance update your agent instance recommended to update to version 3 15 latest of the agent sudo yum nogpgcheck update google cloud sap agent to update to a specific version of the agent sudo yum install google cloud sap agent version_number x86_64 replace version_number with the agent s version number that you want to install such as 3 1 606637668 for information about the agent versions that you can install see list all available versions of the agent sles establish an ssh connection with your instance update your agent instance recommended to update to version 3 15 latest of the agent sudo zypper no gpg checks update google cloud sap agent to update to a specific version of the agent sudo zypper install google cloud sap agent version_number x86_64 replace version_number with the agent s version number that you want to install such as 3 1 606637668 for information about the agent versions that you can install see list all available versions of the agent validate the setup for workload manager evaluation metrics collection you can validate if you have the correct google cloud setup for the collection of the workload manager evaluation metrics by running the agent s status command this command is supported from version 3 7 of the agent to validate the google cloud setup complete the following steps establish an ssh connection with your compute engine instance run the following command sudo usr bin google_cloud_sap_agent status f workload_manager sap_discovery if your google cloud setup for workload manager evaluation metrics collection is correct then the output includes the following your configuration might have values other than the default ones agent status systemd service enabled true systemd service running true cloud api full scopes true configuration file etc google cloud sap agent configuration json configuration valid true system discovery enabled status fully functional iam permissions all granted configuration enable_discovery true default enable_workload_discovery true default sap_instances_update_frequency 60 default system_discovery_update_frequency 14400 default workload manager evaluation enabled status fully functional iam permissions all granted configuration collect_workload_validation_metrics true default config_target_environment production default fetch_latest_config true default workload_validation_db_metrics_frequency 3600 default workload_validation_metrics_frequency 300 default if your output conveys that some setup is missing then review the information provided in the preceding sections perform the required actions and then re run the status command to re validate the setup example configuration file the following examples are completed configuration files of google cloud s agent for sap running on a compute engine instance where the collection of workload manager evaluation metrics is enabled for sap hana authentication the agent uses the following order of preference if specified the hdbuserstore_key configuration parameter is preferred over the hana_db_password parameter which is preferred over the hana_db_password_secret_name parameter we recommend that you set only one authentication option in your configuration file the following example uses a secure user store hdbuserstore key for sap hana authentication provide_sap_host_agent_metrics true bare_metal false log_level info log_to_cloud true collection_configuration collect_workload_validation_metrics true workload_validation_db_metrics_frequency 3600 workload_validation_db_metrics_config hana_db_user system sid deh hdbuserstore_key user_store_key collect_process_metrics false discovery_configuration enable_discovery true enable_workload_discovery true hana_monitoring_configuration enabled false the following example uses a username and secret manager secret for sap hana authentication provide_sap_host_agent_metrics true bare_metal false log_level info log_to_cloud true collection_configuration collect_workload_validation_metrics true workload_validation_db_metrics_frequency 3600 workload_validation_db_metrics_config hana_db_user system sid deh hana_db_password_secret_name instance id hana db password secret hostname localhost port 30015 collect_process_metrics false discovery_configuration enable_discovery true enable_workload_discovery true hana_monitoring_configuration enabled false the following example uses a username and password for sap hana authentication we recommend that you instead use a secret manager secret or secure user store hdbuserstore key for sap hana authentication provide_sap_host_agent_metrics true bare_metal false log_level info log_to_cloud true collection_configuration collect_workload_validation_metrics true workload_validation_db_metrics_frequency 3600 workload_validation_db_metrics_config hana_db_user system sid deh hana_db_password temppa55word hostname localhost port 30015 collect_process_metrics false discovery_configuration enable_discovery true enable_workload_discovery true hana_monitoring_configuration enabled false for information about the configuration parameters that are supported by agent for sap see configuration parameters what s next learn more about workload evaluations send feedback except as otherwise noted the content of this page is licensed under the creative commons attribution 4 0 license and code samples are licensed under the apache 2 0 license for details see the google developers site policies java is a registered trademark of oracle and or its affiliates last updated 2026 07 22 utc need to tell us more 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 2026 07 22 utc products and pricing see all products google cloud pricing google cloud marketplace contact sales support community forums support release notes system status resources github getting started with google cloud code samples cloud architecture center training and certification engage blog events x twitter google cloud on youtube google cloud tech on youtube about google privacy site terms google cloud terms manage cookies our third decade of climate action join us sign up for the google cloud newsletter su...