Docs » Splunk Observability Cloud でサポートされているインテグレーション » Collectorコンポーネント: レシーバー » JMXレシーバー

JMXレシーバー 🔗

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

You can use the JMX receiver to monitor services such as Cassandra using the target_system setting. See more at 詳細な設定 and 設定.

注釈

Out-of-the-box dashboards and navigators aren’t supported for the JMX receiver yet, but are planned for a future release.

前提条件 🔗

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

はじめに 🔗

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

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

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

  2. 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".

    • You can specify multiple target systems at the same time: "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をご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

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

This page was last updated on 2024年10月10日.