Google Cloud 的 Agent for SAP 設定指令

Version 3.8 (latest)keyboard_arrow_down

• 版本 3.8 (latest)
• 第 2 版
• 第 1 版

本文將說明可用來修改 Google Cloud適用於 SAP 的代理程式設定的指令。這些指令自 3.2 版的代理程式起便受支援。

設定指令是編輯代理程式設定檔的替代方案：/etc/google-cloud-sap-agent/configuration.json。在代理程式 3.6 版之前，執行任何設定指令也會重新啟動代理程式，確保變更生效。從代理程式 3.7 版開始，更新後的設定會在變更後的 30 秒內自動套用。

代理程式重新啟動限制

您最多可在 60 秒內重新啟動 Google Cloud的 Agent for SAP 3 次。在此期間，您可以繼續執行設定指令來設定代理程式，但超過此限制的所有自動重新啟動作業都會失敗，並顯示輸出內容：Could not restart the agent。

如果您看到這項輸出內容，請在執行所有必要的設定指令後，手動重新啟動代理程式，變更才會生效。如需操作說明，請參閱「重新啟動代理程式」。

說明指令

• 如要列印代理程 google_cloud_sap_agent configure 指令的摘要說明並退出：

  sudo /usr/bin/google_cloud_sap_agent configure -help

• 如要列印代理程式執行個體功能的狀態，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -showall

• 如何列印代理程式執行個體的版本：

  sudo /usr/bin/google_cloud_sap_agent configure -version

如要瞭解 google_cloud_sap_agent configure 指令支援的引數，請參閱「支援的引數」。

頂層設定

• 如要為 Bare Metal 解決方案伺服器設定代理程式，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable

  如要為 Compute Engine 執行個體設定代理程式，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable

• 如要設定代理程式的記錄層級，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL

  將 LOG_LEVEL 替換為下列任一支援的記錄層級：debug、info、warn 或 error。

針對 SAP 系統探索

• 如要讓代理程式收集 SAP 系統使用的 SAP 產品名稱和版本，請按照下列步驟操作：

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

  如要停止代理程式收集 SAP 系統使用的 SAP 產品名稱和版本，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable

• 如要讓代理程式將所偵測到的 SAP 系統資訊傳送至 Cloud Logging，以及傳送至 Workload Manager (如果 Google Cloud 專案中啟用了 Workload Manager API)：

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

  如要停止讓代理程將發現的資訊傳送至 Cloud Logging 和 Workload Manager，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable

針對 SAP Host Agent 指標收集

• 如要讓代理程式收集 SAP Host Agent 指標，請按照下列步驟操作：

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

  如要停止收集 SAP Host Agent 指標，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable

收集代理程式健康指標

• 如要啟用代理程式健康指標收集功能，請按照下列步驟操作：

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

  如要停用收集代理程式健康指標的功能，請按照下列步驟操作：

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

• 如要修改代理程式收集其 Daemon 程序的 CPU 和記憶體用量頻率，並將這些資料傳送至 Cloud Monitoring，請按照下列步驟操作：

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

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

• 如要修改服務專員檢查自身運作健康狀態的頻率，並將相關資訊傳送至 Cloud Monitoring，請按照下列步驟操作：

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

針對程序監控指標收集

• 如要讓代理程式收集程序監控指標，請按照下列步驟操作：

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

  如要停止收集 Process Monitoring 指標，請按照下列步驟操作：

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

• 如要修改代理程式必須收集快速變化的程序監控指標的頻率，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY

  如要修改代理程式必須收集變化緩慢的程序監控指標的頻率，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY

  將 FREQUENCY 替換為代理程式必須收集指標的頻率 (以秒為單位)。

• 如要停止收集任何 Process Monitoring 指標，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add

  如要恢復收集代理程式停止的任何 Process Monitoring 指標，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove

  將 LIST_OF_METRICS 替換為您要讓代理程恢復收集的程序監控指標名稱。請使用半形逗號分隔指標名稱。

針對 Workload Manager 評估指標收集

• 如要讓代理程式收集 Workload Manager 評估指標，請按照下列步驟操作：

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

• 如要停止收集 Workload Manager 評估指標，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -disable

• 如要修改代理程式必須收集 Workload Manager 評估指標的頻率，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_metrics_frequency=FREQUENCY

  將 FREQUENCY 替換為代理程式必須收集工作負載管理工具評估指標的頻率 (以秒為單位)。

• 如要修改代理程式必須收集 SAP HANA 資料庫指標的頻率，以便 Workload Manager 進行評估，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_db_metrics_frequency=FREQUENCY

  將 FREQUENCY 替換為代理程式必須收集 SAP HANA 資料庫指標的頻率 (以秒為單位)，以便 Workload Manager 進行評估。

收集 SAP HANA 監控指標

• 如要讓代理程式收集 SAP HANA 監控指標，請按照下列步驟操作：

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

  如要停止收集 SAP HANA 監控指標，請按照下列步驟操作：

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

• 如要修改代理程式必須收集 SAP HANA 監控指標的取樣間隔，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL

  將 SAMPLE_INTERNAL 替換為間隔時間 (以秒為單位)。間隔時間必須為 5 秒以上。

• 如要修改對 SAP HANA 執行個體提出查詢的逾時值，請按照下列步驟操作：

  sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT

  將 QUERY_TIMEOUT 替換為以秒為單位的值。

支援的引數

下表說明可與 google_cloud_sap_agent configure 指令搭配使用的引數：