Openshift JBoss Cartridge

An OpenShift  cartridge that will enable AppDynamics monitoring on JBoss AS, JBoss EAP, JBoss EWS  applications. It will install AppDynamics Java AppServer Agent on the gear and will report metrics to the configured AppDynamics controller.

This should be used as an OpenShift embedded/plugin cartridge.

 

Install

 

Once you have created a Jboss application (AS,EAP or EWS only) either through the OpenShift Web or RHC command line util, please follow the next step to add the jboss appDynamics cartridge. 

 

 

rhc add-cartridge -a <app_name> \
				  -e APPDYNAMICS_CONTROLLER_HOST_NAME=<appd_contr_host> \
				  -e APPDYNAMICS_CONTROLLER_PORT=<appd_contr_port> \ 
				  -e APPDYNAMICS_AGENT_APPLICATION_NAME=<appd_application_name> \
				  -e APPDYNAMICS_AGENT_TIER_NAME=<appd_tier_name> \
				  -e APPDYNAMICS_CONTROLLER_SSL_ENABLED=<true/false>\
				  -c http://cartreflect-claytondev.rhcloud.com/reflect?github=Appdynamics/openshift-appdynamics-jboss-cartridge

SAAS environment

 

If it is a dedicated or a multi-tenant controller, please pass the accountName and accountKey as well to the above command.

 

rhc add-cartridge -a <app_name> \
				  -e APPDYNAMICS_CONTROLLER_HOST_NAME=<appd_contr_host> \
				  -e APPDYNAMICS_CONTROLLER_PORT=<appd_contr_port> \ 
				  -e APPDYNAMICS_AGENT_APPLICATION_NAME=<appd_application_name> \
				  -e APPDYNAMICS_AGENT_TIER_NAME=<appd_tier_name> \
				  -e APPDYNAMICS_CONTROLLER_SSL_ENABLED=<true/false>\
				  -e APPDYNAMICS_AGENT_ACCOUNT_NAME=<appd_agent_accountname>
				  -e APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=<appd_agent_account_access_key>
				  -c http://cartreflect-claytondev.rhcloud.com/reflect?github=Appdynamics/openshift-appdynamics-jboss-cartridge

 

 

Make sure you have the ports opened for SSL (default:8181) and non-ssl (default:8090) configurations.

 

Please note that the AppDynamics NodeName will be picked up as the Gear UUID (OPENSHIFT_GEAR_UUID).

 

The application has to be restarted either by using the above restart command or by pushing code which would inherently restart the application.

 

rhc app restart <app_name>

 

Make sure you have the ports enabled for SSL and non-ssl configurations.

 

Remove

 

rhc cartridge-remove appdynamics-jboss-cart -a <app_name>

 

 

 

Contributing

 

Always feel free to fork and contribute any changes directly via GitHub

 

Community

 

Find out more in the Community

 

Support

 

For any support questions, please contact help@appdynamics.com.

 

Version:

1.0.0

Compatibility:

3.8.2

Last Update:

08/30/2014

 

 

Attachments: