設定代理程式健康指標收集

本指南說明如何設定 Google Cloud的 SAP 代理程式，以便在 Compute Engine 執行個體或裸機解決方案伺服器上，從代理程式的守護程式程序收集健康指標。

如需這項功能的相關資訊，請參閱「代理程式健康指標收集」。

事前準備

• 驗證 Google Cloud的 Agent for SAP 安裝作業。如需操作說明，請參閱適用於您情況的安裝指南。
• 如果您已在 Bare Metal 解決方案伺服器上安裝代理程式，請確認您已完成必要的先決條件，並設定服務帳戶。如需操作說明，請參閱「在 Linux 上設定 Google Cloud的 Agent for SAP」。

必要的角色

為確保服務帳戶具備必要權限，讓 Google Cloud的 SAP 代理程式收集代理程式健康狀況指標，請要求管理員將下列 IAM 角色授予服務帳戶：

• Monitoring 指標寫入者 (roles/monitoring.metricWriter)： 將收集到的指標寫入 Cloud Monitoring。

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色具備必要權限，可讓 Google Cloud的 Agent for SAP 收集 Agent Health 指標。如要查看確切的必要權限，請展開「必要權限」部分：

您的管理員也可能會透過自訂角色或其他預先定義的角色，將這些權限授予服務帳戶。

啟用代理健康指標收集功能

如要讓 Google Cloud的 SAP 專用代理程式收集主機上 Daemon 程序的健康指標，請按照下列步驟操作：

1. 與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。

2. 啟用收集代理程式健康指標的功能：

   執行指令

   1. 如要啟用收集代理程式健康指標的功能，請執行下列指令：

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

   2. 您可以視需要修改代理程式收集其守護程式程序的 CPU 和記憶體用量，並將這些資料傳送至 Cloud Monitoring 的頻率。預設頻率為 60 秒。

      如要修改這個頻率，請執行下列指令：

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

      將 FREQUENCY 替換為秒數的必要值。頻率不得少於 5 秒。

   3. 您可以視需要修改服務專員檢查自身運作健康狀態的頻率，並將該資訊傳送至 Cloud Monitoring。預設頻率為 60 秒。

      如要修改此頻率，請執行下列指令。頻率不得低於 5 秒。

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

   編輯設定檔

   除了執行代理程式指令之外，您也可以手動修改代理程式設定，步驟如下：

   1. 開啟 Backint 設定檔：

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

   2. 在 collection_configuration 部分中加入以下內容：

      "collect_agent_metrics": true

   3. 您可以視需要修改代理程式收集其守護程式程序的 CPU 和記憶體用量，並將這些資料傳送至 Cloud Monitoring 的頻率。預設頻率為 60 秒。

      如要修改這個頻率，請在 collection_configuration 區段中加入以下內容。

      "agent_metrics_frequency": FREQUENCY

      將 FREQUENCY 替換為秒數的必要值。頻率不得少於 5 秒。

   4. 您可以視需要修改服務專員檢查自身運作健康狀態的頻率，並將這項資訊傳送至 Cloud Monitoring。預設頻率為 60 秒。

      如要修改這個頻率，請在 collection_configuration 區段中加入以下內容。頻率不得低於 5 秒。

      "agent_health_frequency": FREQUENCY

   5. 儲存設定檔。

   6. 重新啟動代理程式，讓新設定生效：

      sudo systemctl restart google-cloud-sap-agent

設定檔範例

{
  "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": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

設定參數

下表說明Google Cloud的 Agent for SAP 設定參數，這些參數適用於收集代理程式健康指標：