Oracle(R) Enterprise Manager Oracle(R) Trace User's Guide Release 2.0 A67837-01 |
|
Oracle Trace collects data for products that are instrumented with the Oracle Trace data collection API. Use the Oracle Trace Manager application to create and administer Oracle Trace collections for instrumented products.
Oracle Corporation has instrumented Oracle Server release 7.3 and higher with the Oracle Trace data collection API.
As you add additional custom products to nodes that are managed through Oracle Enterprise Manager, you can use Oracle Trace Manager to automatically discover these products and make them available for collection administration.
This chapter includes the following sections:
You start Oracle Trace from the Oracle Enterprise Manager console using either the:
You can also start Oracle Trace from the Start menu:
Start=>Programs=>ORACLE_HOME=>Diagnostics Pack=>Trace Manager
Provide the login information needed in the Oracle Management Server Login dialog box.
The process of starting an application in Oracle Enterprise Manager is referred to as launching.
Because Oracle Trace uses the Oracle Enterprise Manager job subsystem to perform its tasks, the Oracle Management Server must be running at the same time as Oracle Trace.
Oracle Trace Manager provides the user with a graphical navigator display of products and database services that are enabled for Oracle Trace data collection. These products and services reside on nodes that are managed by the Oracle Management Server. Products and services enabled with Oracle Trace calls are located or discovered by Oracle Trace Manager during the product discovery process.
The Oracle Trace discovery process gathers information on products and services enabled (instrumented) with Oracle Trace calls by submitting batch jobs to specific nodes through the Oracle Enterprise Manager Job system and Oracle Intelligent Agent. These jobs query the managed nodes for products enabled with Oracle Trace API calls and return the results to Oracle Trace Manager, which updates the repository and the Oracle Trace Manager graphical display. The user can only submit Oracle Trace collections for products and services that have been successfully discovered.
When you invoke Oracle Trace for the first time, the tree list in the left pane of the Oracle Trace main window is empty; there are no entries under Collections. A message appears asking whether you want to perform an Oracle Trace discovery (see Figure 2-1).
To discover products for the first time, click on the Yes button. At any other time, invoke Product=>Discovery. The Oracle Trace Discovery dialog box displays, as shown in Figure 2-2.
The Oracle Trace Discovery dialog box contains the following fields and buttons:
Select the nodes on which you want to perform the discovery. Only nodes that have Oracle Enterprise Manager agents running on them are displayed in the dialog box. For each selected node, the discovery process identifies whether Oracle Trace is installed on the node and what products are available for data collection. For products to be available for data collection, they must be instrumented with Oracle Trace calls.
This field shows the status of the last discovery process that took place on the node or the status of the current discovery.
This field lists when the last discovery took place for this node.
When you click the Continue button, Oracle Trace begins the discovery process. The Product Discovery Status box displays. This box provides a visual cue to the progress of the discovery and the results of the process.
Click the Cancel button to stop the discovery process.
Click the Help button to get help on the discovery process.
Click the Select All button to choose all the available nodes.
Click the Clear All button to deselect the nodes.
After discovery has completed, you will see a list of discovered nodes and products. If you have created Oracle Trace collections on a node that fails Oracle Trace discovery, or if specific products or services fail discovery, the Oracle Trace navigator displays these collections and all associated products and services as disabled (grayed out).
When you launch Oracle Trace, the Oracle Trace Manager main window displays, as shown in Figure 2-3.
The window consists of menus, panes, a toolbar, and a status bar. Use the menus and the toolbar to access Oracle Trace functionality. The status bar at the bottom of the window provides information relating to the task you are performing.
The left pane of the Oracle Trace main window provides a tree structure representing the hierarchy of the Oracle Trace objects. The top-most object in the tree structure is the Collections container. Expanding this container displays all of the nodes that have been discovered by Oracle Trace. Expanding each node displays the list of products and databases installed on that node that are available for Oracle Trace collection. Each product or database may contain one or more collections that have been executed, or are currently executing. Click on the plus sign (+) to expand the tree and the minus sign (-) to collapse the tree.
The right pane of the window displays information relevant to the object highlighted in the left pane. In general, this information provides details about active and completed Oracle Trace collections for a selected object in the tree. The information is based on data stored in Oracle Trace tables within the Oracle Enterprise Manager repository.
Some or all of the following information is provided in the right pane of the Oracle Trace main window, depending on what is highlighted in the left pane:
The collection name.
The current status of the collection: created, running, completed, formatting, scheduled, stopping, stopped, deleting files, deleted files, and unknown.
The name of the node on which the collection was run.
The location of the set of products from which data is being collected.
The format status of the collection data. The status is listed as Yes if all of the data has been formatted. If the status is listed as No, then the data has not been formatted.
The Oracle Trace toolbar icons represent the items in the menus. The toolbar options (see Figure 2-4) are enabled depending on the objects selected in the tree list.
The Oracle Trace icons are as follows:
Creates a collection. Click this icon to create a collection.
Creates a similar collection. Select a collection in the tree list, then click this icon to create a similar collection. This is the same as choosing the Collection=>Create Like... option.
Stops a collection. Select a collection in the tree list and click this icon to stop collecting event data.
Formats a collection. Select a collection in the tree list and click this icon to format a collection.
Deletes a collection from Oracle Trace Manager. Select a collection in the tree list and click this icon to delete the existing collection. This option also gives you the opportunity to delete the collection definition file, the data collection file, and formatted data.
Deletes the collection definition file (.cdf) and data collection file (.dat) for the selected collection.
Deletes formatted data. Select a collection with formatted data and click this icon to delete formatted data from the database.
Invokes Windows help mode. After clicking this icon, you can click the pulldown entry to see the object's context-sensitive help without invoking its command.
The following sections briefly describe the menus in Oracle Trace Manager. The menus are:
The File menu contains the following option:
Exits the Oracle Trace application.
Collections that are currently running will continue to run until they are stopped, the maximum file size is reached (if one was specified when the collection was started), or the scheduled end time is reached.
The Edit menu contains the following options:
Removes highlighted text and places it in a buffer for the Paste operation. You can use this option in the Collection Wizard.
Makes a copy of highlighted text to be pasted in another location. You can use this option in the Collection Wizard.
Places copied or cut text at the position of the cursor. You can use this option in the Collection Wizard.
Displays the Preferences dialog box in which you specify default format options used by the Collection Wizard.
The View menu contains the following options:
Forces Oracle Trace to update and validate against Oracle Enterprise Manager node and database information.
Enables or disables display of the toolbar in the Oracle Trace Manager main window. A check next to the Toolbar option indicates that the toolbar is enabled.
Enables or disables display of the Status bar in the Oracle Trace Manager main window. The Status bar displays status messages as actions are performed. A check next to the Status Bar option indicates that status messages are enabled.
The Collection menu contains the following options:
Starts the Collection Wizard. Use this wizard to enter the information that Oracle Trace needs to create a collection.
Starts the Collection Wizard if a collection is highlighted in the left pane of the Oracle Trace Manager main window. The information from the highlighted collection is copied to the new collection. You can either accept or change this information.
Stops an active collection selected in the tree list.
Formats the collection data to a database.
Starts the Oracle Trace Data Viewer application. This option is enabled when the collection highlighted in the right pane is a formatted collection.
Deletes a collection from Oracle Trace Manager. Select a collection in the tree list and choose this option to delete the existing collection. This menu item also gives you the option to delete the collection definition file, the data collection file, and formatted data.
Deletes formatted data. Select a collection with formatted data and click this option to delete formatted data from the database.
Deletes the collection definition file (.cdf) and the data collection file (.dat) for the selected collection.
The Product menu contains the following options:
Starts a process that identifies whether Oracle Trace is installed on a node, and if so, identifies what, if any, products enabled with Oracle Trace API calls are on that node.
Creates a new product definition file.
Edits an existing product definition file.
The Help menu contains the following options:
Provides a list of Oracle Trace help topics.
Displays a dialog box containing a scrollable list of index entries and keywords that you can search for in the help system.
Displays information on using the Microsoft Windows help system.
Displays a dialog box containing version and copyright information about Oracle Trace Manager.