SAP HANA 監控代理程式 V2.0 規劃指南

有了 SAP HANA 適用的 Google Cloud 監控代理程式，您就可以使用 Cloud Monitoring 在 Google Cloud 主控台中顯示 SAP HANA 系統指標。代理程式會在主機上以 systemd 服務的形式執行。

為了收集指標，SAP HANA 監控代理程式會使用 SAP 在 SAP HANA SQL 和系統檢視表參考資料中定義的 SQL 語法和系統檢視表，查詢 SAP HANA。

您可以使用 SAP HANA 記憶體使用率指標進行容量規劃，或協助管理以記憶體為基礎的 SAP HANA 授權。將 SAP HANA 指標與 Compute Engine 指標做關聯，有助於您找出使用量和效能趨勢。

如要進一步瞭解 SAP HANA 安裝作業，您可以定義自訂查詢來擷取其他指標。

有了 Cloud Monitoring，您可以建立資訊主頁，藉此將 SAP HANA 指標視覺化，並可根據指標門檻來設定快訊。如需有關如何設定資訊主頁和快訊的完整資訊，請參閱 Cloud Monitoring 說明文件。

Cloud Monitoring 指標定價

SAP HANA 監控代理程式收集並傳送至 Monitoring 的指標，會被歸類為 計費指標。依據擷取的資料量，監控可計費指標的價格。

查詢的取樣間隔會決定 SAP HANA 監控代理程式向 SAP HANA 查詢指標的頻率，進而影響傳送至 Monitoring 的指標量。

如要進一步瞭解 Monitoring 的定價，請參閱 Google Cloud Observability 的定價。

如要進一步瞭解查詢取樣間隔，請參閱「查詢的取樣間隔」。

查詢：預設和自訂

SAP HANA 監控代理程式會使用 SQL 查詢從 SAP HANA 收集指標。代理程式包含一組預設查詢，您可以新增自訂查詢。

預設查詢和自訂查詢都會擷取由 SAP HANA 系統檢視表定義的指標，這些檢視表的說明可參閱 SAP HANA SQL 和系統檢視表參考資料。

預設查詢類型

預設查詢是內建查詢，可收集最常用的 SAP HANA 指標。

預設查詢的頻率取決於 configuration.yaml 檔案開頭的全球 sample_interval 屬性。預設值為 300 秒 (5 分鐘)。您可以修改這個全域預設值。與自訂查詢不同的是，您無法為個別預設查詢設定取樣間隔。

雖然您無法修改預設查詢，但可以在代理程式設定檔 configuration.yaml 中停用任何不需要的預設查詢。

如要進一步瞭解預設查詢、查詢收集的指標，以及查詢使用的基礎 SQL 陳述式，請參閱「預設查詢參考資料」。

自訂查詢類型

您可以在 SAP HANA 監控代理程式的 configuration.yaml 檔案中定義自訂查詢。

針對自訂查詢，您可以為每個查詢指定 _sample_interval_，以便覆寫所有查詢的預設取樣間隔。詳情請參閱「查詢的取樣間隔」。

configuration.yaml 檔案包含兩個預設停用的自訂查詢範例。您可以將提供的自訂查詢做為自訂查詢的模型。下方的自訂查詢範例中列出自訂查詢範例。

自訂查詢的錯誤處理

代理程式不會在將查詢提交至 SAP HANA 前，驗證自訂查詢中的 SQL。

如果自訂查詢因 SQL 例外狀況而失敗，或是查詢中設定的資料欄與 SAP HANA 傳回的結果不符，代理程式就會將錯誤寫入記錄檔。無論是哪種情況，代理程式都會繼續執行自訂查詢，並將錯誤訊息寫入記錄，直到自訂查詢修正為止。

如需有關自訂查詢所需 SQL 語法的資訊，請參閱 SAP HANA SQL 和系統檢視表參考資料。

查詢的取樣間隔

