Contents

Title and Copyright Information

Preface

• About the Document
• Documentation Accessibility
• Conventions

1 Introduction

• 1.1 Overview
• 1.2 Flight Recorder Uses
  • 1.2.1 Profiling
  • 1.2.2 "Black Box" Problem Analysis
  • 1.2.3 Support and Debugging
• 1.3 Understanding Events
• 1.4 Performance Overhead
• 1.5 Memory and Disk Buffers
• 1.6 Garbage Collections and the Flight Recorder

2 Quick Start Procedures

• 2.1 Using JRockit Mission Control Client
• 2.2 Step 1: Start the Flight Recorder
• 2.3 Step 2: Set Recording Parameters
• 2.4 Step 3: Start the Recording
• 2.5 Stopping a Recording
• 2.6 Additional Information on the Flight Recorder GUI

3 Starting the Flight Recorder

• 3.1 Note on Running Multiple Recordings
• 3.2 Running the Default Recording
  • 3.2.1 Starting the Recording
  • 3.2.2 Configuring Disk Storage
    • 3.2.2.1 Setting the Repository Location
    • 3.2.2.2 Setting the Amount of Data Stored
  • 3.2.3 Default Start-Up Example
• 3.3 Starting an Explicit Recording
  • 3.3.1 Controlling the Flight Recorder for Explicit Recordings
    • 3.3.1.1 JRockit Mission Control Client
    • 3.3.1.2 Command-Line Option
    • 3.3.1.3 Diagnostic Commands
  • 3.3.2 Starting a Recording
  • 3.3.3 Checking Recording Status
  • 3.3.4 Stopping a Recording
• 3.4 Configuring Explicit Recordings
  • 3.4.1 Setting Maximum Size and Age
  • 3.4.2 Setting the Delay
  • 3.4.3 Setting Compression
• 3.5 Creating Recordings Automatically
  • 3.5.1 Creating a Recording On Exit
  • 3.5.2 Creating a Recording On an Unhandled Exception
  • 3.5.3 Creating a Recording by Using Triggers
  • 3.5.4 Manually Dumping Recording Data

4 Controlling Recording Data by Using Templates

• 4.1 What You Can Control
• 4.2 Mission Control Templates
  • 4.2.1 Profiling Normal
  • 4.2.2 Profiling with Locks
  • 4.2.3 Profiling with Exceptions
  • 4.2.4 Real Time
  • 4.2.5 Modifying a Template
  • 4.2.6 Server-side Templates

5 Troubleshooting and Security

• 5.1 Troubleshooting
• 5.2 Security

A Creating Your Own Server-side Templates

• A.1 Event Types and Relational Keys
• A.2 Server-side Templates
• A.3 File Format
• A.4 Concatenation Tool

B Command Reference

• B.1 Start-up Commands
• B.2 Diagnostic Command Reference
  • B.2.1 start_flightrecording
  • B.2.2 check_flightrecording
  • B.2.3 stop_flightrecording
  • B.2.4 dump_flightrecording

C Events