Supported OS Linux Windows Mac OS

インテグレーションバージョン3.1.0

概要

このチェックは JBoss および WildFly アプリケーションを監視します。

セットアップ

インストール

JBoss/WildFly チェックは Datadog Agent パッケージに含まれています。JBoss/WildFly ホストに追加でインストールする必要はありません。

構成

このチェックでは、インスタンスあたりのメトリクス数が 350 に制限されています。返されたメトリクスの数は、ステータスページに表示されます。下記の構成を編集することで、関心のあるメトリクスを指定できます。収集するメトリクスをカスタマイズする方法については、JMX チェックのドキュメントで詳細な手順を参照してください。制限以上のメトリクスを監視する必要がある場合は、Datadog のサポートチームまでお問い合わせください。

ホスト

ホストで実行中の Agent に対してこのチェックを構成するには

メトリクスの収集
  1. JBoss または WildFly アプリケーションサーバーのパフォーマンスデータを収集するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの jboss_wildfly.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、jboss_wildfly.d/conf.yaml のサンプル を参照してください。

    サーバーのセットアップによっては(特に remote+http JMX スキームを使用している場合は)、サーバーに接続するためにカスタムな JAR を指定する必要がでてきます。Agent と同じマシンに JAR を配置し、jboss_wildfly.d/conf.yaml ファイルのcustom_jar_paths オプションにパスを追加します。

    : JMX URL スキームは WildFly のバージョンにより異なります。

    • Wildfly 9 以降: service:jmx:http-remoting-jmx://<ホスト>:<ポート>
    • Wildfly 10 以降: service:jmx:remote+http://<ホスト>:<ポート>

    詳細については、WildFly JMX サブシステムコンフィギュレーションページを参照してください。

  2. Agent を再起動します

ログ収集

Agent バージョン 6.0 以降で利用可能

  1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

    logs_enabled: true
    
  2. 次に、下部にある logs 行のコメントを解除して、jboss_wildfly.d/conf.yaml を編集します。ログの path を JBoss ログファイルの正しいパスで更新してください。

    logs:
      - type: file
        path: /opt/jboss/wildfly/standalone/log/*.log
        source: jboss_wildfly
        service: '<APPLICATION_NAME>'
    
  3. Agent を再起動します

コンテナ化

メトリクスの収集

コンテナ環境の場合は、JMX を使用したオートディスカバリーのガイドを参照してください。

ログ収集

Agent バージョン 6.0 以降で利用可能

Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。

パラメーター
<LOG_CONFIG>{"source": "jboss_wildfly", "service": "<サービス名>"}

検証

Agent の status サブコマンドを実行し、Checks セクションで jboss_wildfly を探します。

収集データ

メトリクス

jboss.jdbc_connections.active
(gauge)
number of active connections
Shown as connection
jboss.jdbc_connections.count
(gauge)
number of open connections
Shown as connection
jboss.jdbc_connections.idle
(gauge)
number of physical connections currently idle
Shown as connection
jboss.jdbc_connections.request_wait
(rate)
number of requests that had to wait to obtain a physical connection
Shown as connection
jboss.jdbc_preparedstatementcache.hit
(rate)
number of times that statements from the cache were used
Shown as hit
jboss.jdbc_preparedstatementcache.miss
(rate)
number of times that a statement request could not be satisfied with a statement from the cache
Shown as miss
jboss.jdbc_preparedstatementcache.size
(gauge)
number of prepared and callable statements currently cached in the statement cache
jboss.jdbc_xacommit.count
(rate)
number of XAResource commit invocations
Shown as commit
jboss.jdbc_xarecover.count
(rate)
number of XAResource recover invocations
Shown as transaction
jboss.jdbc_xarollback.count
(rate)
number of XAResource rollback invocations
Shown as transaction
jboss.transactions.aborted
(rate)
total number of transactions which have rolled back.
Shown as transaction
jboss.transactions.application_rollbacks
(rate)
number of transactions rolled back by the application.
Shown as transaction
jboss.transactions.committed
(rate)
number of committed transactions.
Shown as transaction
jboss.transactions.count
(rate)
number of transactions (top-level and nested) created so far.
Shown as transaction
jboss.transactions.heuristics
(rate)
number of transactions which have terminated with heuristic outcomes
Shown as transaction
jboss.transactions.inflight
(gauge)
total number of inflight (active) transactions.
Shown as transaction
jboss.transactions.nested
(rate)
number of nested (sub) transactions created so far.
Shown as transaction
jboss.transactions.resource_rollbacks
(rate)
number of transactions rolled back by participants.
Shown as transaction
jboss.transactions.system_rollbacks
(rate)
number of transactions that were rolled back due to an internal system error.
Shown as transaction
jboss.transactions.timed_out
(rate)
total number of transactions rolled back due to timeout.
Shown as transaction
jboss.undertow_listener.bytes_received
(rate)
number of bytes that have been received
Shown as byte
jboss.undertow_listener.bytes_sent
(rate)
number of bytes that have been sent out
Shown as byte
jboss.undertow_listener.error_count
(rate)
number of 500 responses that have been sent
Shown as request
jboss.undertow_listener.processing_time
(gauge)
total processing time of all requests handed by this listener
Shown as nanosecond
jboss.undertow_listener.request_count
(rate)
number of requests served
Shown as request
jboss.undertow_session.active
(gauge)
number of active sessions
Shown as session
jboss.undertow_session.alivetime_avg
(gauge)
average time (in seconds) that expired sessions had been alive
Shown as second
jboss.undertow_session.alivetime_max
(gauge)
longest time (in seconds) that an expired session had been alive
Shown as second
jboss.undertow_session.created
(rate)
total sessions created
Shown as session
jboss.undertow_session.expired
(rate)
number of sessions that have expired
Shown as session
jboss.undertow_session.rejected
(rate)
number of rejected sessions
Shown as session

イベント

JBoss/WildFly インテグレーションには、イベントは含まれません。

サービスチェック

jboss.can_connect
Returns CRITICAL if the Agent is unable to connect to and collect metrics from the monitored JBoss/WildFly instance, WARNING if no metrics are collected, and OK otherwise.
Statuses: ok, critical, warning

JMXFetch によるメトリクス収集

JMXFetch を介して Java アプリケーションメトリクスを収集するように Datadog Agent を構成できます。JBoss/Wildfly Datadog インテグレーション用に構成されたデフォルトのメトリクスを収集するには、システムプロパティ Ddd.jmxfetch.jboss_wildfly.enabled=true を設定します。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。