您可以為所有查詢定義全域取樣間隔，以及為自訂查詢定義個別取樣間隔。取樣間隔會決定監控代理程式向 SAP HANA 查詢指標的頻率。

所有查詢的預設取樣間隔為 300 秒 (5 分鐘)。您可以在 configuration.yaml 檔案開頭的 sample_interval 屬性中指定不同的值，藉此調整預設的取樣間隔。

您可以在查詢定義中指定 sample_interval 屬性，藉此覆寫個別自訂查詢的預設取樣間隔。

安裝架構

您可以在 Compute Engine VM 或裸機解決方案伺服器上安裝 SAP HANA 的監控代理程式。

您可以在 SAP HANA 所在的主機上或其他主機上安裝代理程式。

代理程式也可以監控在內部主機或其他雲端平台主機上執行的 SAP HANA 執行個體，只要主機有權存取Google Cloud API，且服務帳戶已適當設定即可。

從集中式 Compute Engine VM 進行遠端收集

下圖顯示安裝架構，其中代理程式會安裝在不同的主機 VM 上，而非執行 SAP HANA 執行個體的 VM 或伺服器。

Compute Engine VM 和 Bare Metal 解決方案伺服器上的本機收集

如果防火牆規則限制了對環境的存取權，您可以在相同的 Compute Engine VM 或 Bare Metal Solution 伺服器上，安裝代理程式和 SAP HANA 執行個體。

下圖顯示安裝架構，其中代理程式會個別安裝在 Compute Engine VM 和 Bare Metal Solution 伺服器上。

混合式收集架構

您也可以在 SAP HANA 執行個體所在的相同主機 VM 上安裝代理程式，並將代理程式設為監控裸機解決方案伺服器上的 SAP HANA 執行個體。

如果您要監控多個 Google Cloud 專案中的 SAP HANA 執行個體，則必須在每個 Google Cloud 專案中安裝至少一個 SAP HANA 監控代理程式，且該專案必須包含您要監控的 SAP HANA 執行個體。

SAP HANA 監控代理程式高可用性設定

如果您要監控高可用性叢集中的 SAP HANA 執行個體，請在非叢集中的節點主機上安裝代理程式，以免代理程式受到容錯移轉的影響。

在設定檔 configuration.yaml 中，建議您針對浮動 IP 位址設定監控。在這種情況下，系統只會收集目前有效節點的指標。

支援的作業系統

SAP HANA 的監控代理程式支援下列作業系統的一般和 SAP 產品：

• Red Hat Enterprise Linux (RHEL) 7、8 和 9 ^附註
• SUSE Linux Enterprise Server (SLES) 12 和 15

驗證和存取

SAP HANA 的監控代理程式需要 Identity and Access Management (IAM) 服務帳戶，以便使用 Google Cloud 進行驗證，並取得存取 Google Cloud 資源的權限。

指派給服務帳戶的 IAM 角色會決定代理程式可與哪些 Google Cloud資源互動。

除非您使用現有或預設的服務帳戶，否則必須在 Google Cloud 專案中建立服務帳戶，並為服務帳戶指派一或多個角色。

必要的 IAM 角色

無論您使用的是新、現有或預設服務帳戶，服務帳戶都必須包含角色，才能授予 SAP HANA 監控代理所需的權限。

預先定義的 IAM Monitoring 指標寫入者角色 (roles/monitoring.metricWriter) 會授予寫入指標至 Monitoring 的權限。

如果您使用 Secret Manager 儲存密碼，則需要以下項目：

• 服務帳戶必須包含預先定義的角色 Secret Manager 密鑰存取者 (roles/secretmanager.secretAccessor)，這個角色會授予存取 Secret Manager 中儲存的密鑰的權限。
• VM 執行個體必須具備 cloud-platform 存取權範圍，才能存取 Secret Manager API。詳情請參閱「存取 Secret Manager API」。

指定服務帳戶

