配置 Agent for SAP 以设置可观测性

预览版

此产品或功能 受服务专用条款的约束。 非正式版产品和功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

本文档介绍了如何配置 Google Cloud的 Agent for SAP，以使用 Workload Manager 为 SAP 工作负载设置可观测性。

Workload Manager 可观测性服务需要代理从 SAP 工作负载和底层基础设施收集指标。如需了解详情，请参阅 SAP 可观测性概览。

准备工作

• 验证您在运行 SAP 工作负载的所有 Compute Engine 实例上安装的 Google Cloud的 Agent for SAP，以便为这些工作负载设置可观测性。

  如需了解如何验证代理安装，请参阅验证代理安装。

• 验证您是否已满足 SAP 可观测性的前提条件。

为单可用区工作负载配置代理

虚拟机扩展程序管理器

此功能 受服务专用条款的约束。 非正式版功能“按原样”提供，且可能仅提供有限支持。 如需了解详情，请参阅发布阶段说明。

如需在一组 Compute Engine 实例上配置和管理代理，您必须为其创建虚拟机扩展管理器政策。

注意：如果您创建虚拟机扩展管理器政策以定位已在运行 Agent for SAP 的计算实例，则该政策会使用您在政策中定义的版本和配置来替换现有代理的版本和配置。

代理的现有配置会写入相应计算实例上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。

如需配置代理，以便为在单个可用区中运行的 SAP 工作负载设置可观测性，请完成以下步骤：

1. 设置虚拟机扩展程序管理器：

   • 在 VM Extension Manager 文档中，查看准备工作部分。

   • 设置创建和管理虚拟机扩展程序管理器政策所需的 IAM 角色。如需了解详情，请参阅以下内容：

     • 创建虚拟机扩展程序政策
     • 更新虚拟机扩展程序政策
     • 删除虚拟机扩展程序政策
     • 列出并描述虚拟机扩展程序政策

2. 创建虚拟机扩展政策，以在运行 SAP 工作负载的计算实例上安装和管理 Google Cloud的 Agent for SAP：

   • 在 SAP 工作负载运行的可用区中创建虚拟机扩展程序政策。如需了解如何创建此类虚拟机扩展程序政策，请参阅创建区域级虚拟机扩展程序政策。
   • 如需查看可观测性的代理配置示例，请参阅代理配置示例。

软件包管理系统

如果您手动管理代理生命周期，而不是使用虚拟机扩展管理器，则可以使用软件包管理器配置 Google Cloud的 Agent for SAP：

1. 与运行 SAP 工作负载的计算实例建立 SSH 连接。

2. 验证您运行的是最新版本的 Agent for SAP。

   如需了解如何更新代理，请参阅更新 Google Cloud的 Agent for SAP。

3. 如需让代理查找有关 SAP 工作负载的详细信息并将其发送到 Workload Manager，请执行以下操作：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
   sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
   

4. 启用代理以从 SAP 工作负载中运行的进程收集指标：

   1. 启用代理的进程监控功能：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
   

   1. 如需让代理收集与 SAP HANA 数据库实例相关的进程指标，您需要在 hana_metrics_config 部分中配置其他参数。

   如需了解详情，请参阅配置进程监控指标收集。

5. 使代理能够从 SAP 工作负载中运行的 SAP HANA 实例收集指标：

   1. 启用代理的 SAP HANA 监控功能：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
   

   1. 如需让代理与 SAP HANA 实例连接并收集指标，您需要配置其他参数。

   如需了解详情，请参阅配置 SAP HANA 监控指标收集。

6. 保存配置文件。

如需查看可观测性的代理配置示例，请参阅代理配置示例。

为多可用区工作负载配置代理

虚拟机扩展程序管理器

此功能 受服务专用条款的约束。 非正式版功能“按原样”提供，且可能仅提供有限支持。 如需了解详情，请参阅发布阶段说明。

如需在一组 Compute Engine 实例上配置和管理代理，您必须为其创建虚拟机扩展管理器政策。

注意：如果您创建虚拟机扩展管理器政策以定位已在运行 Agent for SAP 的计算实例，则该政策会使用您在政策中定义的版本和配置来替换现有代理的版本和配置。

代理的现有配置会写入相应计算实例上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。

如需配置代理，以便为在两个或更多可用区中运行的 SAP 工作负载设置可观测性，请完成以下步骤：

1. 设置虚拟机扩展程序管理器：

   • 在 VM Extension Manager 文档中，查看准备工作部分。

   • 设置创建和管理虚拟机扩展程序管理器政策所需的 IAM 角色。如需了解详情，请参阅以下内容：

     • 创建虚拟机扩展程序政策
     • 更新虚拟机扩展程序政策
     • 删除虚拟机扩展程序政策
     • 列出并描述虚拟机扩展程序政策

