Monitoring Micrometer

支援的版本

已確認支援 1.0.0+ 版的自訂度量。

感應器 (資料收集)

Micrometer 是 JVM 的簡式應用程式度量 Facade。 它已成為 Java 生態系統中的實際標準,並已整合至 SpringBoot。 如需 Micrometer 的相關資訊,請參閱 micrometer.io

Instana 支援 Micrometer ,而不需要任何其他配置。 感應器會偵測 Micrometer 使用情形,並自動收集度量值。 不需要其他 Maven 相依關係!

只有在檢測 JVM 之後,在 MeterRegistry 物件上呼叫 public 方法時,才會探索 Micrometer MeterRegistry 。 使用公用建構子來起始設定度量登錄,通常是在 Instana 代理程式啟動之前執行的唯一公用方法。 因此,在啟動代理程式之後,只要呼叫任何 MeterRegistry的公用方法,代理程式就能夠探索登錄。

所有度量圖形都會顯示在 JVM 儀表板上。

配置

如果 JVM 已載入 Micrometer 度量程式庫,則會自動收集自訂度量,並顯示在 JVM 儀表板底端。 為了防止後端超載,每個 JVM 的預設度量值限制為 200

若要停用 Micrometer 監視或變更所收集度量的限制,請使用下列配置:

com.instana.plugin.java:
  micrometerMetricCollection:
    enabled: false
    limit: 200

如果即使已載入程式庫也未顯示度量值,請考量將 io.micrometer.core.instrument.MeterRegistry 實例登錄為預設實例。 例如:

import io.micrometer.core.instrument.Metrics;

Metrics.globalRegistry.add(meterRegistry)

度量值

感應器會收集所有類型的度量:

度量類型 說明
計數器 自建立此計數器以來的累加計數
DistributionSummary 所有已記錄事件的總量
FunctionCounter 自建立此計數器以來的累加計數
FunctionTimer 計時事件所有出現項目的時間總計
量規 現行值
LongTask計時器 目前正在執行的作業數
計時器 已記錄事件的時間總計調整為毫秒
TimeGauge 現行值,調整為適當的基本單位

Micrometer 度量的更多詳細資料

度量名稱包含 tag_name=tag_value格式的連結標籤。 例如: 在下列擷取畫面標籤中:

exception=None, method=GET, outcome=SUCCESS, 
status=200, version=1.0, maintainer=instana

計時器度量

名稱以 "jvm", "process", "tomcat", "system", "logback" 開頭的度量會自動從監視中排除。

Micrometer Prometheus 登錄

Prometheus Meter Registry 是 Micrometer 生態系統中的子專案,用於以 Prometheus 格式匯出度量資料。 如果您使用此延伸,並且想要保留現行度量值格式,則可以整合 Instana 的 Prometheus Java 用戶端程式庫 監視。 不過,這需要新增一行程式碼,如 github.com/instana/prometheus-java-library-integration中所述。