如果代理程式在 Compute Engine VM 上執行，則預設會使用主機 VM 的服務帳戶。您不需要在設定檔中指定服務帳戶。

主機 VM 服務帳戶通常是服務帳戶，具有您或同事建立的角色限制，但也可以是 Compute Engine 預設服務帳戶，預設權限較廣。

如果您需要使用主機 VM 服務帳戶以外的服務帳戶，或是代理程式並未在 Compute Engine VM 上執行，就必須使用 JSON 服務帳戶金鑰建立服務帳戶。您可以將 JSON 金鑰檔案儲存在可存取的位置，並在代理程式的 configuration.yaml 檔案中，於 service_account_json 屬性中指定 JSON 檔案的路徑。

如要進一步瞭解服務帳戶、角色和權限，請參閱：

• 建立及管理服務帳戶
• Compute Engine 存取控制總覽
• 監控 IAM 總覽
• Secret Manager 存取權控管

存取 Google Cloud API

如果代理程式並未在 Compute Engine VM 上執行，您需要建立與 Google Cloud API 的連線。詳情請參閱「為內部部署主機設定私人 Google 存取權」。

Cloud Monitoring 中的 SAP HANA 指標

SAP HANA 監控代理程式會將從 SAP HANA 擷取的資料，以自訂指標資料的形式傳送至 Monitoring。為了傳送資料，代理程式會使用 Cloud Monitoring API，這個 API 會在您建立 Google Cloud 專案時預設啟用。

如需 Monitoring 的總覽，請參閱「Cloud Monitoring 簡介」。

在 Cloud Monitoring 中查看 SAP HANA 資料

監控服務收到 SAP HANA 的指標資料後，即可查看這些資料。

如要在 Monitoring 中查看 SAP HANA 資料，請使用資訊主頁編輯器或 Metrics Explorer 工具，在 Google Cloud 主控台中建立圖表，並在指標欄位中輸入 sap_hana。接著，您可以從下拉式選單中選取資料，其中包含所有可用的指標類型 (包括 sap_hana)。

如要在 Monitoring 中只顯示特定 SAP HANA 執行個體的資料，您可以使用 SAP HANA 主機 VM 的名稱篩選檢視畫面，這項資料是 Monitoring 中的指標標籤。

如需詳細資訊，請參閱：

• 使用資訊主頁和圖表
• 篩選圖表資料
• Metrics Explorer
• 在 Google Cloud 控制台中進行監控

GitHub 上的 SAP HANA 資訊主頁定義

您可以在 GitHub 上找到 SAP HANA 的自訂資訊主頁定義，並在 Google Cloud 專案中安裝。請參閱 GitHub 上的 GoogleCloudPlatform/monitoring-dashboard-samples 存放區。SAP HANA 資訊主頁定義檔案 performance.json 和 README.md 檔案位於 /dashboards/sap-hana 子目錄中。

安裝 SAP HANA 自訂資訊主頁後，您可以直接使用，也可以在 Google Cloud 控制台中進一步自訂。

如要安裝 SAP HANA 專用的自訂資訊主頁，請參閱「可安裝的資訊主頁」。

快訊通知

如要設定指標達到自訂門檻時的快訊通知，請在 Monitoring 中進行設定。

詳情請參閱快訊簡介。

密碼管理

根據預設，SAP HANA 監控代理程式會使用預先定義的 SAP HANA SYSTEM 資料庫使用者帳戶查詢 SAP HANA 指標。您必須為代理程式監控的每個 SAP HANA 資料庫提供資料庫使用者帳戶密碼。

如要安全地將密碼提供給 SAP HANA 監控代理程式，您可以使用 Secret Manager，這是 Google Cloud的付費服務。

或者，您也可以在 configuration.yaml 檔案中，針對每個執行個體定義的 password 屬性，以純文字指定資料庫使用者密碼。

如要瞭解 Secret Manager 的定價，請參閱定價。

SSL/TLS 支援

