JBoss

Introduction

JBoss, now known as WildFly, is an open-source Java EE-based application server. It's developed by Red Hat and is used for building, deploying, and hosting highly-transactional Java applications and service

Getting Started

Compatibility

The JBoss O11ySource is compatible with all versions equal to or greater than 7.0.0.

Data Collection Method

vuSmartMaps collects health and performance data from JBoss server using VuNet's vuAppAgent. This agent collects data based on the source configuration.

Prerequisites

Dependent Configuration

To configure this O11ySource, create a 'credential' of type 'user' under the 'Definition' tab.

Inputs for Configuring Data Source

• Jboss Server: The IP Address/FQDN of the Jboss server. This field is the key to identify each server you add here.
• Port: Connecting Port of Jboss instance.
• Jboss Credential: Credential that reflect that user name and password of Jboss server management console.
• Period (in seconds): How frequently data is gathered. period should be between 60 seconds - 3000 seconds.

Firewall Requirement

To collect data from this O11ySource, ensure the following ports are opened:

Source IP	Destination IP	Destination Port	Protocol	Direction
IP address of the JBoss server	vuSmartMaps Data Collector End Point	9092*	TCP	Inbound

*Before providing the firewall requirements, please update the port based on the customer environment.

Configuring the Target

• vuAppAgent should be installed and running in the server where JBoss is installed.
• The metrics collection agent for JBoss requires a read-only user id for interfacing with JBoss. Users must have the valid username/password with the read-only role.
• The valid endpoint where the Jboss server is running is to be provided for the agent to be configured. The details regarding this can be found in the config xml file. For example, if this is a standalone deployment, this will be located in the file $AGENT_HOME/standalone/configuration/standalone.xml

Configuration Steps

• Enable the O11ySource.
• Select the Sources tab and press the + button to add a new JBoss host to be monitored.
• Add the required details and then click on Next.
• The following packages will be available for download based on the OS:vuAppAgent full installer package - Downloads the full vuAppAgent package with required configurations for a fresh installationvuAppAgent config update package - Downloads the agent configuration package to update an existing vuAppAgent installation
• Download the agent installation or update package, then click Finish to close the data source window.

Metrics Collected

