Help Docs

JBoss Application Server monitoring

JBoss Application Server (JBoss EAP) is a widely used open-source Java application server designed to build, deploy, and manage enterprise-grade applications efficiently.

Using Site24x7, you can gain deep visibility into your JBoss environment by monitoring server health, JVM performance, and resource utilization across your application servers. With real-time insights into JVM memory, CPU usage, thread pools, data source connections, deployed applications, and transaction metrics—along with instant alerts—you can quickly detect performance bottlenecks, troubleshoot issues, and ensure optimal application performance.

Supported JBoss versions

Enterprise: JBoss EAP 6+

Community: JBoss AS 7 and WildFly 8+

Prerequisites

Note

JBoss Version 7.x and above (EAP version 6 and above)

Standalone mode:

  1. Open the JBoss configuration file:
    <JBOSS_HOME>\standalone\configuration\standalone-full.xml
  1. Update the management bind address:
    • Change:
      jboss.bind.address.management:127.0.0.1
    • To:
      jboss.bind.address.management:0.0.0.0

EAP (Domain mode) setup:

  1. Open the JBoss config file:
    <JBOSS_HOME>\domain\configuration\host.xml
  1. Update the following entry:
    • Change:
      jboss.bind.address.management:127.0.0.1
    • To:
      jboss.bind.address.management:0.0.0.0

Wildfly setup:

  1. Configure management interface:

    Open the configuration file:

    <JBOSS_HOME>\standalone\configuration\standalone-full.xml
  2. Update the following entry:
    • Change:
      jboss.bind.address.management:127.0.0.1
    • To:
      jboss.bind.address.management:0.0.0.0
    • Restart the service for changes to take effect.
  1. Create a management user:
    • Navigate to: <JBOSS_HOME>\bin directory
    • Execute the following command in command prompt:
      • Windows:
        add-user.bat <USERID> <PASSWORD> ManagementRealm -silent
      • Linux:
        ./add-user.sh <USERID> <PASSWORD> ManagementRealm -silent

Add a monitor

  1. Navigate to Plugins > Enterprise Applications > JBoss and click the + icon.
  2. On the Add JBoss page, add an On-Premise Poller or choose from an existing one.
    Note

    JBoss monitoring is supported from Poller version 6.8.2 and above.

  3. On the Add JBoss Monitor page, provide the following details:
    1. Display Name: Provide a name to identify the JBoss monitor in Site24x7.
    2. Host Name/IP Address: Enter the hostname or IP address of the JBoss server.
    3. Port: Specify the management port (default: 9990) used to access the JBoss admin console and CLI.
    4. Domain Mode: Select whether JBoss is running in Standalone or Domain mode.
    5. Host Controller (Applicable for Domain mode): Provide the JBoss Host Controller name.
    6. Server Name: Specify the JBoss server instance name running on the host.
    7. SSL Enabled: Choose whether SSL is enabled for secure communication.
    8. Check Frequency: Choose a polling frequency from the drop-down list.
    9. Location Profile: Select the location profile from where the JBoss Application Server can be monitored from the drop-down list. To learn more, refer to the location profile help page.
    10. Associate with Monitor Group(s): Select a monitor group from the drop-down list to logically group your monitors. To learn how to create a group for your monitors, refer to the monitor groups help page.
  1. In the JBoss User Credentials section, choose the appropriate credentials stored in the Site24x7 Credential Profile or add new ones.

     

    To add a new credential:

    1. Click the + icon next to the JBoss Credential field.
    2. In the resulting Add Credential pop-up, provide a Credential Name to identify the credential. JBoss will be auto-selected as the Credential Type.
    3. Provide the Username and Password of the associated JBoss Application Server account.
    4. Click Save.
  1. Specify the following details for Configuration Profiles, Alert Settings, and Third-Party Integrations:
    • Tags: Associate your monitor with predefined Tags to organize and manage your monitors creatively. Learn how to add Tags.
    • IT Automation Templates: Select an automation to be executed when WebSphere Application Server's status is down, trouble, or up; when there's any status change; or when there's any attribute change. The defined action gets executed when there is a state change, and the selected user groups get alerted. To automate corrective actions upon a failure, refer to the IT Automation help document.
    • User Alert Group: Select the user group that needs to be alerted during an outage. To add multiple users to a group, see the User Alert Group help document.
    • Notification Profile: Choose a notification profile from the drop-down list or select the default profile available. A notification profile helps you configure who gets notified and when in the event of downtime. Refer to the notification profile help document to create a customized notification profile.
    • Third-Party Integrations: Associate your monitor with preconfigured third-party services. This lets you push your monitor alarms to selected services and facilitate improved incident management.
  1. Click Save.