如果 SAP HANA 執行個體使用傳輸層安全 (TLS)/安全資料傳輸層 (SSL) 通訊協定，以保護 SAP HANA 資料庫與使用 SAP HANA SQL 介面的用戶端之間的通訊，您必須在 configuration.yaml 檔案的執行個體定義中指定 enable_ssl: true，在 SAP HANA 的監控代理程式中啟用 TLS/SSL 支援。

如果 SAP HANA 也已設定為驗證憑證，您可以設定代理程式來支援憑證驗證，並指定 KeyStore 和 Trustore 的路徑和密碼。

如需 SSL 和憑證檢查的代理程式設定屬性說明，請參閱「設定屬性說明」。

記錄

第一次啟動 SAP HANA 監控代理程式時，代理程式會在本機主機上建立記錄檔 /var/log/google-saphanamonitoring-agent.log，並在其中寫入所有記錄項目。

根據預設，當記錄檔達到 10.5 MB 時，系統會捨棄舊記錄，並將新記錄附加至檔案。

代理程式的記錄功能是由 conf/logging.properties 檔案設定。

支援

如果是基礎架構或服務相關問題，請與客戶服務團隊聯絡。 Google Cloud 您可以在 Google Cloud 控制台的「支援總覽」頁面中找到聯絡資訊。如果客戶服務團隊判定問題出在 SAP 系統，就會將您轉介給 SAP 支援團隊。

如要進一步瞭解 SAP 產品相關問題，請使用 SAP 支援登錄您的支援要求。SAP 會評估支援票證，如確定為 Google Cloud基礎架構方面的問題，就會將票證轉移至系統中的適當Google Cloud 元件：BC-OP-LNX-GOOGLE 或 BC-OP-NT-GOOGLE。

支援相關規定

您必須符合支援方案的最低需求，才能獲得 SAP 系統和Google Cloud基礎架構和服務的支援服務。

如要進一步瞭解Google Cloud上 SAP 的最低支援需求，請參閱：

• 取得 GCP 上的 SAP 支援 Google Cloud
• SAP 注意事項 2456406 - Google Cloud 平台上的 SAP：支援必要條件 (必須使用 SAP 使用者帳戶)

定義自訂查詢

您可以在 configuration.yaml 檔案中定義自訂查詢。

自訂查詢定義包含描述查詢和傳回指標的屬性值，以及從 SAP HANA 擷取資料的 SQL 陳述式。

如需 SAP HANA 提供查詢的系統檢視表的完整清單，請參閱 SAP HANA SQL 和系統檢視表參考資料。

建立自訂查詢時，請注意監控功能最適合用於摘要或匯總資料，不建議用於儲存高維度資料點。使用 SUM、AVG、COUNT、MIN 和 MAX 等 SQL 匯總函式，限制傳回的記錄數量。

如需自訂查詢的範例，請參閱「自訂查詢範例」。

自訂查詢屬性

下表說明用來定義自訂查詢的屬性。

自訂查詢範例

以下範例顯示兩個自訂查詢。安裝 SAP HANA 的監控代理程式時，這些查詢也會包含在 /usr/sap/google-saphanamonitoring-agent/conf/ 目錄中建立的 configuration.yaml 檔案中。範例查詢可做為您自訂查詢的模型。

- name: custom_memory_utilization
  enabled: false
  # sample_interval: 120
  description: |
    Custom Total memory utilization by services
  sql: |
    SELECT
           SUM(TOTAL_MEMORY_USED_SIZE) AS "mem_used",
           SUM(PHYSICAL_MEMORY_SIZE) AS "resident_mem_used"
    FROM M_SERVICE_MEMORY;
  columns:
  - name: mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory from the memory pool.
    units: By
  - name: resident_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total by all the services.
    units: By
