使用 Google Cloud 的 SAP 代理程式監控 SAP HANA

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

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

啟用 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 代理程式收集 SAP HANA 監控指標，您可以為所有查詢定義全域 sample interval_sec，以及為每個自訂查詢定義個別的取樣間隔。取樣間隔會決定代理程式查詢 SAP HANA 執行個體以取得指標的頻率。

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

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

安裝架構

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

您可以將 Google Cloud的 SAP 代理程式安裝在 SAP HANA 執行個體所在的主機上，也可以安裝在其他主機上。

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

從中央 Compute Engine 執行個體遠端收集

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

Compute Engine 執行個體和 Bare Metal 解決方案伺服器上的本機收集

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

下圖顯示安裝架構，其中代理程式會個別安裝在 Compute Engine 執行個體和裸機解決方案伺服器上。

混合式收集架構

您可以在代管 SAP HANA 執行個體的 Compute Engine 執行個體上安裝代理程式，並設定代理程式，讓它也監控在裸機解決方案伺服器上執行的 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 相關的代理程式設定參數說明，請參閱「設定參數」。

監控多租戶和 HA 系統

自 3.7 版起， Google Cloud的 SAP 代理程式可針對具有多個租用戶資料庫的 SAP HANA 系統，以及在高可用性 (HA) 叢集中部署的 SAP HANA 系統，提供強化監控功能。

• 對於多租戶 SAP HANA 系統，您可以設定租戶專屬監控。方法是編輯代理程式設定檔，並針對每個定義的 SAP HANA 執行個體，指定要在該執行個體上執行的查詢。根據預設，代理程式會針對您在代理程式設定檔中定義的所有 SAP HANA 執行個體執行所有查詢。

  如要瞭解如何為多租戶 SAP HANA 資料庫設定租戶專屬監控功能，請參閱「為多租戶 SAP HANA 資料庫設定租戶專屬監控功能」。

• 對於以主動/主動 (啟用讀取)設定部署的 SAP HANA HA 系統，您可以指定在代理程式設定檔中定義的查詢是否要在主節點、次要節點或兩者上執行。這樣一來，您就能平衡節點上的查詢負載。舉例來說，您可以只在次要節點上執行某些查詢，藉此不增加主要節點的工作負載。預設行為是代理程式會在 SAP HANA HA 系統中的主要節點上執行查詢。

  如要瞭解如何為 SAP HANA HA 系統設定節點專屬監控功能，請參閱「為 SAP HANA HA 系統設定節點專屬監控功能」。

定義自訂查詢

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 陳述式中的資料欄順序必須與查詢定義中的資料欄順序相符。
• 如自訂查詢範例所述，您已在查詢區塊中指定 enabled: true，啟用自訂查詢。

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

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

自訂查詢範例

