About Logging

Library logging is composed of system reports, fault reports, and support bundles.

What is a System Report?

Jobs and intelligent devices (those with onboard processors) generate system reports when a potential fault has occurred. The library evaluates the information in the system report and attempts to recover from the issue. If the library cannot resolve the issue, it creates a fault report, support bundle, and notification (email, SNMP, outbound SCI, or ASR).

After a job or device generates a system report, the library attempts to recover. The library will either initiate a recovery job or initiate handling of the fault. A typical recovery job will:

Perform one or more diagnosis tests
Generate a suspect FRU list and create a final system report indicating the failed device (if a failed FRU is identified)
Log the status of the diagnosis

What is a Fault Report?

If the library cannot recover from an issue indicated in a system report, it generates a fault report. The report lists the faulted device and log information. Faults also generate a support bundle and notifications (email, SNMP, outbound SCI, ASR).

What is a Support Bundle?

Support bundles contain encrypted log files and database information used for fault diagnosis by Oracle service personnel. The library automatically generates a support bundle when it detects a fault.

Related Topics

Fault Example

A fault creates a system request, fault report, and support bundle. Understanding the fault process can help explain library logging.

Sample fault flow described in the surrounding text.

In this example, an external client (such as the GUI) creates a request. That request creates a parent job, which creates a sub job. The sub job encounters an issue and submits a request for a system report. The system report generates a recovery job. When the recovery job is unsuccessful, it creates a fault event job which creates a fault report. The fault then generates a support bundle and sends out notifications to any destination registered to receive the fault event category.

The initial request is the "source request", and the sub job that encountered the issue is the "source job". The request submitted by the sub job to create the system report is the "created request". The recovery job is the "created job". Depending on the actions taken by the library to complete the requests, the details about the request may contain output messages and log messages.