版本 2：使用 Google Cloud 的 SAP 專用代理程式監控 SAP HANA

本規劃指南僅著重於 Google Cloud的 SAP 專用代理程式第 2 版的 SAP HANA 監控指標收集功能。如要瞭解代理程式 2 版及其所有功能的相關資訊，請參閱 Google Cloud的 SAP 代理程式規劃指南。

在 Linux 上， Google Cloud的 SAP 代理程式可協助您監控 SAP HANA 執行個體和基礎結構。這項功能會透過收集 SAP HANA 監控指標來提供，您可以在 Compute Engine VM 執行個體或裸機解決方案伺服器上安裝代理程式後啟用這項功能。

啟用 SAP HANA 監控指標收集功能後，代理程式會查詢 SAP HANA 執行個體，並將收集到的指標傳送至 Cloud Monitoring。您可以使用 Monitoring 中的資訊主頁，以視覺化方式呈現所收集的指標。您也可以在 Monitoring 中根據指標門檻設定快訊。如要瞭解如何建立資訊主頁和快訊，請參閱 Cloud Monitoring 說明文件。

如要瞭解如何設定 Google Cloud的 SAP 代理程式，以便收集 SAP HANA 監控指標，請參閱「設定 SAP HANA 監控指標收集作業」。

Google Cloud的 SAP 代理程式收集並傳送至監控服務的 SAP HANA 監控指標，會由監控服務歸類為可計費指標，並依據攝入量定價。

查詢的取樣間隔會決定代理程式查詢 SAP HANA 執行個體以取得指標的頻率，進而影響傳送至 Monitoring 的指標量。SAP HANA 監控指標是變化緩慢的指標，啟用後，系統會根據預設每 5 分鐘收集一次。

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

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

預估費用範例

如要查看使用 Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標的預估成本範例，請參閱「根據擷取的位元組數計費的指標計費示例」。

關於查詢

Google Cloud的 SAP 代理程式會在 SAP HANA 例項上執行 SQL 查詢，以便收集 SAP HANA 監控指標。這些查詢的語法是由 SAP 在 SAP HANA SQL 和系統檢視表參考資料中定義。

Google Cloud的 SAP 服務代理支援下列查詢類型：

• 預設查詢
• 自訂查詢

預設查詢

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

預設查詢的頻率取決於代理程式設定檔中 hana_monitoring_configuration 部分開頭處設定的全域 sample_interval_sec 參數。預設值為 300 秒 (5 分鐘)。您可以修改這個全域預設值。與自訂查詢不同的是，您無法為個別預設查詢設定取樣間隔。

雖然您無法修改預設查詢，但可以停用任何不需要的預設查詢。如需停用預設查詢的操作說明，請參閱「停用 SQL 查詢」。

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

自訂查詢

為協助您進一步瞭解 SAP HANA 例項，Google Cloud的 SAP 代理程式可讓您定義及執行自訂查詢。

您可以在 queries 區段中定義自訂查詢，該區段位於代理程式設定檔的 hana_monitoring_configuration 區段下方。

您可以為每個自訂查詢指定 sample_interval_sec 參數，以覆寫預設 sample_interval_sec 參數。詳情請參閱「查詢的取樣間隔」。

Google Cloud的 SAP 代理程式設定檔包含兩個預設為停用的自訂查詢範例。您可以將自訂查詢範例做為自訂查詢的模型。詳情請參閱「定義自訂查詢」。

查詢的取樣間隔

如要使用 Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標，您可以為所有查詢定義全域 sample interval_sec，以及為每個自訂查詢定義個別的取樣間隔。取樣間隔會決定代理程式查詢 SAP HANA 執行個體以取得指標的頻率。

所有查詢的預設取樣間隔為 300 秒 (5 分鐘)。您可以調整預設的取樣間隔，方法是在代理程式設定檔 hana_monitoring_configuration 部分開頭的 sample_interval_sec 參數中指定不同的值。

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

安裝架構

您可以在 Compute Engine VM 執行個體或 Bare Metal 解決方案伺服器上，安裝 Google Cloud的 Agent for SAP。

您可以將 Google Cloud的 SAP 代理程式安裝在 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 和裸機解決方案伺服器上。

混合式收集架構

您可以在 SAP HANA 執行個體所在的相同主機 VM 上安裝代理程式，並將代理程式設為同時監控在 Bare Metal Solution 伺服器上執行的 SAP HANA 執行個體。

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

代理程式的高可用性設定

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

在代理程式的設定檔中，建議您針對浮動 IP 位址設定監控。在這種情況下，代理程式只會從目前處於活動狀態的節點收集指標。

SSL/TLS 支援

如果 SAP HANA 執行個體使用傳輸層安全標準 (TLS) 或安全資料傳輸層 (SSL) 通訊協定，以保護 SAP HANA 資料庫與使用 SAP HANA SQL 介面的用戶端之間的通訊，則必須在 Google Cloud的 SAP 代理程式中啟用 TLS/SSL 支援功能。如要這樣做，您必須在 Google Cloud的 SAP 代理程式設定檔中，為所有這類 SAP HANA 執行個體指定下列參數：

• 指定參數 enable_ssl，並將其值設為 true。
• 指定參數 host_name_in_certificate，並將 TLS/SSL 憑證中指定的主機名稱設為其值。
• 指定 tls_root_ca_file 參數，並將 TLS/SSL 憑證的儲存路徑設為其值。

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

如需 SSL 相關的代理程式設定參數說明，請參閱「設定參數」。

