JVM

JVM 整合會收集透過 Java 管理擴充功能 (JMX) 公開的 JVM 指標。這項整合功能主要會收集記憶體和垃圾收集的指標。您也可以使用其他執行階段指標,例如執行緒數量和載入的類別。

如要進一步瞭解 JVM,請參閱 JVM 說明文件

事前準備

如要收集 JVM 遙測資料,您必須安裝 Ops Agent

  • 如要使用指標,請安裝 2.2.0 以上版本。

這項整合作業支援 JVM 16 和 11 版本。

設定 JVM 例項

如要公開 JMX 端點,您必須在啟動 JVM 時設定 com.sun.management.jmxremote.port 系統屬性。我們也建議將 com.sun.management.jmxremote.rmi.port 系統屬性設為相同的連接埠。

如要遠端公開 JMX 端點,您也必須設定 java.rmi.server.hostname 系統屬性。

如要使用指令列引數設定系統屬性,請在啟動 JVM 時在屬性名稱前方加上 -D

舉例來說,如要將 com.sun.management.jmxremote.port 設為 9999 通訊埠,請在啟動 JVM 時指定以下項目:

-Dcom.sun.management.jmxremote.port=9999

為 JVM 設定作業套件代理程式

按照設定 Ops Agent 指南的說明,新增必要元素以便從 JVM 執行個體收集遙測資料,然後重新啟動代理程式

範例設定

下列指令會建立設定,收集及擷取 JVM 的遙測資料:

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    jvm:
      type: jvm
      endpoint: service:jmx:rmi:///jndi/rmi://127.0.0.1:9010/jmxrmi
  service:
    pipelines:
      jvm:
        receivers:
          - jvm
EOF

請重新啟動 Ops Agent,讓這些變更生效:

Linux

  1. 如要重新啟動代理程式,請在執行個體上執行下列指令:
    sudo systemctl restart google-cloud-ops-agent
    
  2. 如要確定代理程式已重新啟動,請執行下列指令,並驗證「指標代理程式」和「Logging 代理程式」元件是否已啟動:
    sudo systemctl status "google-cloud-ops-agent*"
    

Windows

  1. 使用遠端桌面協定或類似工具連線至執行個體,然後登入 Windows。
  2. 在 PowerShell 圖示上按一下滑鼠右鍵,然後選取「Run as Administrator」,即可開啟具有系統管理員權限的 PowerShell 終端機。
  3. 如要重新啟動代理程式,請執行下列 PowerShell 指令:
    Restart-Service google-cloud-ops-agent -Force
    
  4. 如要確認代理程式已重新啟動,請執行下列指令,並驗證「Metrics Agent」和「Logging Agent」元件是否已啟動:
    Get-Service google-cloud-ops-agent*
    

設定指標收集

如要從 JVM 擷取指標,您必須為 JVM 產生的指標建立接收器,然後為新接收器建立管道。

這個接收器不支援在設定中使用多個執行個體,例如用於監控多個端點。所有這類例項都會寫入相同的時間序列,而 Cloud Monitoring 無法區分這些例項。

如要為 jvm 指標設定接收器,請指定下列欄位:

欄位 預設 說明
collection_interval 60s 時間長度值,例如 30s5m
endpoint localhost:9999 用於建構服務網址的 JMX 服務網址或主機和通訊埠。這個值必須採用 service:jmx:<protocol>:<sap>host:port 格式。host:port 格式中的值可用來建立 service:jmx:rmi:///jndi/rmi://<host>:<port>/jmxrmi 的服務網址。
password 如果 JMX 已設定為需要驗證,則為已設定的密碼。
type 這個值必須是 jvm
username 如果 JMX 已設定為需要驗證,則為已設定的使用者名稱。

監控的內容

下表列出作業套件代理程式從 JVM 執行個體收集的指標。

指標類型
類型、類型
受控資源
標籤
workload.googleapis.com/jvm.classes.loaded
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.gc.collections.count
CUMULATIVEINT64
gce_instance
name
workload.googleapis.com/jvm.gc.collections.elapsed
CUMULATIVEINT64
gce_instance
name
workload.googleapis.com/jvm.memory.heap.committed
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.heap.init
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.heap.max
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.heap.used
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.nonheap.committed
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.nonheap.init
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.nonheap.max
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.nonheap.used
GAUGEINT64
gce_instance
 