- name: custom_total_memory_usage
  enabled: false
  # sample_interval: 120
  description: |
    Custom Amount of memory used in total by all column-tables
  sql: |
    SELECT
           SUM(MEMORY_SIZE_IN_TOTAL) AS "table_mem_used"
    FROM M_CS_TABLES;
  columns:
  - name: table_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total (sum of memory size in the main, delta, and history
      parts) by all column-tables.
    units: By
# Add additional queries for custom metrics

預設查詢參照

SAP HANA 監控代理程式內建的預設查詢會從 SAP HANA 擷取下列資訊。

如果您不需要特定預設查詢提供的指標，可以在 configuration.yaml 檔案中在查詢名稱後方指定 enabled: false，藉此停用該查詢。

default_column_queries

內建查詢 default_column_queries 會擷取 SAP HANA M_CS_ALL_COLUMNS 系統檢視畫面中，各資料欄記憶體用量的相關資訊。

這項查詢會將下列指標傳送至 Monitoring：

default_component_queries

內建查詢 default_component_queries 會從 SAP HANA 擷取邏輯元件的服務專屬記憶體用量。查詢使用 SAP HANA M_SERVICE_COMPONENT_MEMORY 系統檢視畫面。

這項查詢會將下列指標傳送至 Monitoring：

default_connection_query

內建查詢 default_connection_query 會使用 SAP HANA M_CONNECTIONS 系統檢視表，擷取 SAP HANA 中執行和閒置連線的數量。

這項查詢會將下列指標傳送至 Monitoring：

default_cpu_queries

內建查詢 default_cpu_queries 會使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系統檢視畫面，從 SAP HANA 擷取 CPU 使用率資訊。

這項查詢會將下列指標傳送至 Monitoring：

default_alert_query

內建查詢 default_alert_query 會使用 _SYS_STATISTICS 結構描述的 SAP HANA STATISTICS_CURRENT_ALERTS 檢視畫面，從 SAP HANA 統計資料伺服器擷取目前快訊的數量和評分。

這項查詢會將下列指標傳送至 Monitoring：

default_host_queries

內建查詢 default_host_queries 會從 SAP HANA 擷取主機的記憶體用量。這項查詢會使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系統檢視畫面。

這項查詢會將下列指標傳送至 Monitoring：

default_replication_query

內建查詢 default_replication_query 會使用 SAP HANA M_SERVICE_REPLICATION 系統檢視表，從 SAP HANA 擷取複製延遲資訊。

這項查詢會將下列指標傳送至 Monitoring：

default_rowstore_query

內建查詢 default_rowstore_query 會使用 SAP HANA M_RS_TABLES 系統檢視表，從 SAP HANA 擷取資料列儲存庫的大小。

這項查詢會將下列指標傳送至 Monitoring：

default_schema_type_queries

內建查詢 default_schema_type_queries 會使用 SAP HANA M_CS_TABLES 系統檢視表，從 SAP HANA 擷取記憶體用量和記錄計數資訊。

這項查詢會將下列指標傳送至 Monitoring：

default_schema_queries

內建查詢 default_schema_queries 會使用 SAP HANA M_CS_TABLES 系統檢視表，從 SAP HANA 擷取結構描述使用資訊。

這項查詢會將下列指標傳送至 Monitoring：

default_service_queries

內建查詢 default_service_queries 會從 SAP HANA 擷取服務使用的記憶體相關資訊。查詢使用 SAP HANA M_SERVICE_MEMORY 系統檢視畫面。

這項查詢會將下列指標傳送至 Monitoring：

default_transaction_query

內建查詢 default_transaction_query 會使用 SAP HANA M_WORKLOAD 系統檢視表，從 SAP HANA 擷取交易 (更新、提交和復原) 的總數。

這項查詢會將下列指標傳送至 Monitoring：

後續步驟

• 請參閱 SAP HANA 監控代理程式 V2.0 安裝與操作指南，其中包含安裝、啟動、停止及更新 SAP HANA 監控代理程式的操作說明。
• 進一步瞭解 Cloud Monitoring。