定義自訂查詢

Google Cloud的 Agent for SAP 可讓您定義及執行自訂查詢。

自訂查詢包含下列詳細資料：

• 描述查詢的參數和參數值。
• 從 SAP HANA 執行個體擷取資料的 SQL 陳述式。
• SQL 陳述式傳回的一或多個指標。

如要瞭解查詢參數，請參閱「設定參數」。

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

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

由於 Google Cloud的 SAP 服務會將查詢中的欄視為排序清單，因此在定義自訂查詢時，請務必遵循下列規範：

• SQL 陳述式必須使用您在查詢定義中加入的所有資料欄。
• SQL 陳述式中的資料欄順序必須與查詢定義中的資料欄順序相符。

舉例來說，您可以查看名為 custom_memory_utilization 的自訂查詢範例的查詢定義。其查詢定義包含 mem_used 和 resident_mem_used 欄，並依序排列。這個資料欄順序會與 SQL 陳述式中為參數 sql 指定的資料欄順序相符。

如要查看更多自訂查詢範例，請參閱「自訂查詢範例」。

自訂查詢範例

以下範例顯示兩個自訂查詢。這些查詢也包含在 Google Cloud的 Agent for SAP 設定檔中。範例查詢可做為自訂查詢的模型使用。

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "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": "METRIC_GAUGE",
      "value_type": "VALUE_INT64",
      "units": "By"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64",
      "units": "By"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT SUM(MEMORY_SIZE_IN_TOTAL) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64",
      "units": "By"
    }
  ]
}

自訂查詢的錯誤處理

Google Cloud的 SAP 代理程式不會在將查詢提交至 SAP HANA 執行個體之前，驗證自訂查詢中的 SQL。

如果自訂查詢失敗並出現 SQL 例外狀況，或是查詢中設定的資料欄不符合 SAP HANA 傳回的結果，代理程式就會將錯誤寫入記錄檔。在上述兩種情況下，代理程式會繼續執行自訂查詢，並將錯誤訊息寫入記錄，直到連續發生兩次失敗為止，之後代理程式就會停止執行該查詢。如要繼續執行這類自訂查詢，您必須重新啟動代理程式。

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

SAP HANA 監控指標

下表說明Google Cloud的 SAP 代理程式可收集的內建或預設 SAP HANA 監控指標。此表中的指標字串必須加上前置字串 workload.googleapis.com/。下表中的項目已省略這個前置字串。

在 Monitoring 中查看指標

Google Cloud 提供自訂資訊主頁，協助您以圖表呈現 Google Cloud的 SAP 代理程式所收集的 SAP HANA 監控指標。請參閱 GitHub 上 GoogleCloudPlatform/monitoring-dashboard-samples 存放區的 dashboards/google-cloud-agent-for-sap 目錄。

如要瞭解這些資訊主頁 (包括安裝操作說明)，請參閱查看收集的指標。

如要瞭解如何在 Monitoring 中找出指標資料並設定快訊通知，請參閱「Monitoring 中的指標」。

預設查詢參照

Google Cloud的 SAP 代理程式內建預設查詢會從 SAP HANA 傳回下列資訊。

如果您不需要特定內建或預設查詢提供的指標，可以停用該查詢。如需操作說明，請參閱適用指南：

• 如為 Compute Engine VM 執行個體，請參閱「停用查詢」。
• 如為 Bare Metal 解決方案伺服器，請參閱停用查詢。

column_queries

內建查詢 column_queries 會傳回 SAP HANA M_CS_ALL_COLUMNS 系統檢視表的資料，說明各欄的記憶體用量。

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

component_queries

內建查詢 component_queries 會傳回 SAP HANA 邏輯元件所使用的服務專屬記憶體用量。查詢使用 SAP HANA M_SERVICE_COMPONENT_MEMORY 系統檢視畫面。

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

connection_query

內建查詢 connection_query 會使用 SAP HANA M_CONNECTIONS 系統檢視畫面，傳回 SAP HANA 中執行和閒置連線的數量。

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

cpu_queries

內建查詢 cpu_queries 會使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系統檢視畫面，傳回 SAP HANA 的 CPU 使用率資訊。

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

alert_query

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

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

host_queries

內建查詢 host_queries 會傳回 SAP HANA 主機的記憶體用量。查詢使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系統檢視畫面。

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

replication_query

內建查詢 replication_query 會傳回執行高可用性叢集的 SAP HANA 的複製延遲資訊。這項查詢會使用 SAP HANA 系統檢視表 M_SERVICE_REPLICATION。如果您的 SAP HANA 部署只執行單一節點，這項查詢就不會傳回任何指標。

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

rowstore_query

內建查詢 rowstore_query 會使用 SAP HANA M_RS_TABLES 系統檢視畫面，從 SAP HANA 傳回資料列儲存庫的大小。

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

schema_type_queries

內建查詢 schema_type_queries 會使用 SAP HANA M_CS_TABLES 系統檢視畫面，傳回 SAP HANA 的記憶體用量和記錄計數資訊。

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

schema_queries

內建查詢 schema_queries 會使用 SAP HANA M_CS_TABLES 系統檢視表，從 SAP HANA 傳回結構定義使用情形資訊。

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

service_queries

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

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

transaction_query

內建查詢 transaction_query 會使用 SAP HANA M_WORKLOAD 系統檢視畫面，從 SAP HANA 傳回總交易數 (更新、確認及復原)。

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