View the monitor

To view the added JBoss Application Server monitor:

  1. Navigate to Plugins > Enterprise Applications > JBoss.
  2. Select the appropriate monitor to view the performance metrics.

Performance metrics

Find the performance metrics below to monitor the health and behavior of your JBoss server and its components.

Server / JVM

Metric Description
Aborted Total aborted transactions
Aborted Percentage % of transactions that were aborted
Applications Number of deployed applications
Commited Total committed transactions
Commited Percentage % of committed transactions
Current Aborted Currently aborted transactions
Current Applications Currently active applications
Current Commited Currently committed transactions
Current Heuristics Heuristic transaction count
Current Inflight Transactions currently in-flight
Current Nested Nested transactions in progress
Current Resources Resources currently in use
Current Timed Out Currently timed-out transactions
Current Total Total current transactions
Daemon Threads Number of daemon threads running
Heap Size Current Current heap size in bytes
Inflight Total in-flight transactions
Live Threads Total live threads
Loaded Class Count Classes currently loaded
Max Free Memory Maximum free heap memory (MB)
Max Free Memory Percentage Free memory as % of total
Nested Total nested transactions
Object Pending Finalization Objects waiting for garbage collection
Peak Thread Count Highest thread count ever reached
Resources Total resources in use
Timed Out Percentage % of transactions that timed out
Total Total transaction count
Total Loaded Class Count All classes loaded since startup
Total Started Threads All threads started since startup
Unloaded Class Count Classes that have been unloaded
Response Time Script/poll response time (ms)

Server Configuration

Metric Description
Host Name / IP Address Server's hostname or IP
Launch Type How the server was launched (e.g., STANDALONE)
Process Type Server process type
Product Name Product name (e.g., WildFly Full)
JBoss Version Server version string
Release Codename Version release codename
Server Name Configured server name
Server State Current state (e.g., running)
Running Mode Operational mode (e.g., NORMAL)
Available Processors Number of CPU cores available
Operating System Host OS name

Memory Usage

Metric Description
Memory Type Pool type (Heap, Non-Heap, G1_Eden_Space, Metaspace, etc.)
Memory Used (MB) Amount of memory currently used
Memory Free (MB) Amount of free memory
Committed (MB) Memory committed to the JVM
Maximum (MB) Maximum memory allowed for the pool
Used % Used memory as a percentage
Free % Free memory as a percentage

Web Connectors

Metric Description
Connector Name Connector identifier (e.g., default, https)
Request Count Total requests processed
Request Count Diff Requests since last poll
Error Count Total errors encountered
Error Count Diff Errors since last poll
Max Time (ms) Longest request processing time
Processing Time (ms) Total cumulative processing time
Bytes Sent Total bytes sent
Bytes Received Total bytes received
Requests Failed % Percentage of failed requests

JDBC Connection Pools

Metric Description
Connection Pool Name Name of the datasource/pool (e.g., ExampleDS)
Available Count Connections available in the pool
In Use Connections Connections currently in use
Connections Created Total connections ever created
Connections Destroyed Total connections ever destroyed
Max Used Count Peak used connection count
Max Used Percentage Peak used % of pool
Timed Out Connections that timed out
Current Size Current pool size
Hit Count Cache hit count
Hit Count Diff Cache hits since last poll
Miss Count Cache miss count
Miss Count Diff Cache misses since last poll
Max Pool Size Configured maximum pool size
Hit Ratio Cache hit-to-miss ratio
Active % Percentage of pool currently active
Total Blocking Time (ms) Total time threads waited for a connection
Total Creation Time (ms) Total time spent creating connections
Wait Count Threads waiting for a connection
Idle Timeout Minutes Connection idle timeout setting

