RTI Quick Start Guide for JBoss Operations Network Users This is the RTI Quick Start guide for JBoss Operations Network Users. It will help you get RTI installed and collecting data on your application quickly in an environment where you're already using JBoss Operations Network (JON) 3.x or RHQ 4.x. The steps that you'll follow are: 1. Download and Install the RTI Console, RTI performance collectors and RTI server and agent plugins. 2. Enable RTI performance collection on each application, and add the RTI plugins to JBoss Operations Network server and agents. 3. Profile your application by capturing the data RTI is collecting as you test your applications 4. Deep Dive to determine exactly when, where and why your application was slow or resource-intensive. The diagram below shows where the RTI components fit into an enterprise application using JBoss Operations Network or RHQ. For full details and further information see the RTI User Guide. RTI-Enhanced JBoss Operations Network Architecture 1
1. INSTALL Install RTI Components and prepare for monitoring. Download RTI Components Visit rtiperformance.com/download to request a download. 1. Download Linux and/or Windows RTI Performance collectors. 2. Download Linux, Mac or Windows RTI console application. 3. Download RTI Plugins for JBoss Operations Network or RHQ Install RTI performance collectors 1. Windows: Run the rti-enterprise-3.4.4-win32-*.exe self-installer. 2. Linux: execute the installer with bash: sh rti-enterprise-3.4.4-lx86-*.sh 3. See the user's guide for more information. Install RTI Console on your Desktop 1. Windows: a. Run rti-console-3.4.4-win32-*.exe self-installer 2. Mac: a. Unarchive rti-console-3.4.4-macosx86_64-*.tgz b. Open (run) the RTIEEConsole64/RTIAnalyzer application 3. Linux: a. Unpack the tarball to create the RTIEE64Console directory: tar -zxf rti-console-3.4.4-lx86_64-*.tgz b. Update path to include RTIEEConsole64, for example: export PATH=/opt/RTIEEConsole64:${PATH} c. Launch RTI with the RTIAnalyzer command, for example: /opt/rtieeconsole64/rtianalyzer 4. See the user's guide for more information. 2
1. INSTALL Install RTI Plugins for JBoss Operations Network (or RHQ) 1. Download rti-agent-3.4.4-*.jar and rti-server-3.4.4-*.jar from RTI Download page 2. Login via the JBoss Operations Network web console 3. Upload RTI plug-ins: Select Administration tab Select Configuration#Agent Plugins Upload RTI agent plugin: rti-agent-3.4.4-*.jar Select Scan for Updates Repeat for Configuration#Server Plugins and upload rti-server-3.4.4-*.jar 4. Force RTI plugin deployment (optional): Select Inventory#Platforms#${your.platform} Select and right-click RHQ Agent, select Operations#Update All Plugins 5. See the user's guide for more information. 3
2. ENABLE Finish Installation by enabling your JBoss, Tomcat or Fuse instance to be monitored by RTI. Before, during and after checklist. BEFORE - You must have already installed RTI Performance Collectors on your Linux or Windows Platforms. DURING - Your user has permissions to edit the JBoss, Tomcat or Fuse startup scripts and enable RTI performance monitoring. AFTER - You must use the JBoss Operations Network Discovery process to discover and then import RTI into your inventory. Enable your JBoss, Tomcat or Fuse application for RTI Performance Monitoring 1. Open a shell or CMD window and "source" the RTI environment: Linux: Source the RTI setup env, for example:. ${RTI_HOME}/setup Windows: Open an RTI CMD Window with Start>All Programs>RTI>RTI Enterprise CMD 2. Enable the JBoss, Tomcat or Fuse instance for monitoring with "rti edit", for example: rti edit -t jboss /opt/jboss-soa-p-5/jboss-as rti edit -t tomcat c:\apache-tomcat-6.0.30 rti edit -t fuse /opt/jboss-fuse-6.0.0.redhat-024 Note If you run JBoss domain mode or use a service wrapper to start your application server, you cannot use rti edit: See the user's guide for more information. 3. Start or restart your application: RTI is now enabled and monitoring performance. 4. See the user's guide for more information. Connect RTI Console to RTI collectors and JBoss Operations Network platforms 1. Use your web browser to verify you can connect to the JBoss Operations Network server and Discover the platforms on which RTI has been enabled 2. Start the RTI Console and select Connect to JBoss Managed Platforms. 3. Enter login information for JBoss Operations Network (for example, "rhqadmin" and password) 4
2. ENABLE 4. Select on or more managed platforms to connect. 5. Verify the platforms are available in the RTI Console Collectors view, expand each platform to see the RTI installation and the monitored applications. 6. See the user's guide for more information. 5
3. PROFILE Transaction profiling is the lightweight solution to analyze and diagnose the performance of your applications. With less than 2% overhead transaction profiling gives you 24/7 always on performance visibility, to show where your application is spending time. View transaction profiles Transaction profiling is available out of the box for JBoss, Tomcat and Fuse applications 1. Select View Transaction Profile Snapshots. 2. Choose an application to profile. 3. See transaction performance and JBoss Operations Network measurements in a single dashboard 4. See the user's guide for more information. 6
3. PROFILE Analyze and identify problem transactions 1. Analyze business transactions, response times, counts and total times to identify the expensive transactions. 2. Decompose transaction call stack to identify bottlenecks at the method level. 7
3. PROFILE 8
4. DEEP DIVE Trace problem transactions across platforms and JVMs, pinpoint problems to the method level and see context. Enable Deep Dive for problem transactions 1. From a Call Profile Snapshot, select one or more problem transactions for Deep Dive 2. Choose which transactions to trace and for how long, then Start Trace. 3. Exercise your application as RTI applies deep dive performance monitoring. 4. See the user's guide for more information. Collect the data 1. Deep Dive data is logged locally to the applications monitored; gather for analysis across one or more performance collectors. 2. Download data from the collector(s) in the time range that you traced. 3. See the user's guide for more information. 9
4. DEEP DIVE Analyze the data 1. Use the Event Summary to get an overview of transactions and metrics collected. 2. Use the Transaction Chart to focus on peaks of Transaction time to see when it was slow. 10
4. DEEP DIVE 3. Filter, plot and drill down into specific Transactions in the Transaction tree to see what was slow. 11
4. DEEP DIVE 4. Use GC and JMX Charts and Metrics to understand why the app was slow. The GC and JMX charts below are shown "maximized" which can be achieved for any view by clicking the icon in the upper right of its frame. 5. See the user's guide for more information. 12
5. FAQ Frequently Asked Questions I have a question... That s what we re here for. We take support seriously, email us anytime at rti_support@ocsystems.com. What are the prerequisites for RTI? RTI can monitor any JBoss 4+, Tomcat 5+ or Fuse 6+ instance running Java 1.5+ on 32 or 64-bit Windows or Linux, and the RTI Console runs on Windows, Mac and Linux Desktops. A full list of prerequisites is available at rtiperformance.com/documentation. What version of JBoss Operations Network does RTI support? RTI works with JBoss Operations Network v3+ or RHQ 4+ or with neither, standalone. What can RTI monitor other than JBoss? RTI supports many performance collectors including: End-User Experience (IE / Firefox), test automation (JMeter, SoapUI), Apache Tomcat and JBoss Application Servers. What is the overhead of running RTI? About 2% CPU overhead for transaction profiling, we recommend using this 24/7. Deep Dive is more depending on transaction load and application complexity, typically between 5->10%. How do I measure End-User Experience, JMeter or SoapUI transactions? This quick-start guide covers the most common scenario; the user's guide, full FAQ and more are available at rtiperformance.com/documentation. Do you support WebSphere, WebLogic or other Application Servers? Not now, we are focused on being the best performance monitoring solution for Tomcat, JBoss and RedHat Enterprise Middleware. How much does RTI cost? RTI is licensed annually as a subscription, based on the number of JBoss/Tomcat/Fuse CPU cores to be monitored. See rtiperformance.com/pricing for more information. 13