Oracle Enterprise Manager Oracle Trace Developer's Guide
Release 1.4.0
A53697_01

Library
Product
Contents
Index

Prev Next


Preface

Purpose

This guide describes Oracle Trace service routines and how to add them to an application for the purpose of collecting event data.

Audience

This guide 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 should be familiar with programming terminology, in particular for the C++ programming language.

How This Guide Is Organized

This guide is organized as follows:

Chapter 1, Overview

Provides a general description of Oracle Trace.

Chapter 2, Oracle Trace Architecture

Introduces the Oracle Trace components and the command-line interface. It also walks you through the workings of Oracle Trace.

Chapter 3, Oracle Trace Methodology

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

Chapter 4, Advanced Topics

Provides more detail for the concepts introduced in chapters 2 and 3.

Chapter 5, Creating Product Definitions

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

Chapter 6, Producing Reports and Formatting Data

Describes how to produce reports from Oracle Trace data collections.

Chapter 7, 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, Components of Oracle Trace

Provides more in-depth information about the Oracle Trace components and how they relate to each other.

Appendix B, 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 C, Oracle SQL*Net Events

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

Appendix D, Oracle Trace Format Database

Describes the format of the database that Oracle Trace creates.

Appendix E, Sample Instrumented Application

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

Conventions Used in This Guide

The following table lists the conventions used in the 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).  

SQL*Net  

Represents SQL*Net and Net8.  

$ORACLE_HOME  

Represents the directory where you installed Oracle Enterprise Manager components and Performance Pack products. The directory name may be different on your system.  

otracexx  

The xx represents the version of the database for which you are collecting data, for example, otrace73 for the Oracle Server release 7.3.  

In general, this guide shows directory names as they are used in UNIX; on NT systems delineate directory names with a backslash "\".

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

Related Publications

The following documentation provides additional information about Oracle Enterprise Manager:

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 published. 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 the README file so that you have an accurate understanding of the software's functionality.


Prev
Next
Oracle
Copyright © 1997 Oracle Corporation.
All Rights Reserved.

Library
Product
Contents
Index