以下範例顯示兩個自訂查詢。您可以將範例查詢做為建立自訂查詢的模型。

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(TOTAL_MEMORY_USED_SIZE), 0) AS mem_used, IFNULL(SUM(PHYSICAL_MEMORY_SIZE), 0) AS resident_mem_used FROM M_SERVICE_MEMORY;",
  "columns": [
    {
      "name": "mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(MEMORY_SIZE_IN_TOTAL), 0) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}

自訂查詢的錯誤處理

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 執行個體，請參閱「停用查詢」。
• 如為 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：

blocked_transaction_query

內建查詢 blocked_transaction_query 會使用 SAP HANA M_DATABASES、M_SERVICES 和 M_BLOCKED_TRANSACTIONS 系統檢視表，傳回 SAP HANA 中遭到封鎖的交易總數。

這個查詢適用於 3.5 以上版本的代理程式。

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

data_backup_state_query

內建查詢 data_backup_state_query 會使用 SAP HANA M_BACKUP_CATALOG 系統檢視表，傳回 SAP HANA 上最後一次完整資料備份的最新狀態。

這個查詢適用於 3.5 以上版本的代理程式。

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

log_backup_state_query

內建查詢 log_backup_state_query 會使用 SAP HANA M_BACKUP_CATALOG 系統檢視畫面，傳回 SAP HANA 中遭到封鎖的交易總數。

這個查詢適用於 3.5 以上版本的代理程式。

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

data_backup_catalog_queries

內建查詢 data_backup_catalog_queries 會使用 SAP HANA M_BACKUP_CATALOG 和 M_BACKUP_CATALOG_FILES 系統檢視表，傳回最近 10 次 SAP HANA 資料備份的相關資訊。

這個查詢適用於 3.7 以上版本的代理程式。

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

log_backup_catalog_queries

內建查詢 log_backup_catalog_queries 會使用 SAP HANA M_BACKUP_CATALOG 和 M_BACKUP_CATALOG_FILES 系統檢視表，傳回 10 個最近的 SAP HANA 記錄備份資訊。

這個查詢適用於 3.7 以上版本的代理程式。

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

latest_data_backup_queries

內建查詢 latest_data_backup_queries 會使用 SAP HANA M_BACKUP_CATALOG 和 M_BACKUP_CATALOG_FILES 系統檢視畫面，傳回 SAP HANA 最新資料備份的相關資訊。

這個查詢適用於 3.7 以上版本的代理程式。

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

latest_log_backup_queries

內建查詢 latest_log_backup_queries 會使用 SAP HANA M_BACKUP_CATALOG 和 M_BACKUP_CATALOG_FILES 系統檢視表，傳回 SAP HANA 最新記錄備份的相關資訊。

這個查詢適用於 3.7 以上版本的代理程式。

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

backup_catalog_size_queries

內建查詢 backup_catalog_size_queries 會使用 SAP HANA M_BACKUP_CATALOG 和 M_BACKUP_CATALOG_FILES 系統檢視畫面，傳回 SAP HANA 備份目錄的大小。

這個查詢適用於 3.7 以上版本的代理程式。

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

oldest_backup_catalog_date_queries

內建查詢 oldest_backup_catalog_date_queries 會傳回 SAP HANA 備份目錄中最舊項目的日期與目前時間之間的天數差距。使用 SAP HANA M_BACKUP_CATALOG 系統檢視畫面。

這個查詢適用於 3.7 以上版本的代理程式。

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

memory_unloads_query

內建查詢 memory_unloads_query 會傳回因記憶體不足而導致 SAP HANA 中發生的資料表卸載總數。使用 SAP HANA M_CS_UNLOADS 系統檢視畫面。

這個查詢適用於 3.5 以上版本的代理程式。

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

avg_write_time_queries

內建查詢 avg_write_time_queries 會使用 SAP HANA M_VOLUMES 和 M_VOLUME_IO_DETAILED_STATISTICS 系統檢視表，傳回 SAP HANA 資料和記錄檔磁碟區的平均寫入時間。

這個查詢適用於 3.5 以上版本的代理程式。

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

avg_read_time_queries

內建查詢 avg_read_time_queries 會使用 SAP HANA M_VOLUMES 和 M_VOLUME_IO_DETAILED_STATISTICS 系統檢視表，傳回 SAP HANA 資料量平均讀取時間。

這個查詢適用於 3.5 以上版本的代理程式。

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

data_snapshot_state_queries

內建查詢 data_snapshot_state_queries 會使用 SAP HANA M_BACKUP_CATALOG 系統檢視表，傳回 SAP HANA 最後一次完整磁碟快照資料備份的狀態。

這個查詢適用於 3.6 以上版本的代理程式。

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

fast_restart_enabled_queries

內建查詢 fast_restart_enabled_queries 會使用 SAP HANA M_PERSISTENT_MEMORY_VOLUMES 系統檢視畫面，傳回 SAP HANA 快速重新啟動選項是否已啟用。

這個查詢適用於 3.8 以上版本的代理程式。

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

logshipping_max_retention_size_queries

內建查詢 logshipping_max_retention_size_queries 會傳回 SAP HANA 複製設定中指派給 logshipping_max_retention_size 參數的值相關資訊。這項查詢會使用 SAP HANA M_INIFILE_CONTENTS 系統檢視表。

這個查詢適用於 3.8 以上版本的代理程式。

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