workload.googleapis.com/jvm.memory.pool.committed
GAUGEINT64
gce_instance
name
workload.googleapis.com/jvm.memory.pool.init
GAUGEINT64
gce_instance
name
workload.googleapis.com/jvm.memory.pool.max
GAUGEINT64
gce_instance
name
workload.googleapis.com/jvm.memory.pool.used
GAUGEINT64
gce_instance
name
workload.googleapis.com/jvm.threads.count
GAUGEINT64
gce_instance
 

驗證設定

本節說明如何驗證您是否正確設定 JVM 接收器。作業套件代理程式可能需要一兩分鐘的時間,才能開始收集遙測資料。

如要確認 JVM 指標是否已傳送至 Cloud Monitoring,請執行下列操作:

  1. 前往 Google Cloud 控制台的 「Metrics Explorer」頁面:

    前往 Metrics Explorer

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果

  2. 在查詢建構工具窗格的工具列中,選取名稱為  MQL PromQL 的按鈕。
  3. 確認「Language」切換按鈕中已選取「MQL」。語言切換鈕位於可讓您設定查詢格式的工具列中。
  4. 在編輯器中輸入以下查詢,然後按一下「執行查詢」
    fetch gce_instance
    | metric 'workload.googleapis.com/jvm.memory.heap.used'
    | every 1m
    

查看資訊主頁

如要查看 JVM 指標,您必須先設定圖表或資訊主頁。JVM 整合會為您提供一或多個資訊主頁。設定整合後,Ops Agent 就會開始收集指標資料,並自動安裝所有資訊主頁。

您也可以不安裝整合功能,查看資訊主頁的靜態預覽畫面。

如要查看已安裝的資訊主頁,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,前往「Dashboards」(資訊主頁) 頁面:

    前往「Dashboards」(資訊主頁)

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果

  2. 選取「Dashboard List」分頁標籤,然後選擇「Integrations」類別。
  3. 按一下要查看的資訊主頁名稱。

如果您已設定整合功能,但未安裝資訊主頁,請檢查作業套件代理程式是否正在執行。如果資訊主頁中沒有圖表的指標資料,則無法安裝資訊主頁。作業套件代理程式開始收集指標後,系統會自動安裝資訊主頁。

如要查看資訊主頁的靜態預覽畫面,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,前往「Integrations」(整合) 頁面:

    前往「Integrations」

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果

  2. 按一下「Compute Engine」部署平台篩選器。
  3. 找出 JVM 的項目,然後按一下「查看詳細資料」
  4. 選取「資訊主頁」分頁標籤,即可查看靜態預覽畫面。如果已安裝資訊主頁,請按一下「View dashboard」前往該頁面。

如要進一步瞭解 Cloud Monitoring 中的資訊主頁,請參閱「資訊主頁和圖表」。

如要進一步瞭解如何使用「Integrations」頁面,請參閱管理整合

安裝快訊政策

快訊政策會指示 Cloud Monitoring 在發生特定情況時通知您。JVM 整合包含一或多項快訊政策供您使用。您可以在 Monitoring 的「Integrations」頁面中查看及安裝這些警示政策。

如要查看可用快訊政策的說明並安裝,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,前往「Integrations」(整合) 頁面:

    前往「Integrations」

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果

  2. 找出 JVM 的項目,然後按一下「查看詳細資料」
  3. 選取「警示」分頁標籤。這個分頁會說明可用的快訊政策,並提供安裝快訊政策的介面。
  4. 安裝快訊政策。快訊政策需要知道要將已觸發快訊的通知傳送到哪裡,因此需要您提供安裝資訊。如要安裝快訊政策,請按照下列步驟操作:
    1. 從可用警示政策清單中選取要安裝的政策。
    2. 在「設定通知」部分,選取一或多個通知管道。您可以選擇停用通知管道的使用,但這樣一來,警示政策就會靜默觸發。您可以在「監控」中查看狀態,但不會收到通知。

      如要進一步瞭解通知管道,請參閱「管理通知管道」。

    3. 按一下「建立政策」

如要進一步瞭解 Cloud Monitoring 中的快訊政策,請參閱快訊簡介

如要進一步瞭解如何使用「Integrations」頁面,請參閱管理整合

後續步驟

如需有關如何使用 Ansible 安裝作業套件代理程式、設定第三方應用程式,以及安裝範例資訊主頁的教學影片,請參閱「 安裝作業套件代理程式以排解第三方應用程式的問題」影片。