JMXレシーバー 🔗

JMX レシーバーは、OpenTelemetry JMX Metric Gatherer と連携して動作し、MBean サーバーからメトリクスをレポートします。サポートされるパイプラインタイプは metrics です。詳細はパイプラインでデータを処理するを参照してください。

JMXレシーバーを使用して、target_system 設定を使用しているCassandraなどのサービスを監視できます。詳しくは詳細な設定および設定を参照してください。

注釈

すぐに使えるダッシュボードとナビゲーターは、まだJMXレシーバーではサポートされていませんが、将来のリリースではサポートされる予定です。

前提条件 🔗

The receiver launches a child JRE process which runs the JMX Metric Gatherer configured with your specified JMX connection information and target built-in OTel-helper Groovy script. It then reports metrics to an implicitly created OTLP receiver.

JMXレシーバーを使用するには、以下の手順に従います：

Download the most recent release of the JMX Metric Gatherer JAR and configure the receiver with its path
JRE must be available on your system

はじめに 🔗

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

インストーラ・スクリプトを使用して Collector for Windows をインストールします。

Install the Collector for Kubernetes using Helm

次のセクションで説明するように、JMX レシーバーを設定します。
Collector を再起動します。

サンプル構成 🔗

JMXレシーバーを有効にするには、設定ファイルの receivers セクションに jmx を追加します：

receivers:
  jmx:

設定を完了するには、設定ファイルの service セクションの metrics パイプラインに、レシーバーを含めます：

service:
  pipelines:
    metrics:
      receivers: [jmx]

詳細は設定を参照してください。

設定例 🔗

この例では、レシーバーの設定詳細を提供します：

receivers:
  jmx:
    jar_path: /opt/opentelemetry-java-contrib-jmx-metrics.jar
    endpoint: my_jmx_host:12345
    target_system: jvm
    collection_interval: 10s
    initial_delay: 1s
    # optional: the same as specifying OTLP receiver endpoint.
    otlp:
      endpoint: mycollectorotlpreceiver:4317
    username: my_jmx_username
    # determined by the environment variable value
    password: ${env:MY_JMX_PASSWORD}
    resource_attributes: my.attr=my.value,my.other.attr=my.other.value
    log_level: info
    additional_jars:
      - /path/to/other.jar

詳細な設定 🔗

レシーバーでは、以下の詳細設定を使用できます：

jar_path。JMX Metric Gatherer uber JARを実行するためのパス。GitHubからダウンロードできる、バージョン1.9以上のjarを使用します。デフォルトでは /opt/opentelemetry-java-contrib-jmx-metrics.jar です。
- リリースされていないバージョンが必要な場合は、ldflags オプションを使用して、コレクターのビルド時にカスタムバージョンの jar の sha256 ハッシュを指定してカスタムバージョンを指定します。

go build -ldflags "-X github.com/open-telemetry/opentelemetry-collector-contrib/receiver/jmxreceiver.MetricsGathererHash=<sha256hash>" ...

endpoint。必須。メトリクスギャザラーの JMX クライアントが使用するサービス URL を構築するために使用される JMX サービス URL またはホストとポート。service:jmx:<protocol>:<sap> または host:port の形式を使用します。
- host:port フォーマットを使用する場合は、サービスURL service:jmx:rmi:///jndi/rmi://<host>:<port>/jmxrmi を作成します。
- service:jmx:<protocol>:<sap> 形式を使用または強制する場合は、otel.jmx.service.url プロパティに対応します。
target_system。実行する組み込みターゲットシステム（またはシステム）メトリクスギャザラースクリプト。
- Possible values: "activemq", "cassandra", "hbase", "hadoop", "jetty", "jvm", "kafka", "kafka-consumer", "kafka-producer", "solr", "tomcat", or "wildfly".
- 同時に複数のターゲットシステムを指定することができます： "target_system": "activemq, kafka,kafka-consumer"。
- MetricsGathererHash ビルド時間設定を使用して設定されたカスタム JMX メトリクスギャザラー jar のために、追加のターゲットシステムをサポートする必要がある場合は、別のビルド時間フラグを使用してそれらを追加します。これは、otel.jmx.target.system プロパティに対応します。

go build -ldflags "-X github.com/open-telemetry/opentelemetry-collector-contrib/receiver/jmxreceiver.MetricsGathererHash=<sha256hash>
      -X github.com/open-telemetry/opentelemetry-collector-contrib/receiver/jmxreceiver.AdditionalTargetSystems=newtarget,othernewtarget" ...

設定 🔗

次の表に、JMX レシーバーの設定オプションを示します：

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

このページは 2024年12月12日に最終更新されました。

Related Topics