Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TORRUS_SCHEDULERINFO(1) 	     torrus		 TORRUS_SCHEDULERINFO(1)

NAME
     schedulerinfo - Displays extended scheduler tasks information.

SYNOPSIS
     torrus schedulerinfo --tree=TREENAME [options...]

DESCRIPTION
     This utility displays the extended scheduler tasks information for tree
     TREENAME on standard output. This might be useful for scheduler planning
     and analysis.

OPTIONS
     --config
	 Reports scheduler's configuration. The values are explained below.

	 Total collector/monitor leaves: N
		 Total number of datasources being processed by collector or
		 monitor daemon.

	 Scheduled leaves by type
		 Torrus supports arbitrary number of collector types, and this
		 report shows how many datasources belong to every type. Cur-
		 rently the monitor leaves are not divided into types.

	 Least common period: N seconds
		 The report below shows how the tasks are distributed across the
		 time line, and the least common period shows the period of this
		 time line.

	 Tasks execution timeline
		 This report tells which task and how many datasources are in-
		 volved in each task startup event, and how these events are
		 dispersed across the time.  The column Interval shows the time
		 interval from each task execution event to the next event on
		 the timeline.

     --runtime
	 Reports scheduler's runtime statistics, such as running cycle times,
	 late starts etc. The meaning of the output values is as follows. Values
	 that have zero values are usually not printed.

	 Task: Name, Period: N seconds, Offset: M seconds
		 Each scheduler task is characterized by its name (usually Col-
		 lector or Monitor), period, and timeoffset. Fore example, if
		 period is set to 300 seconds, and offset is 14 seconds, then
		 the task would be executed at 00:00:14, 00:05:14, 00:10:14, and
		 so on for every hour in a day.

	 N running cycles passed
		 How many times the task was executed since last reset. The
		 counter is normally reset after torrus_compilexml(1) success-
		 fully compiles the configuration.

	 N late starts
		 How many times the task has started with a delay from its nor-
		 mal schedule.

	 N too long runs
		 How many times the task execution time was longer than its pe-
		 riod.

	 N overrun periods
		 How many periods have been missed because of too long execu-
		 tions.

	 N missed periods
		 How many periods were missed because of any reason (such as
		 other tasks delaying).

	 Min, Max, Average, Exp Average
		 The time values are displayed in four columns: Mimimum, Maximum
		 and Average values since last reset, and Exponential decay
		 value, which may be interpreted as the average for last several
		 values. With defaults defined in torrus-config.pl, 95% of the
		 average is calculated from last 3 values.

	 Running Time
		 How long the task executes each period.

	 Late Start
		 How long the task start was delayed.

	 Too LongHow much time the too long run took.

	 RRD Queue
		 In a multithreaded environment, the RRD files are writen in a
		 background thread. This value shows the length of the RRD up-
		 date queue at the beginning of each update cycle.

     --help
	 Displays a help message.

SEE ALSO
     torrus(1), torrus_compilexml(1)

NOTES
     See more documentation at Torrus home page: http://torrus.org

AUTHOR
     Stanislav Sinyagin <ssinyagin@k-open.com>

torrus 2.09			   2026-08-30		 TORRUS_SCHEDULERINFO(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=torrus_schedulerinfo&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help