8.9.3 Task log details
To the task log, JP1/AO outputs information about tasks starting and stopping, called plug-ins, return values of plug-ins, and other activity.
JP1/AO creates a task log folder for each task it executes. You can view and download the contents of the task log from the Task Details dialog box in the Tasks tab.
You can specify the maximum size (in KB) of the task log file in the user-specified properties file (config_user.properties). If the task log file size exceeds the maximum value, task log data is overwritten from the oldest data.
- Organization of this subsection
(1) Name and output location of task log files
The name and location of task log files are as follows:
In Windows
JP1/AO-installation-folder\data\task\task-ID\task_task-ID_1.log
In a cluster environment, interpret JP1/AO-installation-folder as shared-folder-name\jp1ao.
In Linux
/var/opt/jp1ao/data/task/task-ID/task_task-ID_1.log
In a cluster environment, interpret /var/opt/jp1ao as shared-folder-name/jp1ao.
(2) Information output to task log
The table below shows the information output to the task log, followed by an example of a task log entry.
Output sequence |
Type |
Example message |
---|---|---|
1 |
Basic information |
message-ID Plug-in execution has started. |
2 |
Plug-in definition |
message-ID Plug-in definition information |
3 |
Property (before plug-in execution) |
message-ID Property information at plug-in execution |
4 |
Basic information |
message-ID Plug-in execution has completed. |
5 |
Property (after plug-in execution) |
message-ID Property information after plug-in execution |
6 |
Standard output |
Standard output of plug-in execution results |
-- |
Error information |
message-ID An error occurred during plug-in execution. |
-- |
Debug information |
message-ID Arbitrary debug information |
-- |
Messages related to task operations |
|
-- |
Messages related to debug operations |
|
- Legend:
--: Output when a failure occurs, or when a task or debug operation is performed.
The following is an example of task log output:
KNAE08001-I Plug-in execution started (Task name: JP1/AJS root jobnet migration_multi_20131107141827,Task ID:5859,Step ID:/getRootJobnetKeyList,Execution ID:@A571). KNAE08005-I vendor=com.hitachi.software.dna.cts.jp1 KNAE08005-I name=osReadCSVExcelFileColumn KNAE08005-I version=01.10.00 : KNAE08006-I property=plugin.destinationHost, value=192.168.1.1 KNAE08111-I Remote command execution started. KNAE08102-I Remote command execution succeeded (Command: osReadCSVExcelFileColumn.bat "C:\AJS.xlsx" "Sheet 1" "1" "" "" "" "" 2>&1). : KNAE08010-I <Standard output (first line)> KNAE08010-I <Standard output (second line)> : KNAE08010-I <Standard output(nth line)> KNAE08002-I Plug-in execution finished (Task name: Obtain list of JP1/Cm2 monitored nodes,Task ID:3969,Step ID:/getNodeListFileJP1Cm2,Execution ID:@A105,Plug-in return value:0).
(3) Task log output levels
You can set the output level for task logs in a Service Share Property.
The output level setting determines what information is output to the task log. The following table describes the information output at each output level:
Output level |
Output information |
Task-related |
Debugger function |
Description |
|||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Error information |
Basic information |
Plug-in definitions (before plug-in execution) |
Properties (before plug-in execution) |
Plug-in definition (after plug-in execution) |
Properties (after plug-in execution) |
Standard output |
Debug information |
||||
0 |
Y |
N |
N |
N |
N |
N |
N |
N |
N |
N |
Only error information is output. |
10 |
Y |
Y |
N |
N |
Y/N |
Y/N |
Y/N |
N |
Y |
Y |
When the return value of the plug-in is 0, JP1/AO outputs error information and basic information. When the return value of the plug-in is other than 0, JP1/AO outputs error information, basic information, plug-in definitions (after plug-in execution), properties (after plug-in execution), and standard output. |
20 |
Y |
Y |
Y |
N |
N |
Y |
Y/N |
N |
Y |
Y |
When the return value of the plug-in is 0, JP1/AO outputs error information, basic information, plug-in definitions (before plug-in execution), and properties (after plug-in execution). When the return value of the plug-in is other than 0, JP1/AO outputs error information, basic information, plug-in definitions (before plug-in execution), properties (after plug-in execution), and standard output. |
30 |
Y |
Y |
Y |
Y# |
N |
Y# |
Y |
N |
Y |
Y |
JP1/AO outputs all information except plug-in definitions (after plug-in execution) and debug information. |
40 |
Y |
Y |
Y |
Y# |
N |
Y# |
Y |
Y |
Y |
Y |
JP1/AO outputs all information except plug-in definitions (after plug-in execution) for debugging purposes. |
- Legend:
Y: Output according to the log level of the message when an event occurs that generates message output.
N: Not output.
Y/N: Output when the return value of the plug-in is other than 0.
- #
When the data type of the property is password, ******** is output as the property value.
When the value of a property with the Composite data type is 4,097 characters or longer, an ellipsis (...) replaces the 4,097th and subsequent characters.