Product Information > JADE Object Manager Guide > Chapter 4 - JADE System Instrumentation and Diagnosis > Node Sampling

Node Sampling

The sampling of activities in JADE applications is produced at the node level. The JADE Object Manager invokes specified entry points in a user-provided dynamic library during its normal execution.

The user dynamic library can then process the information provided by the JADE Object Manager. For example, you could capture data to flat disk files for subsequent processing using a tool of your choice to obtain the operational profiles that you require.

The activities that you can sample enable you to understand the execution characteristics of runtime applications so that you can enhance application performance according to different hardware resources.

A JADE node can initiate sampling on any other node in the system. For example, a client node can sample statistics on another client node and the server node, or a server node can gather statistics on every client node that is attached to it.

When the JADE-supplied library is used, samples are output to your specified flat file, which must be visible to the node being sampled. These samples can then be gathered for subsequent analysis to meet your requirements.

You can use the JADE Monitor to analyze the contents of your node sampling files. For details, see the JADE Monitor User’s Guide.

For details, see the following subsections.

Capturing Sampling Data

JADE Initialization File

Node Class External Methods

beginSample

logObjectCaches

logRequestStatistics

logUserCommand

beginIndividualRequestsLogging

endIndividualRequestsLogging

endSample

System Class External Methods

beginSampleGroupDefinition

enableRemoteSampling

isRemoteSamplingEnabled

disableRemoteSampling

beginSample

logObjectCaches

logRequestStatistics

logUserCommand

beginIndividualRequestsLogging

endIndividualRequestsLogging

endSample

endSampleGroupDefinition

Sampling Library Interface

JADE Sampling Libraries

Sampling Filtering

Sampling Exception Handling

Statistics File Format

File Header

Begin Process

End Process

Begin Interval

End Interval

Local Request Statistics Format

Remote Requests Statistics Format

Individual Local Requests

Individual Remote Requests

Statistics File Request Values

Buffer Flag

Cache Statistics

Cache Buffer Activity

Cache Type

User Command

File Trailer

Considerations and Restrictions

Example of Code to Manually Sample Node Statistics

Direct Retrieval of Node Sampling Statistics

Initializing the filesmpl and tcpsmpl Sampling Libraries

Using the JADE Sampling Application

Accessing the JADE Sampling Application

Selecting Your JADE Sampling Options