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.  Currently  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
		   involved  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
		   Collector   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)
		   successfully	compiles the configuration.

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

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

	   N overrun periods
		   How many periods have  been	missed	because	 of  too  long
		   executions.

	   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 Long
		   How 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
		   update 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			  2025-04-18	       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+14.3.quarterly>

home | help