Oracle Enterprise Manager Oracle Trace User's Guide

Library

Product

Contents

Index

Preface

Audience
How This Guide Is Organized
Conventions Used in This Guide
Related Publications
Your Comments Are Welcome

This guide serves two purposes. It provides user instructions for the Oracle Trace graphical user interface, and it describes Oracle Trace service routines and how to add them to an application for the purpose of collecting event data.

Audience

This guide is divided into two parts for different audiences.

Part I is written for Oracle Trace users who want to set up data collection using the Oracle Trace Manager application, the graphical user interface for Oracle Trace. Users of Part I should be familiar with database terminology.

Part II is written for application developers who want to add Oracle Trace service routines to their own applications, for the purpose of collecting performance data. Developers using Part II should be familiar with programming terminology, in particular C++.

How This Guide Is Organized

This guide is organized as follows:

Chapter 1, Overview

Provides a general description of Oracle Trace.

Part I: Collecting and Reporting Oracle Trace Data

Chapter 2, Using Oracle Trace

Describes how to invoke Oracle Trace, the initial windows displayed, and how to exit.

Chapter 3, Creating, Formatting, and Deleting Collections

Describes how to create, edit, stop, and delete Oracle Trace collections.

Chapter 4, Producing Reports and Formatting Data

Describes how to produce reports from Oracle Trace data collections.

Part II: Developer's Guide to Oracle Trace

Chapter 5, Instrumentation Guidelines

Discusses the issues you should consider when instrumenting an application. It also briefly describes the instrumentation process.

Chapter 6, Relating Data Between Products

Describes the Oracle Trace method for passing data between products to provide better understanding of the context in which events occur.

Chapter 7, Creating Product Definitions

Explains what product definitions are, why they are necessary, and how to create them.

Chapter 8, Oracle Trace Routines

Provides information about the correct way to call Oracle Trace routines. It also provides a complete description of each routine.

Appendix A, Using Oracle Trace for Oracle Server Data Collections

Describes the events that have been added to the Oracle Server for Oracle Trace data collection.

Appendix B, Oracle SQL*Net Release 2.3 Events

Describes the events that have been added to SQL*Net for Oracle Trace data collection.

Appendix C, Oracle Trace Format Database

Describes the format of the database that Oracle Trace creates.

Appendix D, Sample Instrumented Application

Provides a sample application that shows various calls to Oracle Trace routines.

Conventions Used in This Guide

Table 1 lists the conventions used in the guide.

**Conventions Used in This Guide**
Convention	Explanation
#	The default superuser prompt.
%	The default user prompt.
[Ctrl/C]	Press the Ctrl key while you simultaneously press another key (in this case, C).

This guide also assumes that you are familiar with the operation of Microsoft Windows NT. Refer to the Windows documentation for your system, if necessary.

To reduce wordiness and redundancy, menu and submenu choices are joined by arrows. For example, Collection=>Create refers to the Create Collection choice in the Collection menu.

Related Publications

The following documentation provides additional information about Oracle Enterprise Manager:

Oracle Enterprise Manager Installation Guide
Oracle Enterprise Manager Concepts Guide
Oracle Enterprise Manager Administrator's Guide
Oracle Enterprise Manager Oracle Expert User's Guide
Oracle Enterprise Manager Performance Monitoring User's Guide
Oracle Enterprise Manager Messages Manual

Oracle Corporation also publishes a README file, which is available on your distribution media. This file provides information about software functionality and restrictions that was not available at the time product documentation was printed. For software updates that are not accompanied by new manuals, this file may also describe any minor changes in the product.

It is important that you read this file so that you have an accurate understanding of the software's functionality.

Your Comments Are Welcome

We value and appreciate your comments as an Oracle Trace user and reader of the manuals. As we write, revise, and evaluate our documentation, your opinions are the most important input we receive. At the back of our printed manuals is a Reader's Comment Form, which we encourage you to use to tell us what you like and dislike about this manual or other Oracle manuals. If the form is not available, please use the following address or FAX number:

Oracle Trace Documentation
Oracle Corporation
110 Spit Brook Road, ZK02-1/O19
Nashua, NH 03062-2698
U.S.A.
Electronic mail (nedc_doc@us.oracle.com)
FAX: 603-881-0120 Attn: Oracle Trace Documentation

Prev Next

Library

Product

Contents

Index