JBoss/WildFly

Supported OS Windows Mac OS

통합 버전2.2.0

개요

이 점검은 JBoss 및 WildFly 애플리케이션을 모니터링합니다.

설정

설치

JBoss/WildFly 점검은 Datadog 에이전트 패키지에 포함되어 있으므로 JBoss/WildFly 호스트에 다른 것을 설치할 필요가 없습니다.

구성

이 점검은 인스턴스당 메트릭을 350개로 제한한니다. 반환된 메트릭 개수는 상태 페이지에 표시됩니다. 아래 설정 을 편집하여 원하는 메트릭을 지정할 수 있습니다. 수집된 메트릭을 커스터마이즈하는 방법에 대한 자세한 내용은 JMX 점검 설명서를 참조하세요. 추가 메트릭을 모니터링해야 하는 경우, Datadog 지원팀에 문의하세요.

    호스트

    호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면:

    메트릭 수집

    1. 에이전트의 설정 디렉터리 루트의 conf.d/ 폴더에 있는 jboss_wildfly.d/conf.yaml 파일을 편집하여 JBoss 또는 WildFly 애플리케이션 서버의 성능 데이터 수집을 시작합니다. 사용 가능한 모든 설정 옵션은 샘플 jboss_wildfly.d/conf.yaml을 참조하세요.

      서버 설정에 따라 (특히 remote+http JMX 체계를 사용하는 경우) 서버에 연결하기 위해 커스텀 JAR을 지정해야 할 수도 있습니다. 에이전트 와 동일한 컴퓨터에 JAR을 배치하고 jboss_wildfly.d/conf.yaml 파일의 custom_jar_paths 옵션에 해당 경로를 추가합니다.

      참고: JMX URL 체계는 사용 중인 WildFly 버전에 따라 다릅니다:

      • Wildfly 9 이상: service:jmx:http-remoting-jmx://<HOST>:<PORT>
      • Wildfly 10 이상: service:jmx:remote+http://<HOST>:<PORT>

      자세한 내용은 WildFly JMX 하위 시스템 설정 페이지를 참조하세요.

    2. 에이전트를 재시작하세요.

    로그 수집

    Agent 버전 6.0 이상에서 사용 가능

    1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. 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. 에이전트를 재시작하세요.

    컨테이너화

    메트릭 수집

    컨테이너화된 환경의 경우 JMX를 사용한 자동탐지 가이드를 참조하세요.

    로그 수집

    Agent 버전 6.0 이상에서 사용 가능

    Datadog Agent에서 로그 수집은 기본값으로 비활성화되어 있습니다. 이를 활성화하려면 쿠버네티스(Kubernetes) 로그 수집을 참조하세요.

    파라미터값
    <LOG_CONFIG>{"source": "jboss_wildfly", "service": "<SERVICE_NAME>"}

    검증

    에이전트 상태 하위 명령을 실행하고 점검 섹션에서 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 에이전트를 설정정할 수 있습니다. JBoss/Wildfly Datadog 통합에 대해 설정된 기본 메트릭을 수집하려면 시스템 속성 Ddd.jmxfetch.jboss_wildfly.enabled=true을 설정합니다.

    트러블슈팅

    도움이 필요하신가요? Datadog 지원 팀에 문의하세요.

    PREVIEWING: piotr_wolski/update-dsm-docs