Chapter 11 Configuring the Diagnostic Service

The Diagnostic Service provides more visibility into and control of the runtime performance of a server and its applications, allowing you to diagnose and isolate faults as they occur.

This chapter contains the following sections:

• What is the Diagnostic Framework?

• Diagnostic Service Framework

What is the Diagnostic Framework?

The Application Server Diagnostic Framework is a monitoring framework that defines and implements a set of services that run within the application server standard life cycle. With the Diagnostic Service, you can define, create, collect, and access diagnostic data generated by a running server and the applications it deploys.

Diagnostic Service Framework

The diagnostic service reports configuration details for the application server instances. It is useful for diagnosing application server problems such as exceptions, performance issues, and other unexpected results. From within the Admin Console Diagnostic Service you can:

• Compute Checksum: Collects checksum for selective Application Server binary files under appserver_install_dir/ lib, appserver_install_dir/etc and appserver_install_dir/bin directory

• Verify Configuration: Captures configuration files such as, domain.xml, server.policy.

• Capture Install Log: Installation specific details such as Application Server version number or patch ID and contents of log file generated at the time of installation. Absolute path for installation directory is used to determine which Installer log file is collected if there are multiple installations on the same machine. The contents of config/asenv.conf is copied from the installation folder for DAS as well as node agents.

  Installation specific details are collected only for file-based installations.

• Capture System Information: The following system information is collected by default:

  • Network Settings

  • OS details

  • Hardware information

  Data collected using native code is not available on the Platform Edition of Application Server.

• Capture Application Deployment Descriptor: Deployment descriptors such as ejb-jar.xml, sun-ejb-jar.xml, web.xml, sun-web.xml, and sun-sip.xml

• Log Level:

• Log Entries:

  The number of log entries to be included in the generated diagnostic report.

Generating a Diagnostic Report

Generating a diagnostic report is based on the preferences you set in the Application Server Diagnostic tab in the Administration Console. Confidential data appears in the generated report as listed in the Confidential Properties table.