Logging

Logging

• Logging
• Configuration Files
• Log Examples
  • .log
  • .meta
  • .pid

Each PEST run results in a run ID and logs for the harness process and each process launched by the harness. A run directory is created to contain the logs, named after the run ID. Each process results in three logs: 'processid'.log, 'processid'.meta, 'processid'.pid.

• 'runid'/harness.log - Generated by the harness process, this shows the log location and individual process results.
• 'runid'/'000003.235'.log - Generated by streaming a process's standard out and standard error. This is thread 3, testid 235.
• 'runid'/'000003.235'.meta - Generated by the harness to capture a process's metadata, including its exit code, and start/stop times.
• 'runid'/'000003.235'.pid - Generated by the harness to capture a process's process ID.

Configuration Files

PEST requires four configuration files. Each of them is copied to the run directory under the cfg directory to allow reproduction.

• 'runid'/cfg/pest.yaml - This is a harness configuration file of no interest to the user.
• 'runid'/cfg/'run'.yaml - This is the Test Run configuration file provided by the '-c' argument to pest.pl.
• 'runid'/cfg/'testbed'.yaml - This is the Testbed configuration file provided by the '-t' argument to pest.pl.
• 'runid'/cfg/'batch'.yaml - This is the Test Batch configuration file provided by the '-s' argument to pest.pl.

Log Examples

[root@todd1 1383818052.todd1]# pwd
/home/tshoenfelt/perl/scripts/perlsystemtest0/logs/1383818052.todd1
[root@todd1 1383818052.todd1]# tree
.
|-- 000000001.543.log
|-- 000000001.543.meta
|-- 000000001.543.pid
|-- 000000002.234.log
|-- 000000002.234.meta
|-- 000000002.234.pid
|-- 000000003.234.log
|-- 000000003.234.meta
|-- 000000003.234.pid
|-- cfg
|   |-- EXAMPLE_RUN.yaml
|   |-- EXAMPLE_TESTBED.yaml
|   |-- EXAMPLE_TEST_BATCH.yaml
|   |-- env.yaml
|   `-- pest.yaml
`-- harness.log

.log

[root@todd1 1383818052.todd1]# cat 000000001.543.log
user.domain.com

.meta

[root@todd1 1383818052.todd1]# cat 000000001.543.meta
---
testid: 543
execid: 000000001.543
hostname: 127.0.0.1
command: echo 2607 > /home/tshoenfelt/perl/scripts/perlsystemtest0/logs/1383818052.todd1/000000001.543.pid; /home/tshoenfelt/svn/pest1/bin/sshcmd.pl -s 127.0.0.1 -u username -p password -c 'hostname' > /home/tshoenfelt/perl/scripts/perlsystemtest0/logs/1383818052.todd1/000000001.543.log 2>&1
harness_pid: 2604
log: /home/tshoenfelt/perl/scripts/perlsystemtest0/logs/1383818052.todd1/000000001.543.log
metalogfile: /home/tshoenfelt/perl/scripts/perlsystemtest0/logs/1383818052.todd1/000000001.543.meta
bg: 1
presleep: 0
postsleep: 0
ignore: 1
haltfail: 0
wait: []
starttime: 2014-08-26 10:31:08.360182
endtime: 2014-08-26 10:31:13.559556
rc: 0
result: PASS

.pid

2607