This topic provides examples of information that you might find in a log:
The following example contains a LOG EVENT message that occurred on August 07, 2012, at 11:22:14 A.M. with a severity level of CONFIG
from an InstallationTask
source class:
(Click the image to expand it.)
The general format of all the log messages in the text file format is:
(<timeOfEvent>),<severityOfEvent>,<sourceOfEvent>,<eventMessageContent>
The severity levels from highest to lowest value are:
The following table describes the main log message types:
Message type | Description |
---|---|
LOG EVENT | Describes the following types of information:
|
PROGRESS EVENT | Describes how much of a task is completed. These messages correspond to progress bar updates and the localized resource keys that are used to determine messages on the progress bar. |
THROWABLE EVENT | Describes failures with stack traces |
Summary section | Provides a summary at the end of the log that contains the same type of data shown on the installation summary panel (for example, whether the installation was successful or unsuccessful, and if unsuccessful, what features failed to install) |
The following examples show LOG EVENT messages.
The following example shows an example PROGRESS EVENT
message:
(Click the image to expand it.)
This type of message identifies the progress of tasks. A task encapsulates a chunk of related logic. Some tasks execute logic that can run for hours. Progress messages give a relative measure of how much of a task has been completed. If no progress messages occur for a long period of time, it might indicate that an installation has stopped responding.
The following example shows an example THROWABLE EVENT
message:
(Click the image to expand it.)
This type of message records exception stack traces. For example, suppose an installation runs 100 SQL commands against a database and halfway through the installation, the database goes down. These messages provide runtime information about the exception that occurred.
The following example shows an example summary:
(Click the image to expand it.)
This type of message appears at the end of an installation, upgrade, or uninstallation. It gives a log-file equivalent of the final summary panel, indicating whether the overall installation succeeded, failed, or finished with warnings. It provides a quick summary of whether the installed product is in a working or broken state.