Skip to main content

CaptureJobStatistics

Theme: Configure
Who Is It For? System Administrator

What is it?​

CaptureJobStatistics is a Windows Agent setting that enables collection of performance metrics for each job the agent runs. When active, the agent records CPU, memory, and I/O counters for each job and makes them available in the OpCon Daily Job Operations view under the LSAM Feedback category.

  • Enable or disable job performance capture with a single MSLSAM.ini setting
  • View CPU, memory, and I/O metrics per job in the LSAM Feedback category in Daily Job Operations

When to use​

  • When you need to identify which scheduled jobs are consuming the most CPU or memory on the agent machine.
  • When troubleshooting performance degradation in a production environment and need to correlate resource usage with specific job executions.

Benefits​

  • Provides performance visibility without requiring custom monitoring scripts or third-party tools on the agent machine.
  • Makes resource consumption data available in OpCon's standard job views alongside other job details, keeping operational information in one place.

If CaptureJobStatistics is set to TRUE, the agent captures the performance details for the following performance counters:

  • Total Processor Time
  • User Processor Time
  • Virtual Memory Size
  • Physical Memory Size
  • Job End Time
  • % Process Usage
  • I/O Data Bytes/Sec
  • I/O Data Operations/Sec
  • I/O Other Bytes/Sec
  • I/O Other Operations/Sec
  • I/O Read Bytes/Sec
  • I/O Read Operations/Sec
  • I/O Write Bytes/Sec
  • I/O Write Operations/Sec

The captured information is available in Daily Job Operations and History under the LSAM Feedback category.

Configuration options​

The following MSLSAM.ini setting enables job statistics capture. For the complete setting description, refer to MSLSAM.ini configuration file.

SettingWhat It DoesDefaultNotes
CaptureJobStatisticsEnables or disables collection of CPU, memory, and I/O performance counters for each job. When TRUE, data is available in the LSAM Feedback category in Daily Job Operations and History.FALSEDynamic — no service restart needed.

FAQs​

Does enabling CaptureJobStatistics affect job performance?
The agent uses Windows performance counter APIs to collect statistics while a job runs. For most workloads the overhead is negligible, but on machines running a very high number of concurrent short-duration jobs, you may observe increased CPU usage on the agent process. Disable CaptureJobStatistics if performance impact is observed.

How long is statistics data retained?
Statistics are stored in the OpCon database as part of job history. Retention follows the job history purge settings configured in OpCon.

Can I view statistics for jobs that failed?
Yes. Statistics are captured and stored for each job that the agent starts regardless of the job's exit status.

Glossary​

CaptureJobStatistics — The MSLSAM.ini setting that enables or disables collection of performance counters for each job run by the agent. Default is FALSE.

LSAM Feedback — The category in OpCon's Daily Job Operations and History views where agent-generated data such as job statistics and exit codes are displayed.