Name	Description	Data Type
@timestamp	Timestamp when the metric was collected	String
timestamp	Detailed timestamp with milliseconds	DateTime64(3)
o11ysouce_name	Name of the O11ySource	LowCardinality(String)
Host	Hostname of the server	LowCardinality(String)
target	Target server or service	LowCardinality(String)
DeviceType	Type of the device	String
OS	Operating system	String
Owner	Owner of the resource	String
Role	Role of the server	String
tenant_id	Tenant ID	String
bu_id	Business unit ID	String
Time	Time related metric	String
Status	Status of the resource or service	String
name	Name of the metric or resource	String
period	Time period	Float32
KeyPropertyListType	Type of key property list	String
datasources_prepared-statements-cache-size	Size of prepared statements cache	Int64
datasources_connection-url	Connection URL	String
datasources_background-validation-millis	Background validation interval in milliseconds	Int64
datasources_reauth-plugin-class-name	Re-authentication plugin class name	String
datasources_user-name	Username for the data source	String
datasources_max-pool-size	Maximum pool size	Int64
datasources_statistics_pool_AveragePoolTime	Average time in the connection pool	UInt64
datasources_statistics_pool_XACommitTotalTime	Total time for XA commits	UInt64
undertow_server_listener_bytes-received	Number of bytes received by the listener	Int64
undertow_server_listener_bytes-received_rate	Rate of bytes received by the listener	Float64
undertow_server_listener_bytes-received_diff	Difference in bytes received	Int64
undertow_server_listener_bytes-sent	Number of bytes sent by the listener	Int64
undertow_server_listener_bytes-sent_diff	Difference in bytes sent	Int64
undertow_server_listener_bytes-sent_rate	Rate of bytes sent	Float64
undertow_server_listener_processing-time	Total processing time	Int64
undertow_server_listener_processing-time_diff	Difference in processing time	Int64
undertow_server_listener_processing-time_rate	Rate of processing time	Float64
undertow_server_listener_error-count	Number of errors	Int64
undertow_server_listener_error-count_diff	Difference in error count	Int64
undertow_server_listener_error-count_rate	Rate of error occurrences	Float64
undertow_server_listener_request-count	Total number of requests	Int64
undertow_server_listener_request-count_diff	Difference in request count	UInt64
undertow_server_listener_request-count_rate	Rate of requests	Float64
undertow_server_listener_max-processing-time	Maximum processing time for requests	Int64
undertow_server_listener_max-processing-time_diff	Difference in maximum processing time	Int64
undertow_server_listener_max-processing-time_rate	Rate of maximum processing time	Float64
deployment_unique_id	Unique identifier for the deployment	String
subsystem_undertow_server	Name of the Undertow server	String
subsystem_undertow_rejected-sessions	Total number of rejected sessions	Int32
subsystem_undertow_session-max-alive-time	Maximum alive time of a session	Int64
subsystem_undertow_highest-session-count	Highest number of active sessions	Int32
subsystem_undertow_session-avg-alive-time	Average alive time of sessions	Int64
subsystem_undertow_virtual-host	Name of the virtual host	String
subsystem_undertow_active-sessions	Number of currently active sessions	Int32
subsystem_undertow_active-sessions_diff	Difference in active sessions	Int32
subsystem_undertow_active-sessions_rate	Rate of active sessions	Float64
subsystem_undertow_context-root	Context root of the deployment	String
subsystem_undertow_sessions-created	Total number of sessions created	Int32
subsystem_undertow_expired-sessions	Total number of expired sessions	Int32
subsystem_undertow_max-active-sessions	Maximum number of active sessions	Int32
subsystem_undertow_session-max-alive-time_diff	Difference in session maximum alive time	Int64
subsystem_undertow_session-avg-alive-time_diff	Difference in session average alive time	Int64
subsystem_undertow_session-avg-alive-time_rate	Rate of session average alive time	Float64
subsystem_undertow_rejected-sessions_diff	Difference in rejected sessions	Int32
subsystem_undertow_rejected-sessions_rate	Rate of rejected sessions	Float64
subsystem_undertow_expired-sessions_diff	Difference in expired sessions	Int32
subsystem_undertow_expired-sessions_rate	Rate of expired sessions	Float64
subsystem_undertow_sessions-created_diff	Difference in sessions created	Int32
subsystem_undertow_sessions-created_rate	Rate of sessions created	Float64
runtime-name	Runtime name of the deployment	String
status	Current status of the deployment	String
ejb3_thread-pool_name	Name of the EJB3 thread pool	String
ejb3_thread-pool_keepalive-time_unit	Unit of time for thread pool keepalive	String
ejb3_thread-pool_keepalive-time_time	Time duration for thread pool keepalive	Int64
ejb3_thread-pool_active-count	Number of active threads in the EJB3 thread pool	Int32
ejb3_thread-pool_queue-size	Size of the EJB3 thread pool queue	Int32
ejb3_thread-pool_completed-task-count	Total number of completed tasks in the EJB3 thread pool	Int32
ejb3_thread-pool_current-thread-count	Current number of threads in the EJB3 thread pool	Int32
ejb3_thread-pool_largest-thread-count	Largest number of threads ever in the EJB3 thread pool	Int32
ejb3_thread-pool_core-threads	Core number of threads in the EJB3 thread pool	Int32
ejb3_thread-pool_max-threads	Maximum number of threads in the EJB3 thread pool	Int32
ejb3_thread-pool_rejected-count	Total number of rejected tasks in the EJB3 thread pool	Int32
ejb3_thread-pool_task-count	Total number of tasks in the EJB3 thread pool	Int32
batch-jberet_default-job-repository	Default job repository for batch processing	String
batch-jberet_thread-pool_batch_active-count	Number of active threads in the batch thread pool	Int64
batch-jberet_thread-pool_batch_queue-size	Size of the batch thread pool queue	Int64
batch-jberet_thread-pool_batch_name	Name of the batch thread pool	String
batch-jberet_thread-pool_batch_completed-task-count	Total number of completed tasks in the batch thread pool	Int64
batch-jberet_thread-pool_batch_current-thread-count	Current number of threads in the batch thread pool	Int64
batch-jberet_thread-pool_batch_largest-thread-count	Largest number of threads ever in the batch thread pool	Int64
batch-jberet_thread-pool_batch_max-threads	Maximum number of threads in the batch thread pool	Int64
batch-jberet_thread-pool_batch_rejected-count	Total number of rejected tasks in the batch thread pool	Int64
batch-jberet_thread-pool_batch_task-count	Total number of tasks in the batch thread pool	Int64
batch-jberet_default-thread-pool	Default thread pool for batch processing	String
transactions_unique_id	Unique identifier for the transaction	String
transactions_stale-transaction-time	Time for a transaction to become stale	UInt64
transactions_number-of-heuristics	Number of heuristic transactions	Int64
transactions_process-id-socket-max-ports	Maximum ports available for the process ID socket	Int32
transactions_default-timeout	Default timeout for transactions	UInt64
transactions_number-of-committed-transactions	Number of transactions committed	Int64
transactions_number-of-committed-transactions_diff	Difference in the number of committed transactions	Int64
transactions_number-of-committed-transactions_rate	Rate of committed transactions	Float64
transactions_average-commit-time	Average time to commit a transaction	UInt64
transactions_number-of-transactions	Total number of transactions	UInt64
transactions_maximum-timeout	Maximum timeout for transactions	UInt64
transactions_number-of-timed-out-transactions	Number of transactions that timed out	Int64
transactions_number-of-timed-out-transactions_diff	Difference in the number of timed-out transactions	Int64
transactions_number-of-timed-out-transactions_rate	Rate of timed-out transactions	Float64
transactions_number-of-resource-rollbacks	Number of transactions rolled back by resources	Int64
transactions_number-of-resource-rollbacks_diff	Difference in the number of resource rollbacks	Int64
transactions_number-of-resource-rollbacks_rate	Rate of resource rollbacks	Float64
transactions_number-of-application-rollbacks	Number of transactions rolled back by applications	Int64
transactions_number-of-application-rollbacks_diff	Difference in the number of application rollbacks	UInt64
transactions_number-of-application-rollbacks_rate	Rate of application rollbacks	Float64
transactions_status-socket-binding	Status of the transaction socket binding	String
transactions_number-of-aborted-transactions	Number of aborted transactions	Int64
transactions_number-of-inflight-transactions	Number of transactions currently in flight	Int64
transactions_number-of-inflight-transactions_diff	Difference in the number of inflight transactions	Int64
transactions_number-of-inflight-transactions_rate	Rate of inflight transactions	Float64
transactions_number-of-nested-transactions	Number of nested transactions	Int64
transactions_number-of-nested-transactions_diff	Difference in the number of nested transactions	Int64
transactions_number-of-nested-transactions_rate	Rate of nested transactions	Float64
transactions_number-of-aborted-transactions_diff	Difference in the number of aborted transactions	Int64
transactions_number-of-aborted-transactions_rate	Rate of aborted transactions	Float64
transactions_number-of-transactions_diff	Difference in the total number of transactions	Int64
transactions_number-of-transactions_rate	Rate of total transactions	Float64
transactions_number-of-system-rollbacks	Number of transactions rolled back by the system	Int64
transactions_number-of-system-rollbacks_diff	Difference in the number of system rollbacks	Int64
transactions_number-of-system-rollbacks_rate	Rate of system rollbacks	Float64
io_task-keepalive	Keepalive time for IO tasks	Int64
io_task-max-threads	Maximum number of threads for IO tasks	Int64
io_io-threads	Number of IO threads	Int64
io_stack-size	Stack size for IO threads	Int64
io_io-thread-count	Current count of IO threads	Int64
io_busy-task-thread-count	Number of busy task threads in the IO subsystem	Int64
io_core-pool-size	Core pool size for IO tasks	Int64
io_max-pool-size	Maximum pool size for IO tasks	Int64
io_task-core-threads	Core number of threads for IO tasks	Int64
io_queue-size	Size of the IO queue	Int64
io_name	Name of the IO subsystem	String
io_server_connection-count	Number of server connections	Int64
io_server_connection-limit-low-water-mark	Low water mark for server connection limit	Int64
io_server_connection-limit-high-water-mark	High water mark for server connection limit	Int64
io_server_name	Name of the server for the IO subsystem	String
request-controller_max-requests	Maximum number of requests that can be handled	Int32
request-controller_max-requests_track-individual-endpoints	Flag to track individual endpoints	Nullable(Bool)
request-controller_active-requests	Number of active requests currently being processed	Int32
base-dir	Base directory for the application	String
config-file	Configuration file path	String
content-dir	Directory for application content	String
modules-dir	Directory for application modules	String
log-dir	Directory for application logs	String
temp-dir	Temporary directory for the application	String
host-name	Host name for the server	String
home-dir	Home directory for the application	String
qualified-host-name	Fully qualified host name	String
ext-dirs	External directories for the application	String
server-name	Name of the server	String
node-name	Name of the node in the cluster	String
deploy-dir	Directory for application deployment	String
data-dir	Data directory for the application	String
config-dir	Configuration directory for the application	String
initial-running-mode	Initial running mode for the application	String
launch-type	Launch type for the application	String
interface_public_resolved-address	Resolved address of the public interface	String
interface_public_name	Name of the public interface	String
interface_management_name	Name of the management interface	String
interface_management_resolved-address	Resolved address of the management interface	String
jca_workmanager_default_name	Default name for the JCA workmanager	String
jca_workmanager_default_long-running-threads_queue-size	Queue size for long-running threads	Int64
jca_workmanager_default_long-running-threads_name	Name of long-running threads	String
jca_workmanager_default_long-running-threads_current-thread-count	Current thread count for long-running threads	Int64
jca_workmanager_default_long-running-threads_largest-thread-count	Largest thread count for long-running threads	Int64
jca_workmanager_default_long-running-threads_core-threads	Core threads for long-running threads	Int64
jca_workmanager_default_long-running-threads_max-threads	Max threads for long-running threads	Int64
jca_workmanager_default_long-running-threads_rejected-count	Rejected count for long-running threads	Int64
jca_workmanager_default_long-running-threads_queue-length	Queue length for long-running threads	Int64
jca_workmanager_default_short-running-threads_queue-size	Queue size for short-running threads	Int64
jca_workmanager_default_short-running-threads_name	Name of short-running threads	String
jca_workmanager_default_short-running-threads_current-thread-count	Current thread count for short-running threads	Int64
jca_workmanager_default_short-running-threads_largest-thread-count	Largest thread count for short-running threads	Int64
jca_workmanager_default_short-running-threads_core-threads	Core threads for short-running threads	Int64
jca_workmanager_default_short-running-threads_max-threads	Max threads for short-running threads	Int64
jca_workmanager_default_short-running-threads_rejected-count	Rejected count for short-running threads	Int64
jca_workmanager_default_short-running-threads_queue-length	Queue length for short-running threads	Int64
jca_workmanager_default_statistics_local_schedulework-rejected	Schedule work rejected count	Int64
jca_workmanager_default_statistics_local_dowork-rejected	Do work rejected count	Int64
jca_workmanager_default_statistics_local_work-active	Active work count	Int64
jca_workmanager_default_statistics_local_dowork-accepted	Do work accepted count	Int64
jca_workmanager_default_statistics_local_startwork-accepted	Start work accepted count	Int64
jca_workmanager_default_statistics_local_schedulework-accepted	Schedule work accepted count	Int64
jca_workmanager_default_statistics_local_statistics-enabled	Indicates if statistics are enabled	Bool
jca_workmanager_default_statistics_local_work-successful	Successful work count	Int64
jca_workmanager_default_statistics_local_startwork-rejected	Start work rejected count	Int64
collection-usage-threshold-exceeded	Indicates if usage threshold is exceeded	Int64
PoolType	Type of pool	String
usage_init	Initial usage value	Int64
usage_used	Used memory value	Int64
usage_committed	Committed memory value	Int64
usage_max	Maximum memory value	Int64
usage-threshold-exceeded	Indicates if usage threshold is exceeded	Nullable(Bool)
peak-usage_init	Peak initial usage value	Int64
peak-usage_committed	Peak committed memory value	Int64
peak-usage_max	Peak maximum memory value	Int64
peak-usage_used	Peak used memory value	Int64
valid	Indicates if the data is valid	Nullable(Bool)
usage-threshold-supported	Indicates if usage threshold is supported	Nullable(Bool)
usage-threshold	Usage threshold value	Int64
collection-usage-threshold-supported	Indicates if collection usage threshold is supported	Nullable(Bool)
collection-usage-threshold-count	Collection usage threshold count	Int64
collection-usage-threshold	Collection usage threshold value	Int64
object-name	Name of the object	String
heap-memory-usage_init	Initial heap memory usage	Int64
heap-memory-usage_committed	Committed heap memory usage	Int64
heap-memory-usage_max	Maximum heap memory usage	Int64
heap-memory-usage_used	Used heap memory value	Int64
non-heap-memory-usage_init	Initial non-heap memory usage	Int64
non-heap-memory-usage_committed	Committed non-heap memory usage	Int64
non-heap-memory-usage_max	Maximum non-heap memory usage	Int64
non-heap-memory-usage_used	Used non-heap memory value	Int64
object-pending-finalization-count	Count of objects pending finalization	Int64
bufferPool_unique_id	Unique identifier for the buffer pool	String
count	Count of occurrences	Int64
count_diff	Difference in count	Int64
count_rate	Rate of count	Float64
memory-used	Memory used	Int64
memory-used_diff	Difference in memory used	Int64
memory-used_rate	Rate of memory used	Float64
total-capacity	Total capacity	Int64
total-capacity_diff	Difference in total capacity	Int64
total-capacity_rate	Rate of total capacity	Float64
start-time	Start time	Int64
vm-version	Version of the VM	String
management-spec-version	Version of the management specification	String
spec-name	Name of the specification	String
class-path	Class path	String
vm-name	Name of the VM	String
uptime	Uptime of the system	Int64
spec-version	Version of the specification	String
spec-vendor	Vendor of the specification	String
garbage_collector_unique_id	Unique identifier for the garbage collector	String
collection-count	Count of garbage collections	Int64
collection-time	Time spent on garbage collection	Int64
collection-count_diff	Difference in collection count	Int64
collection_count_rate	Rate of garbage collection count	Float64
collection_time_diff	Difference in collection time	Int64
collection-time_rate	Rate of garbage collection time	Float64
compilation_unique_id	Unique identifier for compilation	String
compilation-time-monitoring-supported	Indicates if compilation time monitoring is supported	Bool
total-compilation-time	Total compilation time	Int64
total-compilation-time_diff	Difference in total compilation time	Int64
total-compilation-time_rate	Rate of total compilation time	Float64
loaded-class-count	Count of loaded classes	Int64
total-loaded-class-count	Total count of loaded classes	Int64
unloaded-class-count	Count of unloaded classes	Int64
system-load-average	System load average	Float64
available-processors	Number of available processors	Int32
arch	Architecture of the system	String
version	Version of the system	String
threding_unique_id	Unique identifier for threading	String
object-monitor-usage-supported	Indicates if object monitor usage is supported	Bool
thread-count	Number of threads	Int64
thread-cpu-time-enabled	Indicates if thread CPU time is enabled	Bool
thread-contention-monitoring-enabled	Indicates if thread contention monitoring is enabled	Bool
daemon-thread-count	Number of daemon threads	Int64
total-started-thread-count	Total count of started threads	Int64
thread-contention-monitoring-supported	Indicates if thread contention monitoring is supported	Bool
peak-thread-count	Peak thread count	Int64
current-thread-user-time	Current thread user time	Int64
current-thread-cpu-time-supported	Indicates if current thread CPU time is supported	Bool
current-thread-cpu-time	Current thread CPU time	Int64
thread-cpu-time-supported	Indicates if thread CPU time is supported	Bool
current-thread-user-time_diff	Difference in current thread user time	Int64
current-thread-user-time_rate	Rate of current thread user time	Float64
thread-count_diff	Difference in thread count	Int64
thread-count_rate	Rate of thread count	Float64
current-thread-cpu-time_diff	Difference in current thread CPU time	Int64
current-thread-cpu-time_rate	Rate of current thread CPU time	Float64
daemon-thread-count_diff	Difference in daemon thread count	Int64
daemon-thread-count_rate	Rate of daemon thread count	Float64