Monitoring SAP BTP Jobs

When you execute an object in Automic Automation, the corresponding task is visible in the list of Tasks in the Process Monitoring perspective. Process Monitoring gives you the full range of possibilities to monitor, analyze, identify, and remediate problems. It displays comprehensive data on active and inactive tasks, it provides tools to filter and group tasks. In this perspective, you can modify active tasks, open their reports, and execution lists and troubleshoot.

If you want to learn more about how to monitor your jobs, please refer to the Automic Automation product documentation at Monitoring Tasks.

For more information on how to work with tasks on the Process Monitoring perspective, refer to the Automic Automation documentation at Working with Tasks.

This page includes the following:

Monitoring SAP BTP Job Details

  1. Go to the list of tasks in the Process Monitoring perspective.

  2. Find the SAP BTP task.

  3. Select the task and select the Details button.

    The Details pane opens on the right hand side and shows a summary of the execution of the selected task. The General and Job sections of the Details pane display information about the object configuration and its execution in Automic Automation.

    The Object Variables section displays the Schedule ID from the SAP BTP system and the Run ID for the respective job execution:

    • &RUN_ID#
    • &SCHEDULE_ID#

Canceling and Restarting SAP BTP Jobs

Scheduler jobs cannot be canceled nor restarted.

Canceling means that means that the Automic Automation task is canceled, but not the Scheduler in SAP BTP. The job report displays the status as per the job status on SAP BTP and the Job report maintains the proper logs.

Clicking the Restart button for a job in Automic Automation starts a new Scheduler instance in SAP BTP.

If a job is inactive on SAP BTP side, the Automic Automation Scheduler job waits until it becomes active again in the SAP BTP system.

For more information on how to work with tasks on the Process Monitoring perspective, refer to the Automic Automation documentation at Working with Tasks.

SAP BTP Agent Connection

If the Agent stops working or loses connection, the Job execution stops but resumes as soon as the Agent is connected again.

Reports

When jobs are executed, Automic Automation generates output files and reports that you can open from the user interface. Combined with the Execution Data, these reports provide comprehensive information about the status and the history of your executions. This information tracks all processes and allows you to control and monitor tasks, ensuring full auditing capability.

Reports are kept in the system until they are explicitly removed by a reorganization run. During a reorganization run, the Execution Data can be kept. Keeping the execution data is an advantage, because reports can consume a large amount of hard drive space. Removing the reports from your database does not mean loss of important historical data.

The following reports, combined with execution data, offer comprehensive information about the status and history of executions, ensuring full auditing capability:

  • Agent log (PLOG)

    This report captures everything that has to do with the Job execution from the Automic Automation perspective:

    It provides a comprehensive log of a Job’s execution, detailing its start time, configuration parameters, validation results, and the response from the target system, though the response is in an unprocessable format.

    It serves as the primary resource for troubleshooting issues, including those related to Job configuration. For example, it shows the actual values of variables used in configuration, rather than their names, as these are resolved during runtime. Additionally, the agent log includes all parameters used during execution, execution results, the final integration URL, and the various job states throughout the process, which aids in identifying and addressing potential problems.

  • Report (REP)

    This report captures information that the target system sends to Automic Automation during and after Job execution. It provides relevant information about the Job execution and its results in a format that can be easily parsed for further processing, such as JSON or XML. This report's content can be used to trigger further actions based on that content.

    Note:

    The Report (REP) cannot be parsed if the job throws an exception. In this case, only the exception message is written into both the Report (REP) and Agent (PLOG) logs.

    You will most probably include the Jobs in other Automic Automation objects such as Workflows or Schedules to orchestrate operations. When you do so, you can use the content of this report on the Post Process pages of the Job definition to trigger further actions based on that content. For more information see, Process Pages in the Automic Automation product documentation.

  • Directory

    This report provides a list of job output files created during a particular execution and available for downloading. It may also contain files downloaded from the target system.

To Access the Reports

Do one of the following:

  • From the Process Assembly perspective

    • After executing a Job, a notification with a link to the report is displayed. Click it to open the Last Report page.

    • Right-click a job and select Monitoring > Last Report.

    In either case, the most recent report that is created for the object opens up.

  • From the Process Monitoring perspective

    • Right-click a task and select Open Report.

      The report for that particular execution opens. Its runID is displayed in the title bar to help you identify it.

    • In the list of Executions for a particular task, right-click and select Open Report.

See also: