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
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:
Splunk Distribution of the 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
。実行する組み込みターゲットシステム(またはシステム)メトリクスギャザラースクリプト。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をご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。