| Oracle Enterprise Manager Oracle Trace User's Guide |  Library |
 Product |
 Contents |
 Index |
| Oracle Enterprise Manager Oracle Trace User's Guide | Library |
Product |
Contents |
Index |
The following sections explain this methodology, as well as:
Because Oracle Trace uses the Oracle Enterprise Manager job subsystem to perform its tasks, the Oracle Enterprise Manager console must be running at the same time as Oracle Trace.
Figure 2-1: Oracle Trace Main Window
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 provides information relating to the task you are performing. 
Left Pane
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 the nodes that have been discovered by Oracle Trace. Expanding each node displays a list of products and databases that are instrumented. Each product or database may contain one or more collections that have been executed, or are currently executing. Click on the '+' to expand the tree and '-' to collapse the tree. Right Pane
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. Note:
The repository is a set of tables stored in an Oracle database. For a more detailed description of the repository, refer to the Oracle Enterprise Manager Concepts Guide. Collection
The collection name. Status
The current status of the collection: active, inactive, or stopped. Node
The name of the node on which the collection was run. Oracle Installation
The location of the set of products from which data is being collected. Formatted
The format status of the collection data. The status is listed as Yes if all the data has been formatted. If no status is listed, then the data has not been formatted. Toolbar Icons
The Oracle Trace toolbar icons represent the items in the menus. The toolbar options (see Figure 2-2) are enabled depending on the objects selected in the tree list. The Oracle Trace icons are:
Figure 2-2: Toolbar Icons
+
Creates a collection. Click the + toolbar icon to create a collection. | |
Creates a similar collection. Click the | | toolbar icon to create a collection similar to another collection. This is the same as choosing Collection=>Create Like... Box
Stops a collection. Select a collection in the tree list and click this icon to stop a collection. Files/Databases
Formats a collection. Select a collection in the tree list and click this icon to format a collection. X
Deletes a collection. Select a collection in the tree list and click this icon to delete the existing collection. Files/X
Deletes files. Select a file in the tree list and click this icon to delete the file. Database/X
Deletes formatted data. Select a file populated with formatted data and click this icon to delete formatted data. arrow ?
Press the arrow ? toolbar icon to activate context-sensitive help. Viewing Oracle Trace Menus
The following sections briefly describe the menus in the Oracle Trace Manager. The menus are:
For more information about invoking these menu options, see Running Oracle Trace in Administrative Mode on page 7-1.
Help Menu
The Help menu contains the following options: Contents
Provides a list of Oracle Trace help topics. Search for Help On...
Displays a dialog box containing a scrollable list of index entries and keywords that you can search for in the help system. Using Help
Displays information on using the Microsoft Windows help system. About Oracle Trace
Displays a dialog box containing version and copyright information about Oracle Trace. Discovering Products
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 displays asking whether you want to perform an Oracle Trace discovery (see Figure 2-3).
The 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 Enterprise Manager console. Products and services enabled with Oracle Trace calls are located or 'discovered' by the Oracle Trace Manager during the product discovery process.
Figure 2-3: Invoking Oracle Trace for the First Time
To populate the tree list with products that are instrumented with Oracle Trace, you must tell Oracle Trace to discover these products.
Figure 2-4: Product Discovery Dialog Box
The Oracle Trace Discovery dialog box contains the following fields:
Node
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. Status
This field shows the status of the last discovery process that took place on the node. Last Discovered
This field lists when the last discovery took place for this node. Continue
When you click the Continue button, Oracle Trace begins the discovery process. The Product Discovery Status dialog box displays. This dialog box provides a visual cue to the progress of the discovery and the results of the process. Cancel
Click the Cancel button to stop the discovery process. Help
Click the Help button to get help on the discovery process. Creating Collections and Viewing Collection Data
You create Oracle Trace collections using the Collection Wizard. To access the Collection Wizard, do one of the following:
Once you have created a collection, you can view the collection properties but you cannot edit the collection. However, if you need to alter a collection, use the Collection=>Create Like... option, change the collection options needing to be updated, and start the new collection.
Figure 2-5: Collection Property Pages
General Page
The General page provides a minimal amount of information about collections. The information includes the location of the collection file, the duration of the collection, a description of the collection file, and the product/event set pairs that comprise the collection. The fields on the General page are:
Progress Page
The Progress page displays the status of the collection as it was running, including the notification time. The fields on the Progress page are:
Chapter 4, Producing Reports and Formatting Data, gives a complete description of the formatting steps.
Running Reports
After you have run the Oracle Trace collection (and, optionally, formatted the resulting data), you are ready to run the reports. The Oracle Trace reports are: Detail Report (default)
This report displays statistics for all items associated with every occurrence of every event for every product involved in the collection. Process Report
This report lists the processes that participated in the collection. You can then get a Detail report for a specific process.
Exiting Oracle Trace
To exit Oracle Trace:
For general information about causes and actions for most Oracle Trace messages, see the Oracle Enterprise Manager Messages Manual.
|
Prev Next |
 Copyright © 1996 Oracle Corporation. All Rights Reserved. |
Library |
Product |
Contents |
Index |