Micrometer のモニター

Instana ホストエージェントをインストールすると、 Micrometer センサーが自動的にインストールされ、有効化されます。 Instana ユーザーインターフェースでは、 Micrometer に関連する指標を表示できます。

サポート情報

Micrometer センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:

サポートされるバージョン

1.0.0x におけるカスタムメトリクスのサポートが確認されました。

センサー (データ収集)

micrometerは、 JVM 用のシンプルなメトリクス・ファサードです。 これは Java エコシステムにおける事実上の標準であり、 SpringBoot に統合されています。 詳細については、 Micrometer をご覧ください。

Instana は、追加の構成なしで Micrometer をサポートします。 センサーは、Micrometer の使用を検出し、メトリックを自動的に収集します。 Maven への追加の依存関係は必要ありません。

Micrometer MeterRegistry が検出されるのは、JVM がインスツルメントされた後に MeterRegistry オブジェクトに対してパブリック・メソッドが呼び出される場合のみです。 パブリックコンストラクタを使用してメトリックレジストリを初期化する場合、 Instana エージェントが起動する前に実行されるのはパブリックメソッドのみです。 したがって、エージェントの起動後に MeterRegistry's のパブリックメソッドが呼び出されると、エージェントはレジストリを検出します。

すべてのメトリクスグラフは、 JVM のダッシュボードに表示されます。

メトリックの表示

指標を確認するには、以下の手順に従ってください:

  1. Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
  2. 監視対象のホストをクリックすると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。

構成データ

JVM に Micrometer メトリクスライブラリが読み込まれている場合、カスタムメトリクスは自動的に収集され、 JVM ダッシュボードに表示されます。 バックエンドの過負荷を防ぐため、 JVM ごとにメトリク 200 スのデフォルト上限が設定されています。 この tagExtractionMetricPatterns パラメータを使用すると、特定のメトリクスのタグを抽出できます。 タグ抽出のために、メトリクスをフィルタリングする正規表現のリストを指定できます。 タグは、指定されたパターンに一致するメトリクスからのみ抽出されます。そのパターンとは、以下の通りです tagExtractionMetricPatterns。 多数のメトリクスからタグを抽出すると、データ取り込み量が増加する可能性があります。

Micrometer の監視を無効にするか、メトリクスの制限を変更するには、以下の設定を使用してください:

com.instana.plugin.java:
  micrometerMetricCollection:
    enabled: false
    limit: 200
    tagExtractionMetricPatterns:
      - '^my_metric'
      - 'abc+'
 

ライブラリを読み込んだ後もメトリクスが表示されない場合は、インスタンス io.micrometer.core.instrument.MeterRegistry をデフォルトとして登録してください。 例:

import io.micrometer.core.instrument.Metrics;

Metrics.globalRegistry.add(meterRegistry)
 

メトリック

以下の表は、あらゆる種類のメトリクスを収集するセンサーの概要を示しています:

メトリック・タイプ 説明
カウンター このカウンターが作成されてからの累積カウント
DistributionSummary 記録されたすべてのイベントの合計数
FunctionCounter このカウンターが作成されてからの累積カウント
FunctionTimer 時間指定イベントのすべての出現の合計時間
Gauge 現行値
LongTaskTimer 実行中のタスクの現在の数
タイマー ミリ秒にスケーリングされた、記録済みイベントの合計時間
TimeGauge 適切な基本単位にスケーリングされた現行値

詳細については、 Micrometer metrics を参照してください。

次の例は、タグが抽出されていない場合に、連結されたタグを含むメトリック名を示しています:

exception=None, method=GET, outcome=SUCCESS, 
status=200, version=1.0, maintainer=instana
 
図 1. Micrometer のメトリック単位
タイマー・メトリック

次の例は、タグが抽出された際のメトリック名を示しています:

{action="hello",name="fabian",}
 
図 2. Micrometer のメトリック単位
タイマー・メトリック

で始まるメトリクスは、自動的に "jvm", "process", "tomcat", "system", "logback" 監視対象から除外されます。

Micrometer Prometheus レジストリー

Prometheus Meter Registry は、 Micrometer エコシステムにおけるサブプロジェクトであり、メトリクスデータを Prometheus 形式でエクスポートするためのものです。 この拡張機能を使用しながら、現在のメトリック形式を維持したい場合は、 Instana の Prometheus Java クライアントライブラリによる監視機能を統合することができます。 ただし、 github.com/instana/prometheus-java-library-integration に記載されているように、1行のコードを追加する必要があります。