当社のJMX 統合 では、JMXでメトリクスを公開しているあらゆるアプリケーションを監視することができます。この統合には、JVM から主要なメトリクスを自動的に収集するデフォルトの収集ファイルが含まれています。また、YAML ファイルを使ってメトリクスの収集をカスタマイズし、任意のサブセットを収集することもできます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
私たちの統合は、Java8以降と互換性があります。 PATH
で構成されているものとは異なるJavaバージョンを使用する必要がある場合は、GitHubにあるNewRelicの構成ドキュメントに従ってください。
統合をインストールする前に、次の要件を満たしていることを確認してください。
NewRelicアカウント。持っていませんか?無料でお申し込み頂けます!クレジットカードは必要ありません。
JMXがKubernetesまたはAmazonECSで実行されていない場合は、JMXを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。さもないと:
本製品はIIOPプロトコルに対応していません。
インストールしてアクティブ化する
JMXインテグレーションをインストールするには、お使いの環境に応じた指示に従ってください。
''
その他の注意事項:
- 高度:統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
- インフラストラクチャエージェントが
nri-jmx
バイナリを実行すると、パスがPATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
に設定されます。 Javaバイナリは、これらのパスの1つに含まれている必要があります。 nrjmx
およびjmx
は、JavaバイナリがシステムPATH
に存在する必要があります。これはrootユーザーのPATH
ではなく、/root/.bashrc
でPATH
環境変数を変更しても影響を受けません。 PATHシステム変数を変更する方法の詳細をお読みください。- オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。
データのネーミングのコツ
メトリックは、サンプルの形式で送信および保存されます。これは、メトリック データとメタデータを含むキーと値のペアのリストです。各サンプルは、データベースにイベントとして保存されます。
New Relic に報告する JMX データの作成と命名は、お客様の責任で行ってください。このため、New Relic では、イベントタイプの名前を付ける際に、これらの規約に従うことを強く推奨します。一貫した命名法を行うために。
- キャメルケースを使う。
- どのようなデータが含まれているのかが明確にわかるような名称を使用してください。
例: MyorgApplicationSample
推奨: 異なるアプリケーション間で類似したメトリクスに同じ命名法を使用する。
データを見つけて使用する
このサービスからのデータは、 統合ダッシュボードに報告されます。
JMXデータは、構成ファイルで指定されたユーザー定義のイベントタイプに添付されます。たとえば、JMX統合を使用してTomcatを監視することに関心がある場合は、 TomcatSample
}というevent_type
を定義し、そのイベントタイプをクエリします。
トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
データを検索して使用する方法の詳細については、統合データについてを参照してください。
メトリックデータ
統合によって生成されたメトリクスには、収集元である MBean に関連するメタデータが含まれます。このメタデータを NRQL クエリ で使用して、クエリが目的のビーンのデータのみを返すように、データをフィルタリングおよびファセットすることができます。また、メトリクス名はすべてのビーン間で一意であるとは限らないため、メトリクスを一意に識別するために使用することもできます。
各イベントには、以下のメタデータが含まれています。
名前 | 説明 |
---|---|
| これらのメトリクスのJMXドメイン名です。 |
| これらのメトリクスのJMXドメイン名に、エンティティタイプの「domain:」を前置したもの。 |
| メトリクスを収集しているJMXホストです。 |
| これらのメトリクスを収集するために使用されるクエリ。 |
| これらのメトリクスが収集された属性を持つBean。 |
| Bean名のキーごとに、Beanのキーの値を使用して |
NRQLクエリの例
ここでは、収集されたすべてのJVMガベージコレクターをメタデータモニターで活用した、 NRQL クエリの例を示します。
SELECT latest(CollectionTime)FROM JVMSampleFACET `key:name`WHERE `key:type` = 'GarbageCollector'
メトリクスデータの属性
JMXインテグレーションでは、以下のメトリックデータ属性を収集します。
名前 | 説明 |
---|---|
| 使用されたJavaヒープメモリの合計。 |
| 使用するためにコミットされたJavaヒープメモリの合計。 |
| 最初に割り当てられたJavaヒープメモリ。 |
| 利用可能な最大のJavaヒープメモリです。 |
| 使用されたJavaの非ヒープメモリの合計。 |
| 使用するためにコミットされたJavaの非ヒープメモリの合計。 |
| 最初に割り当てられたJavaの非ヒープメモリ。 |
| 利用可能なJavaの非ヒープメモリの最大値です。 |
| ライブスレッドの数です。 |
| 発生したガベージコレクションの総数です。 |
| 経過したおおよその累積ガベージコレクション時間です。 |
在庫データ
JMX 統合の構成パラメータをキャプチャします。このデータは、 インベントリページ 、 config/jmx ソースの下にあります。インベントリデータの詳細については、 Understand integration data を参照してください。
トラブルシューティング
トラブルシューティングのヒント:
''
''
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。