Introduction

JS7 - Reports offer aggregated information about past execution of workflows and jobs.

Reports are created from There are predefined Report Templates. The template determines templates individually implement which data will be analyzed for the processed when creating a report. All Report Templates can be parameterised parameterized with the number of hits and the sorting (highest/lowest). At this stage It is not possible for users to create their own implementations for reports.

Find below the list of Report Templates that ship with JS7.

Prerequisites

Reports are created from a Java class that can be configured to use Java options. It is recommended to use the -Xmx<number><unit> option to limit Java heap space consumption. The default value is -Xmx64M., see JS7 - Settings.

Memory consumption depends on

• the Report Template,
• the frequency:  short frequencies such as a weekly interval will consume less memory than long frequencies such as a yearly interval,
• the value for the number of "Hits",
• the value for "Step Overlap": small values will consume more memory. The Step Overlap is configured for the "Top n periods with highest/lowest number of workflow/job executions" Report Templates.
• the duration of job/workflow runs for the "Top n periods with highest/lowest number of workflow/job executions" Report Templates.
• the number of distinct workflows/jobs, that are considered for counting, for example for the number of failed workflows.
• the number of distinct Agents in reports based on the "Top n Agents with highest/lowest number of parallel job executions" Report Templates.

Example: A report based on the "Top n periods with highest/lowest number of workflow/job executions" Report Template will consume more memory when using the frequency "Yearly" instead of "Monthly" or with a Step Overlap of 1m instead of 60m.

Report Templates

Report Template: Top n workflows with highest/lowest number of failed executions

...

• A workflow execution is considered being failed if the order leaves the workflow with an unsuccessful outcome, for example if an order is cancelled or if a JS7 - Finish Instruction is used indicating unsuccessful outcome.
• A workflow execution is not considered being failed just because some jobs job failed, for example if a JS7 - Retry Instruction is used a later retry of a job can be successful. Instead, the resulting history status of an order is considered.

...

The Report Template counts parallel job executions with Agents. A Job A Job1 is considered in parallel to Job B Job2 if

• Job A Job1 starts after Job B Job2 has started and before Job B Job2 will end or
• Job A Job1 ends after Job B Job2 is started and before Job B Job2 will end.

Report Template: Top n high criticality jobs with highest/lowest number of failed executions

...

The Report Template considers the duration of successful workflow executionexecutions. Failed workflow executions will not be considered.

...

The Report Template considers the duration of successful job executionexecutions. Failed job execution executions will not be considered.

Report Template: Top n periods with highest/lowest number of

...

job executions

The Report Template divides the Reporting Period into steps. The duration of one a step is determined by the "Step Duration" setting in the JS7 - Reports - Configuration. The start of the next step is determined by the "Step Overlap" setting in the Report Configuration.

...

• Step Duration: 5m
• Step Overlap: 2m
  • 00:00:00-00:05:00
  • 00:02:00-00:07:00
  • 00:04:00-00:09:00 

The number of jobs started in execution is counted per periodstep.

Report Template: Top n periods with highest/lowest number of workflows executions

The Report Template divides the Report Reporting Period into sub-periodssteps. The length of sub-periods duration of a step is determined by the "Period LengthStep Duration" setting in the Report JS7 - Reports - Configuration. The start of the next period step is determined by the "Period Step Overlap" setting in the Report Configuration.

The number of orders being processed by a workflow in execution is counted per periodstep.

Report Template: Top n jobs with highest/lowest number of successful executions

The Report Template counts jobs that completed successfully. Failed jobs are not considered.

For possible reasons of job failure see Report Template: Top n jobs with highest/lowest number of failed executions.

...

The Report Template counts workflows that completed successfully. Failed workflow executions are not considered.

For reasons of workflow failure see Report Template: Top n workflows with highest/lowest number of failed executions.

...