JMS Queues

Metric Description
Name Queue name (e.g., OrderQueue, DLQ)
Number of Consumer Active consumers on the queue
Messages Added Total messages added to the queue
Messages in Queue Messages currently in the queue
Messages Scheduled Messages scheduled for future delivery
In Delivery Messages currently being delivered
Currently Delivering (%) Percentage of messages in delivery
Is Paused Whether the queue is paused

JMS Topics

Metric Description
Name Topic name (e.g., AuditTopic, EventTopic)
Messages Added Total messages published to the topic
Messages in Topic Messages currently in the topic
In Delivery Messages currently being delivered
Currently Delivering (%) Percentage of messages in delivery
Subscriptions Total number of subscriptions
No of Durable Subscribers Count of durable subscribers
No of Non-Durable Subscribers Count of non-durable subscribers
No of Durable Messages Durable messages count
No of Non-Durable Messages Non-durable messages count
Durable Messages (%) % of messages that are durable
Non-Durable Messages (%) % of messages that are non-durable

Web App Deployments

Metric Description
Name Deployed application name (e.g., medrec.ear)
Context Application URL context path
Enabled Whether the deployment is enabled
Runtime Name Actual runtime deployment name
Status Deployment health status (OK / FAILED)
Sub-Deployments Number of sub-deployments in the archive
Servlets Number of registered servlets

Web Application Sessions

Metric Description
Active Sessions Currently active user sessions
Created Sessions Total sessions created
Expired Sessions Sessions that expired naturally
Rejected Sessions Sessions rejected (e.g., limit exceeded)
Duplicated Sessions Duplicate session count
Session Alive Time (Avg) (ms) Average session lifespan

EJB Statistics

Metric Description
EJB Name Name of the EJB component
EJB Type Bean type (Stateless, Stateful, Message-Driven)
Web Module Module the EJB belongs to
Create Count Number of bean instances created
Remove Count Number of bean instances removed
Pooled Count Beans currently in the pool
Ready Count Beans ready to serve requests
Method Ready Count Method-ready bean instances
Passive Count Passivated (swapped out) beans
Message Count Messages processed (for MDBs)

Servlet Statistics

Metric Description
Servlet Name Name of the servlet
Web Module Web application the servlet belongs to
Invocation Count Total number of servlet invocations
Avg Time (ms) Average execution time per invocation
Min Time (ms) Shortest recorded execution time
Max Time (ms) Longest recorded execution time
Total Time (ms) Cumulative total execution time

JPA Connections

Metric Description
Persistence Unit Name JPA persistence unit (e.g., EmployeePU)
Sessions Opened Total EntityManager sessions opened
Sessions Closed Total sessions closed
Connections Requested Total DB connections requested
Percentage Closed % of open sessions that are closed
Statistics Enabled Whether JPA stats collection is on

JPA Transactions

Metric Description
Completed Total completed transactions
Successful Successfully committed transactions
Successful Transactions (%) % of transactions that succeeded

JPA Query Cache

Metric Description
Query Put Count Queries added to query cache
Query Hit Count Query cache hits
Query Miss Count Query cache misses
Query Hit Ratio Query cache hit-to-miss ratio
Query Execution Count Total queries executed
Exec Max Time (ms) Slowest query execution time
Slow Query Identifier of the slowest query
Query Cached Queries stored in cache
Query Cache Hits Hits on cached query results
Query Cache Missed Misses on cached query results
Query Cache Hit Ratio Cache efficiency ratio

JPA Second Level Cache

Metric Description
Second Level Put Count Entities inserted into L2 cache
Second Level Hit Count L2 cache reads that succeeded
Second Level Miss Count L2 cache reads that failed
Second Level Hit Ratio L2 cache efficiency ratio

Licensing

The JBoss Application Server monitor is an advanced monitor.

Related article

IBM WebSphere application server

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!