Use the unmonitorEndpoint command to stop monitoring the specified endpoint with the monitor agent where it is registered.

Once monitoring stops, no performance measurements are recorded, no messages are logged, and no transactions are traced.

Use the monitorEndpoint command to re-enable monitoring.

Command Syntax

btmcli unmonitorEndpoint -n name | -e endpointUrl1 [[endpointUrl2] ...] 
                         -s sphereUrl -l username:password
Name Long Name Description
-n -name The friendly name of the endpoint to stop monitoring.
-e -endpointUrl A list of endpoint URLs for the endpoints you want to stop monitoring.

If this is a web service, you can supply the actual URL to reach the endpoint. If this is another type of component, look in the Profile tab in the management console to determine the endpoint's URL.

-s -sphereUrl The URL of the sphere.


This flag is not required if you have set the AP_SPHERE_URL environment variable for your sphere.

-l -userLogin The username and password associated with the sphere, in the format: username:password. This set of credentials must belong to a user in the btmadmin role.

See Security Options in Accessing CLI Commands for information on furnishing login credentials.

You can encrypt passwords using the encryptPassword command.


The following example shows the unmonitorEndpoint command used to stop monitoring MyEndpoint.

btmcli unmonitorEndpoint -n MyEndpoint 
                         -s http://localhost:8080/btmcentral/sphere/ 
                         -l Admin:abracadabra