概要

Java インテグレーションを利用して、Java アプリケーションからメトリクス、トレース、ログを収集できます。

セットアップ

メトリクスの収集

アプリケーションで JMX メトリクスが公開されている場合、Datadog Agent から軽量の Java プラグインである JMXFetch (Java 1.7 以上とのみ互換) が呼び出され、MBean サーバーに接続してアプリケーションのメトリクスを収集します。また、監視対象のインスタンスのステータスを報告するサービスチェックを送信することも可能です。このプラグインは、Agent 内で稼働する DogStatsD サーバーを使用して Datadog Agent にメトリクスを送信します。このインテグレーションでは以下の JMX メトリクスも同様に使用されます。

• ActiveMQ
• Cassandra
• Solr
• Tomcat
• Kafka

注: DogStatsD を介して RATE メトリクスタイプを送信する場合、メトリクスは異なる Agent 間で適切な比較ができるようにアプリ内に GAUGE として表示されます。詳しくはメトリクスの送信: DogStatsD のドキュメントを参照してください。

インストール

JMX リモート接続を開くことができるかをご確認ください。Datadog Agent が JVM に接続するためには、両者が同じホスト上にある場合でもリモート接続が必要です。セキュリティ上の理由から、リスニングアドレスには 0.0.0.0 を使用しないことをお勧めします。同じ場所に配置された JVM と Agent には com.sun.management.jmxremote.host=127.0.0.1 を使用することをお勧めします。

構成

Agent をホスト上のバイナリとして実行している場合は、他の Agent インテグレーション同様に JMX チェックを構成します。Agent を Kubernetes の DaemonSet として実行している場合は、オートディスカバリーを使用して JMX チェックを構成します。

コンフィギュレーションオプション

conf パラメーターは、辞書のリストです。この辞書では、次の 2 つのキーのみが許可されます。

タグは実際の MBean 名に基づいてメトリクスに自動的に追加されます。明示的に補足タグを指定できます。たとえば、次の MBean が監視対象のアプリケーションで公開されているとします。

mydomain:attr0=val0,attr1=val1

mydomain というメトリクス (または Bean 内の属性によるそのバリエーション) をタグ attr0:val0、attr1:val1、domain:mydomain、simple:val0、raw_value:my_chosen_value、multiple:val0-val1 で作成します。

include キー内の指定したエイリアスが_キャメルケース_として書式設定されている場合、_スネークケース_に変換されます。たとえば MyMetricName は、Datadog では my_metric_name と表示されます。

フィルターの説明

各 include または exclude 辞書は次のキーをサポートします。

注:

• domain_regex および bean_regex で定義された正規表現は、Java の正規表現形式に従う必要があります。このフィルターはバージョン 5.5.0 で追加されました。
• 正規表現のパターン以外のすべての値では、大文字と小文字が区別されます。

これらのパラメーターに加えて、フィルターは Bean パラメーターで絞り込むことができる「カスタム」キーをサポートします。たとえば、Cassandra キャッシュに関するメトリクスを収集する場合は、type: - Caches フィルターを使用することが考えられます。

conf:
    - include:
          domain: org.apache.cassandra.db
          type:
              - Caches

属性フィルター

attribute フィルターは、次の 2 種類の値を受け入れます。

• キーが、ターゲット属性の名前と一致する辞書:

  conf:
      - include:
            attribute:
                maxThreads:
                    alias: tomcat.threads.max
                    metric_type: gauge
                currentThreadCount:
                    alias: tomcat.threads.count
                    metric_type: gauge
                bytesReceived:
                    alias: tomcat.bytes_rcvd
                    metric_type: counter
  

  • Datadog でメトリクス名になる属性の alias を指定できます。
  • また、メトリクスタイプ（gauge、histogram、counter/rate、monotonic_count）も指定できます。counter を選択すると、メトリクスに対して 1 秒あたりの rate が計算され、gauge として送信されます。

• ターゲット属性名のリスト:

  conf:
      - include:
            domain: org.apache.cassandra.db
            attribute:
                - BloomFilterDiskSpaceUsed
                - BloomFilterFalsePositives
                - BloomFilterFalseRatio
                - Capacity
                - CompressionRatio
                - CompletedTasks
                - ExceptionCount
                - Hits
                - RecentHitRate
  

  • メトリクスタイプはデフォルトで gauge です。
  • メトリクス名は jmx.<DOMAIN_NAME>.<ATTRIBUTE_NAME> です。

これは別のフィルタリングの例です。

instances:
    - host: 127.0.0.1
      name: jmx_instance
      port: 9999

init_config:
    conf:
        - include:
              bean: org.apache.cassandra.metrics:type=ClientRequest,scope=Write,name=Latency
              attribute:
                  - OneMinuteRate
                  - 75thPercentile
                  - 95thPercentile
                  - 99thPercentile

検証

Agent の status サブコマンドを実行し、JMXFetch セクションの JMX チェックを探します。

さらに、JMX チェックには、JMX アプリケーションからメトリクスを収集するデフォルトのコンフィギュレーションがあります。Metrics Explorer で jvm.heap_memory、jvm.non_heap_memory、jvm.gc.cms.count をチェックします。

収集データ

Agent v6.0 以上で使用可能

Java のログコレクションをセットアップして Datadog にログを送信するには、 個別のドキュメントを参照してください。

トレースの収集

Agent でトレースコレクションを有効化した後、Java アプリケーションのインスツルメンテーションに関するドキュメントを参照して Datadog にトレースを送信します。

収集データ

メトリクス

注: jmx.d/conf.yaml で new_gc_metrics: true と設定すると、次のメトリクスが置き換えられます。

jvm.gc.cms.count   => jvm.gc.minor_collection_count
                      jvm.gc.major_collection_count
jvm.gc.parnew.time => jvm.gc.minor_collection_time
                      jvm.gc.major_collection_time

サービスチェック

jmx.can_connect
Agent が監視対象の JVM インスタンスに接続できず、メトリクスを収集できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル

トラブルシューティング

JMX トラブルシューティングのコマンドと FAQ のリストを参照してください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

JMX インテグレーションに一致する Bean がありますが、データが収集できません。よくあるご質問 jConsole で JMX データを表示し、jmx.yaml でデータの収集をセットアップするよくあるご質問 jmx.yaml error: Include Sectionよくあるご質問 複合型の JMX 属性を収集するよくあるご質問 Windows で JMX コマンドを実行するガイド Bean 正規表現を使用して JMX メトリクスをフィルタリングし、追加のタグを提供するガイド