IBM InfoSphere Streams Version 4.1.0

Log files

Administrators use log files to monitor and diagnose problems with InfoSphere® Streams and Streams applications. InfoSphere Streams collects log data for each host in an instance.

The following table describes how Streams Studio retrieves log data from InfoSphere Streams and the default name and location in the StreamsStudioLogs Eclipse project.

Table 1. Log data, options, and names and locations of log files
Log data	Option to retrieve log data	Location in the StreamStudioLogs project	Name of the log file
Job	Get Job Logs	`instanceid`/jobs/`jobid`/	job_`jobid`.log
PE	Show PE Log	`instanceid`/jobs/`jobid`/	job_`jobid.pe`_`peid`.log
Operator	Show Operator Log	`instanceid`/jobs/`jobid`/	job_`jobid`-`operatorName`.log

If InfoSphere Streams is configured to use the Linux syslog utility for logging data, log messages are written to the Linux system log and you must use Linux commands to access the log files.

Job logs

The job logs help you understand the behavior of the job in an instance.

You can retrieve the job logs from the Streams Explorer view, Metrics view, or Instance Graph view.

The job logs include the following files:

The log file for the job. The log file contains the log entries for all of the PEs and operators in the job.
Trace and console files of all the PEs in a job.

PE logs

The PE logs help you to diagnose job problems and to view the standard output and log messages from a job.

You can retrieve the PE logs from the Streams Explorer view, Metrics view, or the Instance Graph view.

The PE logs consist of the following files:

A log file that contains the SPL application log messages for the PE operators.
A trace file that contains the SPL application trace messages for the PE operators.
A console log that contains the standard output and error streams for the PE.

The Show PE Log option retrieves the SPL application log messages for the PE operators. Streams Studio opens the log file in the Console view.

Operator logs

The operator logs contain operator-logged messages and provide additional operator-specific information to aid in problem determination.

You can retrieve the operator logs from the Instance Graph view or the Metrics view.

The operator logs consist of the following files:

A log file that contains the SPL application log messages for the operator.
A trace file that contains the SPL application trace messages for the operator.

The Show Operator Log option retrieves the log file. Streams Studio opens the log file in the Console view.