JMXレシーバー 🔗
JMX レシーバーは、OpenTelemetry JMX Metric Gatherer と連携して動作し、MBean サーバーからメトリクスをレポートします。サポートされるパイプラインタイプは metrics です。詳細は パイプラインでデータを処理する を参照してください。
このレシーバーは、指定された JMX 接続情報とターゲットの組み込み OTel-helper Groovy スクリプトで設定された JMX メトリクスギャザラを実行する子 JRE プロセスを起動します。その後、暗黙的に作成された OTLP レシーバーにメトリクスを報告します。
JMXレシーバーを使用するには、以下の手順に従います：
JMX Metric Gatherer JAR の最新リリースをダウンロードし、そのパスでレシーバーを設定します。
JREがシステム上で利用可能でなければなりません。
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように、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フォーマットを使用する場合は、サービスURLservice:jmx:rmi:///jndi/rmi://<host>:<port>/jmxrmiを作成します。service:jmx:<protocol>:<sap>形式を使用または強制する場合は、otel.jmx.service.urlプロパティに対応します。
target_system。実行する組み込みターゲットシステム（またはシステム）メトリクスギャザラースクリプト。以下のサブセットである必要があります：
"activemq"、"cassandra"、"hbase"、"hadoop"、"jetty"、"jvm"、"kafka"、"kafka-consumer"、"kafka-producer"、"solr"、"tomcat"、または"wildfly"。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 サポートポータル でケースを送信する
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。