2. 创建虚拟机扩展政策，以在运行 SAP 工作负载主站点的计算实例上安装和管理 Google Cloud的 Agent for SAP：

   • 在 SAP 工作负载的主站点运行的可用区中创建虚拟机扩展程序政策。如需了解如何创建此类虚拟机扩展程序政策，请参阅创建区域级虚拟机扩展程序政策。
   • 如需查看可观测性的代理配置示例，请参阅代理配置示例。

3. 如果您运行的是高可用性 SAP 工作负载，或者为 SAP 工作负载设置了灾难恢复 (DR) 站点，请创建虚拟机扩展政策，以在运行 SAP 工作负载的辅助站点或灾难恢复站点的计算实例上安装和管理 Google Cloud的 Agent for SAP。

软件包管理系统

如果您手动管理代理生命周期，而不是使用虚拟机扩展管理器，则可以使用软件包管理器配置 Google Cloud的 Agent for SAP：

1. 与运行 SAP 工作负载的计算实例建立 SSH 连接。

2. 验证您运行的是最新版本的 Agent for SAP。

   如需了解如何更新代理，请参阅更新 Google Cloud的 Agent for SAP。

3. 如需让代理收集有关 SAP 工作负载的详细信息并将其发送到 Workload Manager，请执行以下操作：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
   sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
   

4. 启用代理以从 SAP 工作负载中运行的进程收集指标：

   1. 启用代理的进程监控功能：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
   

   1. 如需让代理收集与 SAP HANA 数据库实例相关的进程指标，您需要在 hana_metrics_config 部分中配置其他参数。

   如需了解详情，请参阅配置进程监控指标收集。

5. 使代理能够从 SAP 工作负载中运行的 SAP HANA 实例收集指标：

   1. 启用代理的 SAP HANA 监控功能：

   sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
   

   1. 如需让代理与 SAP HANA 实例连接并收集指标，您需要配置其他参数。

   如需了解详情，请参阅配置 SAP HANA 监控指标收集。

6. 保存配置文件。

7. 如果您运行的是高可用性 SAP 工作负载，或者为 SAP 工作负载设置了灾难恢复 (DR) 站点，请针对运行 SAP 工作负载的所有其他计算实例重复此过程。

如需查看可观测性的代理配置示例，请参阅代理配置示例。

验证 Workload Manager 可观测性功能的设置

您可以通过运行代理的 status 命令，验证自己是否已进行了正确的 Google Cloud 设置，以便使用 Workload Manager 可观测性服务。

如需验证 Google Cloud 设置，请完成以下步骤：

1. 与运行 SAP 工作负载的 Compute Engine 实例建立 SSH 连接。

2. 检查可观测性的 Google Cloud 设置：

   sudo /usr/bin/google_cloud_sap_agent status
   

   如果您为使用 Workload Manager 可观测性服务进行了正确的 Google Cloud 设置，则输出将包含以下内容。 您的配置可能具有 default 之外的其他值。

   Agent Status:
       Installed version: 3.10-....
       ...
       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
   ...
   ----------------------------------------------------------------------------
   Process Metrics: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           collect_process_metrics:        true (configuration file)
           process_metrics_frequency:      30    (default)
           process_metrics_to_skip:        []   (default)
           slow_process_metrics_frequency: 120   (default)
   ...
   ----------------------------------------------------------------------------
   HANA Monitoring Metrics: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           connection_timeout:       120   (default)
           enabled:                  true  (configuration file)
           execution_threads:        10    (default)
           max_connect_retries:      1     (default)
           query_timeout_sec:        300   (default)
           sample_interval_sec:      300   (default)
           send_query_response_time: false (default)
   ...
   ----------------------------------------------------------------------------
   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)
   ...
   

3. 如果输出表明缺少某些设置，请查看前面部分中提供的信息，执行所需的操作，然后重新运行 status 命令以重新验证设置。

4. 如果您使用多个计算实例来运行工作负载，请针对运行工作负载的所有其他计算实例重复执行此过程。

代理配置示例

以下示例是 Google Cloud的 Agent for SAP 的已完成配置文件，该代理配置为支持 SAP HANA 工作负载的可观测性：

以下示例使用安全用户存储区 (hdbuserstore) 中的密钥进行 SAP HANA 身份验证：

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
      "collect_workload_validation_metrics": true,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

以下示例使用用户名和 Secret Manager 中的 Secret 进行 SAP HANA 身份验证：

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
      "collect_workload_validation_metrics": true,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

以下示例使用用户名和密码进行 SAP HANA 身份验证。我们建议您改用安全用户存储区 (hdbuserstore) 中的密钥或 Secret Manager 中的 Secret 进行 SAP HANA 身份验证。

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
      "collect_workload_validation_metrics": true,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

如需了解代理支持的配置参数，请参阅配置参数。

后续步骤

• 成功完成 SAP 工作负载的可观测性设置后，该工作负载最多需要 15 分钟才能显示在 Google Cloud 控制台的 Workload Manager 可观测性页面中。

  如需了解如何观测 SAP 工作负载，请参阅查看 SAP 的可观测性指标。